For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /pt/docs/web/seo.md (or send Accept: text/markdown).
SEO e partilha
Metadata, sitemap, robots e imagens sociais.
Antes de começar
Abra seu projeto supastack baixado em Visual Studio Code usando Arquivo → Abrir pasta e escolha Terminal → Novo Terminal. A raiz do repositório é a pasta que contém package.json, apps e pacotes. Execute o comando abaixo e deixe seu terminal aberto. Se um comando não for reconhecido, conclua o guia de instalação da ferramenta antes de continuar.
Leia o tutorial da plataforma primeiro. Um servidor é o processo do aplicativo que responde às solicitações do navegador ou do telefone. A Web lê apps/web/.env.local, Expo lê apps/mobile/.env.local e os comandos de migração de banco de dados leem root .env. A demonstração sem banco de dados/painel é separada das contas reais/auth, que precisam migrar para Postgres. Uma finalização de compra somente por telefone ou desktop precisa de um back-end da Web executado separadamente.
- Instale as ferramentas e obtenha o código
- Aprenda comandos, arquivos e configuração
- Conclua o tutorial inicial da Web
corepack pnpm --filter @supastack/web devInstalação e configuração
A metadata por rota vem da metadata API do Next.js — as páginas exportam um objeto metadata ou generateMetadata, resolvendo títulos e descrições a partir dos dicionários de locale para que os resultados de pesquisa fiquem localizados.
sitemap.ts e robots.ts geram a superfície rastreável; a imagem Open Graph e os ícones carregam a pré-visualização social. Mantém rotas privadas — settings, billing, admin, API — fora do sitemap e em disallow no robots.
app/sitemap.ts public routes only
app/robots.ts disallow private surfaces
// per page
export const metadata = { title, description };Fluxo de implementação
Dá a cada página pública um título e uma descrição únicos; nunca indexes resultados de pesquisa, vistas filtradas ou superfícies autenticadas. Os URLs canónicos ficam sem prefixo — a camada de locale já redireciona o locale por defeito para o caminho canónico.
Quando adicionares uma rota pública, adiciona-a ao sitemap na mesma mudança. Mantém as imagens OG em tokens de marca em vez de screenshots fixos, para que restyles fiquem consistentes.
Verificação e resolução de problemas
Faz fetch de /robots.txt e /sitemap.xml num deploy de preview, valida que o sitemap faz parse e faz share-check de uma página — título, descrição, imagem. Confirma um header ou meta noindex nas páginas de resultados de pesquisa.