CLAUDE.md@grab-help-docs · diff
git:20260911.cad8d02 to git:20260912.b54489f
8 added, 4 removed. Audit A to A.
# 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's Root Directory
- points at that now-missing folder and every deploy fails as a result. See
- [`../.claude/architecture/documentation.md`](../.claude/architecture/documentation.md);
- it is a dashboard setting, so no commit here can fix it.
+ 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.