feat: migrate from Starlight to Nimbus documentation framework - #15
Merged
Conversation
Replace @astrojs/starlight with nimbus-docs as the documentation site framework. Add Tailwind CSS v4, Pagefind search, custom fonts (Inter, JetBrains Mono), and astro-icon/astro-og-canvas integrations. Convert splash page hero from Starlight components to custom Nimbus layout with Tailwind styling. Update content config to use Nimbus collections with custom schema fields. Add TypeScript path aliases and update all references from
github-actions
Bot
added
review/needs-review
Contributor
Scope checkThis PR changes 6,828 lines across 106 files. PolyStella is maintained by a small team, so smaller focused PRs are more likely to be reviewed. If this scope is intentional, no action is required. |
🚀 Deploying Preview to Cloudflare 🚀Preview Deployments by commit
|
Add `pnpm changeset` command to scripts table and expand "Always" section with guidance on when to create Changesets entries vs empty changesets for non-release changes (docs-site-only, CI-only maintenance).
Replace remaining "Starlight" references with "Nimbus docs" in workflow job name, contributor guide, and README to reflect the documentation framework migration.
diogoascarneiro
force-pushed
the
switch-docs-to-nimbus
branch
from
July 6, 2026 10:32
a8011d9 to
5b44e27
Compare
Add `aiGenerated: true` frontmatter field to all documentation pages drafted by AI agents. Update content schema to accept the boolean flag, add it to config reference generation script, and wire it into PageActions component to display "AI-generated · awaiting review" badge with sparkle icon when present.
Deploying with
|
| Status | Name | Latest Commit | Preview URL | Updated (UTC) |
|---|---|---|---|---|
| ✅ Deployment successful! View logs |
polystella-docs | 8011fa2 | Commit Preview URL Branch Preview URL |
Jul 06 2026, 11:01 AM |
commit: |
Merged
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.
What does this PR do?
Migrates the docs site from Starlight to Nimbus while keeping Astro 7, adds the Nimbus docs shell/components/configuration, and updates repo references from Starlight to Nimbus.
Also documents the Changesets requirement for package-affecting changes.
Closes N/A
Type of change
PolyStella invariants touched
Checklist
CONTRIBUTING.mdpnpm testpasses, or I have explained why it was not runpnpm exec tsc --noEmitpasses, or I have explained why it was not runAI-generated code disclosure
Screenshots / logs / test output
Passed locally:
pnpm --filter polystella-docs buildpnpm exec prettier --check docspnpm --filter polystella-docs exec nimbus-docs lintpnpm --filter polystella-docs check-exportspnpm --filter polystella-docs check-examplespnpm testpnpm exec tsc --noEmit