Todos os docs

Atualizado em 2026-10-28

Deploy

Build, hospedagem, domínio e configuração de analytics.

Build

O site é construído como HTML estático no build pelo Next.js:

pnpm build

O Next.js pré-renderiza a home, as páginas de documentação, o sitemap e os assets estáticos para os sete locales em tempo de build. Servir tudo ainda exige um runtime que execute o middleware de negociação de locale (apps/web/src/proxy.ts) e os headers de segurança, então o alvo é a Vercel com o preset Next.js; um host puramente estático perde a negociação de locale.

Hospedagem

A hospedagem de produção é a Vercel:

  • framework preset: Next.js
  • root directory: apps/web
  • build command: pnpm build

O domínio é ella.yuricunha.com, configurado em apps/web/src/data/site.ts e na metadata do app, que dirige as URLs canônicas, o Open Graph e o sitemap.

Rotas de documentação

  • /docs índice das páginas de documentação, por idioma;
  • /docs/<slug> página individual de documentação, por idioma.

Ambas são rotas estáticas geradas no build. O idioma padrão (inglês) não tem prefixo de URL; os outros idiomas carregam o prefixo, por exemplo /pt/docs ou /ja/docs.

Rotas de localização

  • Inglês padrão: https://ella.yuricunha.com
  • Outros idiomas: https://ella.yuricunha.com/<locale>

Cada página declara alternates hreflang para os sete idiomas, e o sitemap lista cada variante.

Analytics

Umami está preparado, mas inerte por padrão. O componente Analytics só renderiza quando ambas as variáveis de ambiente estão presentes no build:

NEXT_PUBLIC_UMAMI_SRC=https://seu-host-umami/script.js
NEXT_PUBLIC_UMAMI_WEBSITE_ID=seu-website-id

Sem elas, o site entrega zero JavaScript de analytics. Nenhum ID de placeholder é commitado.

Gates de qualidade

Nenhum servidor de CI observa os pushes: os pipelines do GitLab foram aposentados e o remote do GitLab é só espelho. Rode os gates antes do push:

pnpm type-check && pnpm lint && pnpm test && pnpm format:check && pnpm build

O pnpm audit --prod também precisa voltar limpo. A Vercel faz o build de produção no deploy; como as páginas são pré-renderizadas, o build verde é o gate.

SEO

  • metadata, Open Graph, Twitter cards, canonical e JSON-LD no layout do locale;
  • robots.txt e o sitemap são gerados no build;
  • o social card é public/og.png (1200x630, gerado com as fontes Geist a partir de um template HTML renderizado);
  • cada idioma ganha sua própria metadata e alternates hreflang.