> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 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](https://supastack.dev/pt/docs/web/before-you-start.md)

[Aprenda comandos, arquivos e configuração](https://supastack.dev/pt/docs/web/terminal-basics.md)

[Conclua o tutorial inicial da Web](https://supastack.dev/pt/docs/web/ship-in-5-minutes.md)

```
corepack pnpm --filter @supastack/web dev
```


## Instalaçã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.


## Seguinte

[Temas de produto](https://supastack.dev/pt/docs/web/theming.md)