Skip to content

feat(docs): add docs website - #19

Merged
Hebilicious merged 7 commits into
mainfrom
feat/docs-monorepo-migration
Aug 25, 2026
Merged

feat(docs): add docs website#19
Hebilicious merged 7 commits into
mainfrom
feat/docs-monorepo-migration

Conversation

@Hebilicious

@Hebilicious Hebilicious commented Feb 21, 2026

Copy link
Copy Markdown
Owner

Summary

  • add the VitePress documentation workspace under packages/docs
  • split the package README into focused getting-started, configuration, usage, example, and token-family pages
  • add human navigation, direct homepage links, and an agent routing guide
  • automatically generate /llms.txt, /llms-full.txt, and per-page Markdown with vitepress-plugin-llms
  • keep the package README canonical while routing generated-page edit links to tracked sources
  • run the package build and complete VitePress pipeline in affected moon ci runs
  • configure an assets-only Cloudflare Worker for packages/docs/.vitepress/dist
  • pin Wrangler and provide Moon-owned Cloudflare build, production, and preview targets
  • bootstrap the .prototools versions in Cloudflare before dispatching to Moon

Verification

  • clean Proto bootstrap installed Proto 0.55.2, Node 24.13.1, pnpm 10.30.0, and Moon 2.0.0, then completed docs:build
  • Moon-owned production and preview Wrangler dry-runs validated 65 static assets
  • deployed and smoke-tested https://cssforge.hebilicious.workers.dev
    • homepage and documentation routes return HTML 200
    • /llms.txt, /llms-full.txt, and per-page Markdown return text 200
    • missing routes return the generated HTML 404
  • uploaded and smoke-tested preview version https://pr-19-cssforge.hebilicious.workers.dev
  • independent standards and spec reviews: no findings

Deployment

The assets-only Worker is configured in packages/docs/wrangler.jsonc and production is live at https://cssforge.hebilicious.workers.dev. GitHub Actions remains quality-only.

The intended Cloudflare Builds settings are:

  • root directory: packages/docs
  • build command: bash ./scripts/cloudflare.sh build
  • production deploy command: bash ./scripts/cloudflare.sh deploy
  • non-production deploy command: bash ./scripts/cloudflare.sh preview
  • build variable: SKIP_DEPENDENCY_INSTALL=1 so Proto owns the pinned toolchain
  • production branch: main
  • preview branches: all non-main branches
  • watch paths: docs, CSS Forge/README inputs, Moon/Proto configuration, and workspace dependency files

The Cloudflare Builds Git connection is not yet active because the Wrangler OAuth credential does not carry the separate Workers Builds Configuration: Edit permission required by Cloudflare’s Builds API.

@changeset-bot

changeset-bot Bot commented Feb 21, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 5933fab

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@Hebilicious Hebilicious changed the title fix(docs): fix navigation, search, homepage layout & add animated SVG icons feat(docs): add docs Feb 21, 2026
@Hebilicious Hebilicious changed the title feat(docs): add docs feat(docs): add docs website Feb 21, 2026
@Hebilicious
Hebilicious force-pushed the feat/docs-monorepo-migration branch from 3aa54f6 to 3ed61d1 Compare August 25, 2026 06:07
… icons

- Remove duplicate vue dep to fix SPA hydration (navigation + search)
- Add cleanUrls: true to VitePress config
- Remove opaque background from AnvilAnimation, reduce max-width to prevent text overlap
- Add cyberpunk grid background to .VPHero in custom.css
- Create 6 bespoke animated SVG feature icons (colors, typography, spacing, primitives, zero-runtime, framework)
- Replace emoji icons with SVG src references in index.md
@Hebilicious
Hebilicious force-pushed the feat/docs-monorepo-migration branch from 3ed61d1 to f0d4a59 Compare August 25, 2026 06:48
@Hebilicious
Hebilicious merged commit 9bd548a into main Aug 25, 2026
1 check passed
@Hebilicious
Hebilicious deleted the feat/docs-monorepo-migration branch August 25, 2026 11:31
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