Calcule Brasil

Hub de calculadoras brasileiras para estimar custos do dia a dia, impostos e decisões financeiras comuns no Brasil. A aplicação usa React, TypeScript, TanStack Start e Cloudflare Workers.

As 38 páginas públicas são pré-renderizadas no build para entregar conteúdo, metadados e JSON-LD sem depender da execução de JavaScript. As calculadoras continuam interativas após hidratação.

Conteúdo:

• 12 calculadoras interativas: custo de carro, morar sozinho, conta de luz, assinaturas, pet, mudança, IRPF 2026, salário líquido, INSS autônomo, CLT vs PJ, previdência complementar e benefícios fiscais.
• 15 artigos de blog com conteúdo educativo e suporte a clusters SEO.
• 4 comparativas side-by-side: streaming, academia, mudança e energia.
• 1 hub central de comparações.
• 6 páginas institucionais: sobre, metodologia, privacidade, termos, contato e 404.

Requisitos

• Node.js 22.12 ou superior
• npm

Desenvolvimento

npm ci
npm run dev

O servidor local inicia em http://localhost:8080.

Validação

npm run check

O gate executa:

• tipos gerados pelo Wrangler;
• testes das fórmulas;
• TypeScript e ESLint;
• build client e Worker;
• pré-renderização das 38 rotas públicas;
• smoke test SEO sem JavaScript;
• dry-run do deploy;
• auditoria de dependências.

Build e deploy

npm run build
npm run preview
npm run deploy:preview
npm run deploy

O build gera:

• dist/client: assets e HTML pré-renderizado;
• dist/server: Worker do TanStack Start;
• dist/client/sitemap.xml: sitemap gerado da lista central em src/lib/seo-pages.ts.

O alvo de produção é Cloudflare Workers. O ambiente preview usa o Worker calcule-brasil-preview; produção usa calcule-brasil.

npm run preview sobe uma prévia local do build para validação antes do deploy. O primeiro deploy remoto deve ser feito com npm run deploy:preview; use npm run deploy apenas após validar o Worker de preview, APIs, sitemap, 404 e headers.

Variáveis e segredos

Variáveis não sensíveis ficam em :