Skip to main content

Architecture

This section consolidates key enhancements and the current technical architecture:

1. Enhancements​

  • Automatic Versioning: Eliminated VERSION.txt, now uses PreBuild.getVersion() for on-the-fly YYYY.MM.DD versions.
  • README Integration: Markdown files from project root are copied to src/pages and indexed for navigation via pre-build.
  • Navbar Autogeneration: Scans root .md files and emits src/navbarLinks.ts before each build.
  • Badge System: BadgeConfig static class + useConfig hook for dynamic GitHub badges.
  • Comments: GiscusConfig static class for Giscus-powered discussions.
  • Theme System: Ten built-in themes in static/themes/ with live light/dark switching.

2. Architecture​

  • Scripts: TypeScript class PreBuild handles both content preparation and versioning.
  • Components: Modular React hooks and components for badges and comments.
  • Config Classes: Strongly-typed classes (BadgeConfig, GiscusConfig, VersionConfig) replace JSON imports for static access.

3. Workflow​

  • Development: npm start runs pre-build tasks then starts docusaurus start.
  • Production Build: npm run build triggers pre-build, then docusaurus build.
  • Type Checking: npm run typecheck ensures all TS scripts and components validate.