vercel-static-configlisted
Install: claude install-skill sharabarinillia/SEO-GEO-Vercel-Playbook-Skill
# vercel.json for static sites
Three jobs: **one URL per page**, **the right cache lifetime per file type**, and **only the real
domain in search**. Everything else is optional.
## Steps
1. **Pick the format** (details: [references/config-formats.md](references/config-formats.md)):
- **Modern** (`trailingSlash`, `cleanUrls`, `redirects`, `headers`): the default for new projects.
Template: [assets/vercel.static.json](assets/vercel.static.json).
- **Legacy `routes`**: when you need route-level features such as host-conditioned headers with
`continue`, or firewall `mitigate` rules in the file. It can't be mixed with the modern keys.
Template: [assets/vercel.routes.json](assets/vercel.routes.json).
2. **One URL per page.** Choose trailing slash or not, and make the other form redirect with 308
(`trailingSlash: true` does it; paths with a file extension are left alone). Redirect
`/index.html` URLs. Redirect the apex domain to `www` (or the reverse) in Project → Settings →
Domains. Link internally only to the canonical form.
3. **Keep the `*.vercel.app` hosts out of search.** Redirect the project's own production
`my-project.vercel.app` domain to the real domain (a host-scoped redirect naming that exact
host), and send `X-Robots-Tag: noindex` on every `*.vercel.app` host, or keep previews behind
Deployment Protection.
4. **Cache by file type** ([references/caching.md](references/caching.md)):
| Files | Cache-Control |
|---|---|
|