Trilho
Plataforma de desenvolvimento pessoal (PWA) que mede, mostra padrões e lembra. O módulo 1, Hábitos, transforma métodos de mudança de hábito em exercícios na tela e indicadores de adesão, com check-in diário.
A especificação do MVP está em docs/HANDOFF-sistema-habitos.md; nome, cores e ícones em docs/HANDOFF-marca-trilho.md (vale este onde houver conflito); a direção da plataforma em docs/ROADMAP-trilho.md. O conteúdo das lições está em docs/conteudo-modulo1-habitos.md e os arquivos de marca em brand-kit/ (os do app ficam copiados em public/brand/).
Stack: Next.js (App Router) + TypeScript + Tailwind CSS + Supabase, deploy na Vercel.
Rodar localmente
cp .env.example .env.local # preencha as chaves do Supabase
npm install
npm run dev
Abra http://localhost:3000.
Banco de dados
As migrações ficam em supabase/migrations/, em ordem. Para aplicar no projeto da nuvem, abra o SQL Editor do Supabase e rode cada arquivo novo, na ordem do nome.
Configuração de Auth no painel (Authentication):
- Sign In / Providers: Email ligado e cadastro de novos usuários permitido.
- URL Configuration: Site URL = endereço do app; em Redirect URLs,
http://localhost:3000/** e o domínio de produção.
Carregar as lições
Depois de aplicar as migrações (e sempre que docs/conteudo-modulo1-habitos.md mudar):
npm run seed-licoes
Lê o arquivo de conteúdo e grava as 8 lições na tabela licoes. Pode rodar de novo sem duplicar.
Liberar acesso manualmente (testadores)
Precisa de SUPABASE_SERVICE_ROLE_KEY no .env.local.
npm run liberar-acesso -- [email protected]
Vale na hora, mesmo para quem já está logado. Para revogar, no SQL Editor:
update acessos set status = 'revogado' where email = '[email protected]';
Lembrete diário (Web Push)
- Gere as chaves uma vez:
npx web-push generate-vapid-keys e coloque VAPID_PUBLIC_KEY, VAPID_PRIVATE_KEY e VAPID_SUBJECT (mailto:seu-email) no .env.local e na Vercel. Não troque as chaves depois: as inscrições existentes param de funcionar.
- Defina
CRON_SECRET (qualquer texto longo e aleatório).
- Algo precisa chamar
GET /api/cron/lembretes a cada 15 minutos com o cabeçalho Authorization: Bearer <CRON_SECRET>. A rota decide quem recebe (janela de 15 min do horário do usuário, no máximo 1 por dia, só se houver hábito pendente).
O service worker (public/sw.js) só é registrado no build de produção (npm run build && npm start); em npm run dev ele fica desligado para não servir páginas antigas do cache.
Supabase local (opcional, precisa de Docker)
npx supabase start # sobe o banco e aplica as migrações
Os e-mails de link mágico chegam no Mailpit (http://127.0.0.1:54324). Para usar o local, troque URL e chave no .env.local pelos valores que o comando mostra.
Scripts
npm run dev: servidor de desenvolvimentonpm run build: build de produçãonpm run lint: ESLintnpm run typecheck: TypeScript sem emitir arquivosnpm test: testes unitários (Vitest)
