Uygulamalar şu anda alfa aşamasında. Özellik işlevsel ancak hâlâ gelişmekte.
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ıç
npx create-twenty-app@latest my-twenty-app
cd my-twenty-app
yarn twenty dev
Ayrıntılı kılavuzlar
| Kılavuz | Açıklama |
|---|
| Başlarken | Bir uygulamanın iskeletini oluşturun, yerel bir sunucu kurun, proje yapısı, CI |
| Uygulama Oluşturma | Varlık tanımları (defineObject, defineLogicFunction, defineFrontComponent vb.), API istemcileri, npm paketleri, genel varlıklar, test |
| Yayınlama | 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ışı
yarn twenty dev — kaynak dosyaları izler, değişiklikte yeniden derler, sunucuyla senkronize eder, tipli API istemcileri üretiryarn twenty build — dağıtılabilir bir derleme üretiryarn twenty deploy — uzak bir Twenty sunucusuna dağıtıryarn twenty add — etkileşimli olarak yeni bir varlık iskeleti oluşturur
CLI başvurusu
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
