Skip to content

feat(docs): add Astro/Starlight docs site and deploy Storybook to /sandbox/ - #227

Merged
iamnewton merged 6 commits into
mainfrom
feat/add-docs
Aug 14, 2026
Merged

feat(docs): add Astro/Starlight docs site and deploy Storybook to /sandbox/#227
iamnewton merged 6 commits into
mainfrom
feat/add-docs

Conversation

@iamnewton

Copy link
Copy Markdown
Contributor

Summary

  • Add an Astro/Starlight docs site at the repo root — astro.config.ts using @theholocron/astro-config defineConfig, content in docs/src/content/docs/ (overview, getting-started, structure, components, testing)
  • Wire up createDocsCollections() from @theholocron/docs-theme/content
  • Remove docs/ as a workspace package — all Astro deps live at root; pnpm-workspace.yaml deleted
  • Add docs:dev, docs:build, docs:preview scripts to root
  • Extend root tsconfig.json to cover docs/src/**/* and astro.config.ts (adds allowImportingTsExtensions, skipLibCheck)
  • Update holocron.config.ts: add docs: true to deploy, rename storybook deployment from "app" to "sandbox"
  • Set Storybook base: "/sandbox/" in viteFinal for production builds

Test plan

  • pnpm docs:build succeeds from repo root (after astro sync runs)
  • pnpm build:storybook produces assets with /sandbox/ base paths
  • pnpm typecheck passes

…ndbox/

- Add astro.config.ts at repo root with @theholocron/astro-config defineConfig
- Add docs/src/content/docs/ with overview, getting-started, structure,
  components, and testing pages
- Wire up createDocsCollections() in docs/src/content.config.ts
- Add @astrojs/starlight, astro, @theholocron/astro-config,
  @theholocron/docs-theme to devDependencies; add docs:dev/build/preview scripts
- Remove docs/ workspace package (pnpm-workspace.yaml deleted — no sub-packages)
- Extend tsconfig.json to cover docs/src and astro.config.ts with
  allowImportingTsExtensions and skipLibCheck
- Update .gitignore for .astro/ and docs/dist/
- Update holocron.config.ts: add docs: true to deploy, rename storybook
  deployment from "app" to "sandbox"
- Set Storybook base: "/sandbox/" in viteFinal for production builds

Signed-off-by: Newton <5769156+iamnewton@users.noreply.github.com>
@iamnewton
iamnewton requested a review from a team as a code owner August 14, 2026 19:57
@codecov

codecov Bot commented Aug 14, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

Impacted file tree graph

@@           Coverage Diff           @@
##             main     #227   +/-   ##
=======================================
  Coverage   95.40%   95.40%           
=======================================
  Files           6        6           
  Lines          87       87           
  Branches       11       11           
=======================================
  Hits           83       83           
  Misses          2        2           
  Partials        2        2           
🚀 New features to boost your workflow:
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

…-only

Signed-off-by: Newton <5769156+iamnewton@users.noreply.github.com>
iamnewton and others added 2 commits August 14, 2026 13:51
Signed-off-by: Newton <5769156+iamnewton@users.noreply.github.com>
Signed-off-by: super-linterbot[bot] <310376783+super-linterbot[bot]@users.noreply.github.com>
Comment thread holocron.config.ts Outdated
Co-authored-by: Newton <5769156+iamnewton@users.noreply.github.com>
Signed-off-by: Newton <5769156+iamnewton@users.noreply.github.com>
@iamnewton
iamnewton merged commit e633d17 into main Aug 14, 2026
36 checks passed
@iamnewton
iamnewton deleted the feat/add-docs branch August 14, 2026 21:13
@iamnewton

Copy link
Copy Markdown
Contributor Author

🎉 This PR is included in version 0.4.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

@iamnewton iamnewton added the released Included in a release label Aug 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

released Included in a release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant