Metadata Files
Core Idea
Página-índice das convenções de metadata file: arquivos especiais (estáticos ou gerados por código) que o Next.js serve automaticamente e usa para popular o <head> com as tags corretas.
Key Concepts
- Variante estática vs dinâmica: cada convenção aceita um arquivo estático (ex.:
opengraph-image.jpg) ou um arquivo de código (ex.: opengraph-image.js) que gera o asset.
- Cache por padrão: Route Handlers especiais como
sitemap.ts, opengraph-image.tsx e icon.tsx são cacheados por padrão.
- Hashing em produção: arquivos servidos automaticamente recebem hash para cache busting em produção.
Anti-patterns
- Usar
proxy.ts sem excluir os metadata files no matcher: pode interceptar/bloquear a resposta desses arquivos especiais indevidamente.
Key Takeaways
- Esta é uma página de sumário; o conteúdo real está nas subpáginas: favicon/icon/apple-icon, manifest.json, opengraph-image/twitter-image, robots.txt, sitemap.xml.
- Ao configurar Proxy, sempre exclua os metadata files do matcher para não quebrar SEO/compartilhamento social.
Connects To
- favicon, icon, and apple-icon: convenção de ícones.
- manifest.json: convenção de Web App Manifest.
- opengraph-image and twitter-image: convenção de imagens sociais.
- robots.txt / sitemap.xml: convenções de SEO.