Aplikace jsou aktuálně v alfa fázi. Funkce funguje, ale stále se vyvíjí.
Co jsou aplikace?
Aplikace vám umožňují rozšířit Twenty o vlastní objekty, pole, logické funkce, front-endové komponenty, AI schopnosti a další — vše je spravováno jako kód. Místo konfigurace všeho přes uživatelské rozhraní definujete v TypeScriptu svůj datový model a logiku a nasadíte je do jednoho nebo více pracovních prostorů.
Co můžete vytvořit:
- Vlastní objekty a pole — rozšiřte svůj datový model o nové entity nebo přidejte pole k existujícím objektům, jako jsou Společnost nebo Osoba
- Logické funkce — serverové funkce spouštěné událostmi v databázi, plány cronu nebo HTTP routami
- Front-endové komponenty — komponenty Reactu, které se vykreslují v uživatelském rozhraní Twenty (stránky záznamů, příkazová nabídka, postranní panely)
- Dovednosti AI a agenti — rozšiřte AI v Twenty o vlastní možnosti
- Zobrazení a navigace — předkonfigurovaná uložená zobrazení a odkazy v postranním panelu
Rychlý start
npx create-twenty-app@latest my-twenty-app
cd my-twenty-app
yarn twenty dev
Podrobné návody
| Průvodce | Popis |
|---|
| Začínáme | Vytvoření kostry aplikace, nastavení lokálního serveru, struktura projektu, CI |
| Tvorba aplikací | Definice entit (defineObject, defineLogicFunction, defineFrontComponent atd.), klienti API, balíčky npm, veřejná aktiva, testování |
| Publikování | Nasazení na server, publikování na npm, tržiště |
Klíčové pojmy
Detekce entit
SDK detekuje entity prohledáváním vašich souborů TypeScript a hledá volání export default define<Entity>({...}). Pojmenování souborů a struktura složek jsou flexibilní — detekce je založená na AST, nikoli na cestách.
Dostupné typy entit
| Funkce | Účel |
|---|
defineApplication() | Metadata aplikace (povinné, jedno na aplikaci) |
defineObject() | Vlastní objekty s poli |
defineField() | Pole u existujících objektů |
defineLogicFunction() | Serverová logika se spouštěči |
defineFrontComponent() | Komponenty Reactu v uživatelském rozhraní Twenty |
defineRole() | Role oprávnění |
defineView() | Konfigurace uložených zobrazení |
defineNavigationMenuItem() | Odkazy postranní navigace |
defineSkill() | Dovednosti agenta AI |
defineAgent() | AI agenti s prompty |
definePageLayout() | Vlastní rozvržení stránek záznamu |
definePreInstallLogicFunction() | Spouští se před instalací aplikace |
definePostInstallLogicFunction() | Spouští se po instalaci aplikace |
Vývojový postup
yarn twenty dev — sleduje zdrojové soubory, při změně znovu sestaví, synchronizuje se serverem a generuje typované klienty APIyarn twenty build — vytvoří distribuovatelný buildyarn twenty deploy — nasadí na vzdálený server Twentyyarn twenty add — interaktivně vytvoří kostru nové entity
Referenční dokumentace CLI
yarn twenty help # List all commands
yarn twenty server start # Start local dev server
yarn twenty remote add # Connect to a Twenty server
yarn twenty exec -n fn # Execute a logic function
yarn twenty logs -n fn # Stream function logs
