npx create-twenty-app se parece com isto:
Arquivos principais
A organização de arquivos fica a seu critério. As pastas acima são convenções — o SDK detecta entidades por meio de análise de AST em chamadas a
export default defineEntity(...), independentemente de onde o arquivo esteja.Dependências
Ambos os pacotes Twenty SDK pertencem adevDependencies, não a dependencies:
twenty-sdk e twenty-client-sdk para a sua própria versão — mantenha os dois sincronizados ao atualizar.
twenty-sdkinclui a CLItwentye as ferramentas de build/scaffolding. Ele é executado apenas durante o desenvolvimento e o build e nunca é importado pelo runtime do aplicativo publicado.twenty-client-sdké importado pelo código do seu aplicativo (CoreApiClient,MetadataApiClient,RestApiClient), mas a Twenty o fornece em tempo de execução — as funções de lógica o obtêm de uma camada SDK gerada, e os componentes de front o resolvem a partir de módulos servidos pelo servidor. A cópia instalada é usada apenas para verificação de tipos e para o build no momento do deploy, então ela nunca precisa ser incluída no bundle implantado.
dependencies o inclui no bundle de runtime do aplicativo instalado, onde ele é peso morto. twenty dev:build emite um aviso quando qualquer um deles ainda está listado em dependencies.
Adicione as dependências de runtime do próprio aplicativo (bibliotecas que as suas funções de lógica realmente importam em tempo de execução) em dependencies, como de costume. Mantenha a árvore enxuta: dependencies são instaladas em uma camada de runtime limitada a 250MB descompactados, e um comando de sync ou install falha com um erro de tamanho de dependencies acima desse valor — bibliotecas de UI e ferramentas de desenvolvimento pertencem a devDependencies.