Înainte de a începe
Folosește Node.js 24 (24.5+) sau 26 (26.5.1+) și Yarn 4 (prin Corepack:corepack enable; pe Node 26, instalează-l mai întâi cu npm install -g corepack). Instalați CLI-ul la nivel global; aplicația dvs. își păstrează propriile dependențe SDK.
Construirea aplicațiilor Twenty este acceptată oficial numai pe sistemele Unix (macOS și Linux). Pe Windows, lucrați în WSL 2.
Creați proiectul
app init scrie doar șablonul. Nu instalează dependențe, nu inițializează Git, nu pornește Docker, nu autentifică și nu sincronizează. Personalizați numele afișat și descrierea cu --display-name și --description; utilizați --path pentru o destinație diferită.
Conectați-vă la Twenty
Folosiți un spațiu de lucru existent sau porniți un server local, apoi autentificați-vă:--name dev salvează conexiunea ca dev; --use o setează ca implicită pentru comenzile de mai jos. Pentru a o viza în mod explicit, adaugă --remote dev. Variabilele de mediu pot suprascrie opțiunea implicită; consultă selectarea spațiului de lucru.
Sincronizați modificările
Pentru prima sincronizare, permiteți explicit înregistrarea și instalarea:plan previzualizează modificările. apply încarcă și sincronizează o singură dată. Folosește --no-prune pentru a păstra entitățile la distanță care lipsesc din sursă sau --yes pentru a permite ștergerea obiectelor și a câmpurilor fără o solicitare de confirmare. Toate cele trei comenzi necesită o conexiune la distanță autentificată și drepturi de proprietate asupra înregistrării.
Ce puteți construi
Aplicațiile sunt compuse din entități — fiecare definită într-un fișier TypeScript cu un singurexport default:
Referință completă: Concepte.
Construiți cu abilități pentru agenți AI
Abilitățile pentru agenți oficiale Twenty îi învață pe agenții de programare întregul flux de lucru al aplicației: generarea structurii inițiale, dezvoltarea entităților, operațiuni de sincronizare și implementare, precum și publicarea pe marketplace. Acestea se instalează în Claude Code, Codex, Cursor, Pi și orice alt mediu de execuție acceptat de CLI-ulskills și funcționează cu orice instanță Twenty, inclusiv cu domenii personalizate auto-găzduite și localhost.
agent-skills devine disponibilă după prima publicare reușită din main; înainte de aceasta, urmați instrucțiunile pentru compilarea locală.
Pașii următori
Configurați
Identitatea aplicației, rolul implicit, instalați și dezinstalați hook-uri, active publice.
Date
Obiecte, domenii și relații bidirecționale.
Logică
Funcții logice, competențe, agenți, conexiuni și canale de mesagerie.
Layout
vizualizări, navigare, layout-uri de pagini, componente din față.
Operații
CLI, testare, telecomenzi, CI și publicarea aplicației tale.