Desenvolvimento

​

Padrões do repositório

• manter o código totalmente tipado
• adicionar stories do Storybook para qualquer superfície de UI personalizada
• documentar mudanças de runtime na documentação
• manter feature flags aditivas
• preferir comportamento operacional direto em vez de teatro de abstração

​

Padrão de pull request

• mudanças tipadas em aplicações e packages
• testes para o comportamento alterado
• documentação atualizada em apps/docs e docs/*.md quando relevante
• notas explícitas de rollout, replay ou rollback para mudanças operacionais
• notas de review adversarial quando a funcionalidade toca correção ou limites de segurança

​

Adequação ao repositório

• propósito do repositório direto e explícito
• CI e processo de release legíveis
• comportamento de runtime com pouca “mágica”
• contratos internos documentados
• runbooks e notas de review armazenados no próprio repositório

​

Observação sobre a implementação atual

• a maior parte da iteração de UI e API ainda acontece contra o caminho com mock
• o comportamento suportado pelo Supabase deve ser documentado explicitamente quando uma superfície estiver de fato conectada
• os contratos de app e API devem permanecer estáveis conforme a implementação de armazenamento muda por trás deles

​

Comandos de alto valor

pnpm lint
pnpm typecheck
pnpm test
pnpm build

pnpm --filter api test
pnpm --filter worker test
pnpm --filter control-plane test
pnpm --filter @repo/database typecheck

​

Leia a seguir

• Fluxo de contribuição
• Etiqueta de Issues e PRs
• Processo de release