Guia do MapaSafra

O MapaSafra oferece uma base neutra full-stack com autenticação, rotas protegidas, ferramentas admin, gerenciamento de perfil, formulários de suporte, suporte a temas e configuração de deploy no Cloudflare Worker.

• React 19, TanStack Start, TanStack Router e TanStack Query
• Better Auth com e-mail/senha e provedores OAuth opcionais
• Configuração do Drizzle e Neon PostgreSQL no pacote de dados compartilhado
• Shell de app reutilizável, sidebar, landing page pública e rotas de exemplo

1. 1Instale as dependências com pnpm install.
2. 2Copie apps/user-application/.dev.vars.example para apps/user-application/.dev.vars.
3. 3Preencha os valores de banco de dados, Better Auth e OAuth. Adicione o Resend depois de verificar um domínio de remetente.
4. 4Execute pnpm dev e abra http://localhost:3000.

Substitua MapaSafra, example.com, [EMAIL], nomes de pacote e identificadores do Cloudflare Worker pelos valores do seu projeto.

• Use /app/records e /app/reports como exemplos de empty states protegidos.
• Mantenha os módulos de auth, perfil, suporte, admin, tema e layout, a menos que seu app não precise deles.

1. 1Atualize apps/user-application/wrangler.jsonc com o nome do seu Worker e APP_URL.
2. 2Crie o namespace KV TEMPLATE_APP_RATE_LIMIT e substitua os IDs de exemplo.
3. 3Defina secrets com wrangler secret put para valores de banco, auth, OAuth e e-mail.
4. 4Execute pnpm --filter user-application deploy quando os checks passarem.