---
title: Twenty Uygulamaları
description: Twenty özelleştirmelerini kod olarak oluşturun ve yönetin.
---

<Warning>
Uygulamalar şu anda alfa aşamasında. Özellik işlevsel ancak hâlâ gelişmekte.
</Warning>

## Uygulamalar Nedir?

Uygulamalar, Twenty'yi özel nesneler, alanlar, mantık işlevleri, ön yüz bileşenleri, yapay zekâ yetenekleri ve daha fazlasıyla genişletmenizi sağlar — tümü kod olarak yönetilir. Her şeyi UI üzerinden yapılandırmak yerine, veri modelinizi ve mantığınızı TypeScript'te tanımlar ve bunu bir veya daha fazla çalışma alanına dağıtırsınız.

**Oluşturabilecekleriniz:**

* **Özel nesneler ve alanlar** — veri modelinizi yeni varlıklarla genişletin veya Şirket ya da Kişi gibi mevcut nesnelere alanlar ekleyin
* **Mantık işlevleri** — veritabanı olayları, cron zamanlamaları veya HTTP rotaları tarafından tetiklenen sunucu tarafı işlevler
* **Ön yüz bileşenleri** — Twenty'nin kullanıcı arayüzünde (kayıt sayfaları, komut menüsü, yan paneller) görüntülenen React bileşenleri
* **Yapay zekâ yetenekleri ve ajanları** — Twenty'nin yapay zekâsını özel yeteneklerle genişletin
* **Görünümler ve gezinme** — önceden yapılandırılmış kaydedilmiş görünümler ve kenar çubuğu bağlantıları

## Hızlı Başlangıç

```bash filename="Terminal"
npx create-twenty-app@latest my-twenty-app
cd my-twenty-app
yarn twenty dev
```

Bu, yeni bir uygulamanın iskeletini oluşturur, isteğe bağlı olarak yerel bir Twenty sunucusunu başlatır ve dosyalarınızdaki değişiklikleri izlemeye başlar. Tam adım adım anlatım için [Başlarken](/l/tr/developers/extend/apps/getting-started) kılavuzuna bakın.

## Ayrıntılı kılavuzlar

| Kılavuz                                                | Açıklama                                                                                                                                    |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| [Başlarken](/l/tr/developers/extend/apps/getting-started)   | Bir uygulamanın iskeletini oluşturun, yerel bir sunucu kurun, proje yapısı, CI                                                              |
| [Uygulama Oluşturma](/l/tr/developers/extend/apps/building) | Varlık tanımları (`defineObject`, `defineLogicFunction`, `defineFrontComponent` vb.), API istemcileri, npm paketleri, genel varlıklar, test |
| [Yayınlama](/l/tr/developers/extend/apps/publishing)        | Bir sunucuya dağıtın, npm'e ve pazaryerine yayınlayın                                                                                       |

## Temel Kavramlar

### Varlık algılama

SDK, TypeScript dosyalarınızı `export default define<Entity>({...})` çağrılarını tarayarak varlıkları algılar. Dosya adlandırması ve klasör yapısı esnektir — algılama AST tabanlıdır, yol tabanlı değildir.

### Kullanılabilir varlık türleri

| Fonksiyon                          | Amaç                                                       |
| ---------------------------------- | ---------------------------------------------------------- |
| `defineApplication()`              | Uygulama meta verileri (zorunlu, uygulama başına bir adet) |
| `defineObject()`                   | Alanlara sahip özel nesneler                               |
| `defineField()`                    | Mevcut nesnelerde alanlar                                  |
| `defineLogicFunction()`            | Tetikleyicilerle sunucu tarafı mantık                      |
| `defineFrontComponent()`           | Twenty'nin kullanıcı arayüzündeki React bileşenleri        |
| `defineRole()`                     | İzin rolleri                                               |
| `defineView()`                     | Kaydedilmiş görünüm yapılandırmaları                       |
| `defineNavigationMenuItem()`       | Kenar çubuğu gezinme bağlantıları                          |
| `defineSkill()`                    | Yapay zekâ ajanı yetenekleri                               |
| `defineAgent()`                    | İstemlerle yapay zekâ ajanları                             |
| `definePageLayout()`               | Özel kayıt sayfası düzenleri                               |
| `definePreInstallLogicFunction()`  | Uygulama kurulmadan önce çalışır                           |
| `definePostInstallLogicFunction()` | Uygulama kurulduktan sonra çalışır                         |

### Geliştirme iş akışı

1. **`yarn twenty dev`** — kaynak dosyaları izler, değişiklikte yeniden derler, sunucuyla senkronize eder, tipli API istemcileri üretir
2. **`yarn twenty build`** — dağıtılabilir bir derleme üretir
3. **`yarn twenty deploy`** — uzak bir Twenty sunucusuna dağıtır
4. **`yarn twenty add`** — etkileşimli olarak yeni bir varlık iskeleti oluşturur

### CLI başvurusu

```bash filename="Terminal"
yarn twenty help          # Tüm komutları listele
yarn twenty server start  # Yerel geliştirme sunucusunu başlat
yarn twenty remote add    # Bir Twenty sunucusuna bağlan
yarn twenty exec -n fn    # Bir mantık fonksiyonunu çalıştır
yarn twenty logs -n fn    # Fonksiyon günlüklerini izle
```

Tam CLI başvuru rehberi için [Başlarken](/l/tr/developers/extend/apps/getting-started) kılavuzuna bakın.
