Přejít na hlavní obsah
Nová aplikace vygenerovaná pomocí npx create-twenty-app vypadá takto: 
my-twenty-app/
  package.json
  src/
    application-config.ts                   # Required — your app's entry point
    default-role.ts                         # Permissions for logic functions
    constants/
      universal-identifiers.ts              # Auto-generated UUIDs and metadata
    __tests__/
      setup-test.ts
      app-install.integration-test.ts
  .github/workflows/ci.yml                  # GitHub Actions
  public/                                   # Static assets
  vitest.config.ts                          # Test runner config
  tsconfig.json, tsconfig.spec.json
  .nvmrc, .yarnrc.yml, .oxlintrc.json
  README.md, LLMS.md

​
Klíčové soubory

Soubor / SložkaÚčel
src/application-config.tsPovinné. Hlavní konfigurační soubor vaší aplikace.
src/default-role.tsVýchozí role, která řídí, k čemu mohou vaše logické funkce přistupovat.
src/constants/universal-identifiers.tsAutomaticky generovaná UUID a metadata (zobrazovaný název, popis).
src/__tests__/Integrační testy (nastavení + ukázkový test).
public/Statické soubory (obrázky, písma) doručované vaší aplikací.
Uspořádání souborů je na vás. Výše uvedené složky jsou konvence — SDK detekuje entity pomocí analýzy AST u volání export default defineEntity(...) bez ohledu na to, kde se soubor nachází.

​
Závislosti

Oba balíčky Twenty SDK patří pod devDependencies, ne pod dependencies: 
{
  "dependencies": {},
  "devDependencies": {
    "twenty-client-sdk": "^2.13.0",
    "twenty-sdk": "^2.13.0"
  }
}
  • twenty-sdk dodává twenty CLI a nástroje pro sestavení/scaffolding. Běží pouze při vývoji a sestavování a nikdy není importován za běhu zveřejněné aplikace.
  • twenty-client-sdk je importován kódem vaší aplikace (CoreApiClient, MetadataApiClient, RestApiClient), ale Twenty ho poskytuje za běhu — logické funkce ho získávají z vygenerované SDK vrstvy a front-endové komponenty ho načítají z modulů poskytovaných serverem. Vaše nainstalovaná kopie se používá pouze pro kontrolu typů a build v době nasazení, takže ji nikdy není potřeba přibalit do nasazeného balíčku.
Ponechání kteréhokoli balíčku pod dependencies ho vtáhne do runtime balíčku nainstalované aplikace, kde je jen mrtvou vahou. twenty build vypíše varování, pokud je kterýkoli z nich stále uveden pod dependencies. Vlastní runtime závislosti vaší aplikace (knihovny, které vaše logické funkce skutečně importují za běhu) přidejte jako obvykle pod dependencies.