CLAUDE.md@grab-help-docs · diff
git:20260911.d918668 to git:20260911.cad8d02
9 added, 3 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.
- ## Not to be confused with
+ ## The root `docs/` folder is gone
- The root `docs/` directory — a small static landing page for grab.js.org
- (`index.html`, `_config.yml`). Documentation does not go there.
+ 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.