Skip to content

Migrate website to Docusaurus #59

@thesurenk

Description

@thesurenk

Description

Our current website is built with Hugo. To modernize the developer experience and better integrate documentation, we should migrate the site to Docusaurus.

Tasks:

  • Set up a new Docusaurus project scaffold
  • Port existing content (pages, blog, docs) from Hugo to Docusaurus structure
  • Recreate site navigation, menus, and sidebar configuration
  • Apply theming/branding to match existing design (or improve if needed)
  • Configure site search (Algolia DocSearch or built-in)
  • Set up build and deployment pipeline (GitHub Pages / Netlify / Vercel / custom)
  • QA all pages (links, images, SEO metadata, mobile responsiveness)
  • Update project documentation (README, contribution guide)

Acceptance Criteria:

  • Website runs fully on Docusaurus with all current content migrated.
  • Theming and navigation are consistent with current branding.
  • Build/deployment process is automated and documented.
  • Old Hugo setup is removed once migration is stable.

Notes:
Docusaurus provides better long-term support for developer docs and a stronger ecosystem for versioned documentation, plugins, and search.

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationenhancementNew feature or requestgood first issueGood for newcomers

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions