Skip to content

feat: consume @vantagecompute/docusaurus-theme and upgrade all deps#38

Open
jamesbeedy wants to merge 2 commits into
mainfrom
jamesbeedy-shared-docusaurus-theme
Open

feat: consume @vantagecompute/docusaurus-theme and upgrade all deps#38
jamesbeedy wants to merge 2 commits into
mainfrom
jamesbeedy-shared-docusaurus-theme

Conversation

@jamesbeedy

@jamesbeedy jamesbeedy commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

Summary

Migrates vantage-docs to consume the shared @vantagecompute/docusaurus-theme package and upgrades all dependencies to latest versions.

Changes

Shared theme integration

  • Added @vantagecompute/docusaurus-theme@^0.2.2 as the shared theme package
  • Updated docusaurus.config.js to register the theme, static directories, and rehype transform
  • Replaced 1,858-line custom.css with ~42 lines of project-specific overrides

Removed shared assets (now in theme package)

  • Theme swizzles: ColorModeToggle, DocBreadcrumbs, Tabs, MDXComponents, SecondaryMenu
  • Static assets: Satoshi fonts, SVG icons, logo, favicon, error-suppression.js
  • Utility: rehypeTabsTransform.js (now imported from theme package)
  • Scaffold directory: packages/vantage-docusaurus-theme/ (code lives in its own repo)

Dependency upgrades

  • React 18 → 19
  • TypeScript ~5.6 → ~7.0
  • Docusaurus 3.10 (latest)
  • All other deps upgraded to latest

React 19 migration

  • Removed import React from 'react' (JSX transform handles it)
  • Replaced React.JSX.Element / React.ReactNode with named imports
  • Replaced React.FormEvent with named FormEvent import

Pre-existing fixes

  • Commented out broken sidebar entry for cli/architecture (doc doesn't exist)
  • Removed stale redirect targeting the same page

Build verification

yarn build succeeds — all pages generated

jamesbeedy and others added 2 commits July 10, 2026 07:55
Extract the Vantage design system, brand assets, and shared theme
swizzles into a reusable Docusaurus theme package that all
vantagecompute docs projects can consume via npm.

Includes:
- Design system CSS (tokens, typography, dark/light themes, component styles)
- Brand assets (Satoshi fonts, SVG icons, logo, favicon)
- Theme overrides (ColorModeToggle, DocBreadcrumbs, Tabs bugfix, MDXComponents)
- rehypeTabsTransform utility
- README with installation/usage/customization docs
- MIGRATION.md with step-by-step guide for vantage-docs adoption

The package is scaffolded under packages/vantage-docusaurus-theme
and designed to be moved to its own repo (vantagecompute/vantage-docusaurus-theme)
and published to npm as @vantagecompute/docusaurus-theme.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
- Add @vantagecompute/docusaurus-theme@^0.2.2 as shared theme package
- Upgrade all deps to latest: React 19, TypeScript 7, Docusaurus 3.10
- Replace 1,858-line custom.css with ~42-line project-specific overrides
- Remove shared theme swizzles (ColorModeToggle, DocBreadcrumbs, Tabs,
  MDXComponents, SecondaryMenu) — now provided by theme package
- Remove shared static assets (fonts, icons, logo, favicon, error-suppression)
- Remove packages/ scaffold directory (code now in its own repo)
- Update all components for React 19 (named imports, no React namespace)
- Fix pre-existing broken sidebar/redirect for cli/architecture doc

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@jamesbeedy jamesbeedy changed the title Add @vantagecompute/docusaurus-theme shared package feat: consume @vantagecompute/docusaurus-theme and upgrade all deps Jul 10, 2026
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