Scriba
Transcrição e resumo de sermões e aulas bíblicas. O celular grava a pregação
inteira num arquivo só e a tela fica quieta; no stop, o áudio sobe, é transcrito
de uma vez e vira um resumo estruturado. A partir dele sai um estudo teológico,
se a pessoa pedir. Também dá para importar um vídeo do YouTube e receber o mesmo
resumo a partir da legenda.
Next.js 16 (App Router) · React 19 · Supabase · Tailwind v4 · Stripe.
Rodar localmente
Requer Node 20+ e um .env.dev (o modelo é .env.example, peça os valores a
quem já tem o ambiente).
npm install
npm run dev # http://localhost:3000, contra o Supabase e o Stripe de DEV
Não crie .env.local. O Next o carregaria sozinho, e um next dev
distraído passaria a falar com produção sem avisar. O src/scripts/with-env.mjs
aborta se encontrar qualquer arquivo dessa família. Detalhes em
docs/ambientes.md.
Onde fica o quê
src/app/ as rotas, agrupadas por área: (site) (entrar) (app) (painel)
src/lib/ a camada de servidor: LLM, banco, env, auth, cobrança
src/features/ as features, componentes e hooks
src/shared/ tema, tokens, marca e a UI base
src/scripts/ release, db:push, with-env, stripe:doctor
supabase/ as migrações
docs/ os guias longos
Na raiz ficam só configuração, public/ e supabase/ — os dois últimos porque
o Next e o CLI do Supabase os procuram lá.
Comandos
| Comando | O que faz |
|---|
npm run dev | dev server com .env.dev |
npm run prod | dev server com .env.prod. Dados reais, Stripe LIVE |
npm run typecheck | tsc --noEmit |
npm run check | Biome: organiza imports, formata, corrige lint |
npm run db:push | aplica as migrações no Supabase de dev |
npm run stripe:doctor | diagnostica a configuração do Stripe |
Commits seguem Conventional Commits
(validado pelo husky).
Ambientes
Um projeto na Vercel, dois destinos:
Cada um com seu Supabase e seu Stripe. Nunca aponte os dois para o mesmo
banco, o with-env recusa.
Documentação
O código é comentado com o porquê das decisões, e os cabeçalhos de arquivo
são a primeira parada. Acima deles:
AGENTS.md: o índice. Cada pasta relevante tem o seu,
com as regras que valem ali (src/app/, src/lib/, src/features/billing/server/,
src/features/*/, src/shared/, supabase/).docs/: guias longos: configuração de ambiente,
Stripe, programa de parceiros, bridge React Native, e a auditoria de
segurança em docs/security/.
Esses documentos são escritos para agentes de IA e para pessoas ao mesmo
tempo. Mudou um comportamento que algum deles descreve? Atualize no mesmo
commit, um doc errado é pior que doc nenhum, porque é lido com confiança.
