Skip to content

Migrate site from Docusaurus to Astro - #30

Merged
tgrall merged 2 commits into
mainfrom
tgrall-migrate-to-astro
Aug 13, 2026
Merged

Migrate site from Docusaurus to Astro#30
tgrall merged 2 commits into
mainfrom
tgrall-migrate-to-astro

Conversation

@tgrall

@tgrall tgrall commented Aug 12, 2026

Copy link
Copy Markdown
Owner

Why

The current Docusaurus 2 site is difficult to maintain and no longer builds reliably on current Node.js releases. This migration moves the site to Astro 7 while preserving the published content contract and modernizing the design and deployment workflow.

What changed

  • Rebuilt the static site with Astro 7, scoped CSS design tokens, responsive layouts, and persisted light/dark themes.
  • Preserved all 275 article URLs, publication metadata, blog pagination, archive pages, 105 tag routes, redirects, sitemap behavior, and 275-entry RSS and Atom feeds.
  • Vendored 20 public Gists so historical articles no longer depend on runtime third-party embeds.
  • Reimplemented the homepage, talks, Copilot, Quarkus, showcase, and 404 experiences.
  • Replaced the legacy deployment workflow with the official GitHub Pages artifact flow and added scheduled production drift and external-link checks.
  • Removed Docusaurus, React-specific site components, starter documentation, and Yarn artifacts.

Validation

  • Deterministic comparison against a committed production baseline covering 426 published routes, normalized article content, metadata, redirects, internal links, fragments, local assets, and feeds.
  • 4 unit tests for route, date, tag, and content compatibility behavior.
  • 28 Playwright checks across desktop and mobile, including accessibility, theme persistence, redirects, showcase behavior, and visual snapshots.
  • Clean npm install, Astro type check/build, production parity validation, and dependency audit all pass.

Review notes

The only explicit semantic-content allowances are seven articles whose remote Gists are now rendered from vendored local data and the 2026 Copilot CLI article whose interactive component was intentionally redesigned. Feed IDs and links remain byte-for-byte stable so existing readers do not see historical entries as new items.

Tugdual Grall and others added 2 commits August 12, 2026 09:56
Rebuild the site on Astro 7 while preserving published routes, metadata, feeds, and content. Add deterministic production parity checks, browser and accessibility coverage, and modern GitHub Pages deployment.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@tgrall
tgrall merged commit 2d1ba30 into main Aug 13, 2026
2 of 4 checks passed
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