docs: replace VitePress with Astro/Starlight; apply shared docs-theme#5
Merged
Conversation
- Replace VitePress config (.vitepress/) with Astro + Starlight setup
(astro.config.mjs, docs/site/package.json, pnpm-lock.yaml)
- Migrate all docs markdown from docs/site/{guide,reference,ecosystem,index}.md
to docs/site/src/content/docs/ with Starlight frontmatter
- Add custom landing page (index.astro): blue-glow palette, interactive
terminal demo with three tabs, feature grid, ecosystem pipeline map
- Add shared theme files under docs/site/src/theme/ (synced from
packages/docs-theme): theme-blue.css tokens, base.css Starlight overrides,
CommandOutput.astro component
- Update package.json: remove vitepress devDependency; change docs:* scripts
to use pnpm --dir docs/site
- Update .gitignore: replace VitePress paths with Astro equivalents
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
tsup 8.x injects baseUrl into the DTS build worker. TypeScript 6.0 treats this as a deprecation error without ignoreDeprecations. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…tifact path Same workspace install bug as fhir-resource-diff PR #3: pnpm-workspace.yaml at the repo root makes pnpm treat root as the workspace root, so `pnpm install` from docs/site installs root packages only, leaving docs/site/node_modules empty. Changes: - pnpm-workspace.yaml: add packages: [docs/site]; add sharp to allowBuilds - docs.yml: fix artifact path from .vitepress/dist to dist (Astro output) - docs/site/package.json: replace sharp@0.34.5 + @img/sharp-darwin-arm64 with sharp@0.33.5 — the 0.34 @img/* approach fails under pnpm virtual store and breaks cross-platform CI (darwin binary in dependencies) - docs/site/pnpm-workspace.yaml: deleted (was an attempted workaround, not needed) - docs/site/pnpm-lock.yaml: deleted, absorbed into root lockfile - pnpm-lock.yaml: regenerated to include docs/site deps Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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
Migrates the documentation site from VitePress to Astro 5 + Starlight 0.34, and applies the shared
@fhir-toolkit/docs-themevia the Option B source-directory sync strategy (no npm dependency -- theme files are vendored intosrc/theme/by runningnode packages/docs-theme/scripts/sync.jsat the workspace root).Changes
docs/site/-- replaced VitePress scaffold with Astro + Starlight; content migrated to Starlight content collectionsdocs/site/astro.config.mjs--customCssloadstheme-blue.css+base.cssfromsrc/theme/beforecustom.cssdocs/site/src/theme/-- synced shared theme: tokens, Starlight overrides,CommandOutput.astrodocs/site/src/pages/index.astro-- custom landing page matching toolkit design systempnpm-lock.yaml-- VitePress and Algolia dependencies removed.gitignore-- updated to coverdocs/site/.astro/anddocs/site/dist/(replacing VitePress entries)How to update the theme going forward
node packages/docs-theme/scripts/sync.js # from fhir-toolkit/ workspace rootVerification
pnpm buildpasses with 0 errors. All 65 unit tests pass.