Skip to content

Add the documentation site for docs.pushform.io - #76

Merged
pfsteve merged 2 commits into
mainfrom
feat/docs-site
Nov 6, 2026
Merged

pfsteve merged 2 commits into
mainfrom
feat/docs-site

Conversation

@pfsteve

@pfsteve pfsteve commented Nov 6, 2026

Copy link
Copy Markdown
Collaborator

Adds a public documentation site built with Astro Starlight, published at docs.pushform.io.

Site

  • docs/ is now a workspace package (@pushform/docs) with a home page and four getting-started guides. Run it with pnpm docs:dev and build it with pnpm docs:build.
  • Search is built in (Pagefind, no external service). The build also writes a sitemap.
  • docs/help/ is unchanged and stays separate. AI Chat keeps searching those guides, and the site does not build from them. docs/README.md explains how the two relate.

Pipeline

  • New docs workflow, triggered only by changes under docs/ outside docs/help/ (or to the workflow itself):
    • pull requests: build the site
    • pushes to main: build, deploy docs/dist to the Cloudflare Pages project pushform-docs, then verify docs.pushform.io serves the new build
    • manual runs redeploy
  • scripts/verify-static-deploy.mjs now also recognizes Astro's hashed assets (/_astro/), with a test.

Other changes

  • Astro 7 brings vite 8 into the workspace, which moved the root vitest onto it. A root vite@^7 dev dependency keeps the test runner on vite 7.
  • ESLint ignores Astro's generated .astro/ directory.
  • The new dependencies pass pnpm license-check.

Checks

pnpm typecheck, pnpm lint, pnpm test (582 files, 4447 tests), pnpm spdx-check, pnpm license-check and pnpm docs:build pass locally. I checked the site in a browser (both themes, sidebar, search) and saw no console errors.

🤖 Generated with Claude Code

Build a Starlight site in docs/ with a home page and four getting-started
guides. The in-app help guides in docs/help stay separate: AI Chat keeps
searching them and the site does not build from them.

A docs workflow runs only when the site changes (docs/ outside docs/help).
Pull requests build it; main deploys it to the pushform-docs Pages project
and checks that docs.pushform.io serves the new build. The static deploy
check now also recognizes Astro's hashed assets. Root vitest stays on vite 7
now that Astro brings vite 8 into the workspace.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@pfsteve
pfsteve enabled auto-merge November 6, 2026 21:03
@pfsteve
pfsteve disabled auto-merge November 6, 2026 21:08
@pfsteve
pfsteve merged commit 7b26a07 into main Nov 6, 2026
13 checks passed
@pfsteve
pfsteve deleted the feat/docs-site branch November 6, 2026 21:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant