CLAUDE.md@grab-help-docs git:20260912.b54489fA

Immutable. This exact content is served forever at /api/v1/blob/cbe80cd48cd20c7c.

# CLAUDE.md — `grab-help-docs`

The documentation site for `grab-url`: a Fumadocs site, and a workspace (it is
listed explicitly in the root `workspaces` array).

## It deploys as a static export, not `next build`

`.github/workflows/pages.yml` runs `npm ci` and then:

```bash
node grab-help-docs/scripts/build-static-pages.mjs
```

and publishes the result to GitHub Pages. **That script is what ships** — if the
deployed site and a local dev run disagree, trust the static export. Build
through it before claiming a docs change works.

```bash
npm run make:docs     # turbo run build --filter=grab-help-docs
```

## One page is generated — don't edit it

`content/docs/claude-skill.mdx` is generated from
`skills/use-grab-request/SKILL.md` by `scripts/sync-skill-docs.mjs`, and says so
in a comment at the top. Edit the skill, then `npm run make:skill`.
`node scripts/sync-skill-docs.mjs --check` fails when it is stale.

## The root `docs/` folder is gone

It was a vestigial Jekyll stub from before GitHub Pages switched to deploying
via Actions, and #47 deleted it. **Do not recreate it** — documentation belongs
here, in `content/docs/`.

It is still worth knowing about, because the Vercel project pointed its Root
Directory at that folder for a long time and every deploy failed as a result.
The Root Directory is now the repository root, and the root `vercel.json`
supplies the install, build and output settings that make the docs app build
from there. See
[`../.claude/architecture/documentation.md`](../.claude/architecture/documentation.md)
before changing either file — `vercel.json` here is inert unless the Root
Directory is pointed back at this folder.