Phase 0: static site monorepo foundation#2141
Merged
Merged
Conversation
Prepares for Astro monorepo under web/ in upcoming phases.
Sets up the monorepo root that will house four Astro sites and a shared UI package. No sites yet — that's the next task.
Initial @wheels-dev/ui workspace package. Exports two Astro components and a tokens.css file to be imported by each site.
Astro 5 site that will serve wheels.dev. Uses shared @wheels-dev/ui Header and Footer. Builds clean.
Placeholder Astro site for blog.wheels.dev. Real content collections and post pages come in Phase 1.
Placeholder Starlight site for guides.wheels.dev. Real guide content migrates from docs/src in Phase 3.
Placeholder Starlight site for api.wheels.dev. Function reference generation from docs/api/v*.json comes in Phase 2.
Plan oversight: Task 3 didn't include a .prettierignore, so format:check was scanning generated dist/, .astro/, and pagefind/ output. Adding the ignore file and running pnpm format to bring all source files in line.
github-actions
Bot
added
docs
dependencies
Astro 5 Content Layer requires an explicit collection config. Starlight's built-in docsLoader() resolves the base path without a './' prefix, which Astro's glob loader doesn't handle correctly in our pnpm monorepo — the collection ends up empty and only 404.html gets generated. Using astro/loaders glob directly with base './src/content/docs' restores index.html generation for both guides and api sites.
Matrix job builds and deploys each of the four sites (landing, blog, guides, api) via cloudflare/wrangler-action on push to develop (production deploy) and on PRs (preview deploy with a unique URL). Path filter limits runs to actual web/ changes. Concurrency group cancels in-progress deploys when newer commits land. Requires two repo secrets: - CLOUDFLARE_API_TOKEN (Pages:Edit on this account) - CLOUDFLARE_ACCOUNT_ID
Two issues from first run on PR #2141: 1. Workflow-level 'concurrency' block referenced matrix.site, which only exists at job level. Moved the concurrency declaration into the deploy job so each site gets its own concurrency key. 2. Commitlint scope-enum rejected 'web', 'web/ui', 'web/landing', 'web/blog', 'web/guides', 'web/api', 'web/starlight'. Added them to the allowlist — establishes scope vocabulary for the static-site monorepo going forward.
bpamiri
marked this pull request as ready for review
April 17, 2026 18:55
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
web/monorepo (pnpm workspace) with four Astro sites: landing, blog, guides (Starlight), api (Starlight)@wheels-dev/uipackage with Header, Footer, design tokens.prettierignoreto scope prettier to source files onlyContext
Phase 0 of the wheels.dev static-site migration. Full plan lives in the wheels.dev repo at
docs/superpowers/plans/2026-04-17-phase-0-foundation.md.Subsequent phases:
Test plan
cd web && pnpm install && pnpm buildsucceeds (all 4 sites)pnpm format:checkpassespnpm -r --filter './sites/*' exec astro checkpasses (0 errors/warnings/hints)