Skip to content

Migrate documentation site from VuePress to VitePress - #315

Merged
1technophile merged 1 commit into
developmentfrom
migrate-vuepress-to-vitepress
May 10, 2026
Merged

Migrate documentation site from VuePress to VitePress#315
1technophile merged 1 commit into
developmentfrom
migrate-vuepress-to-vitepress

Conversation

@1technophile

Copy link
Copy Markdown
Member

Description:

Mirror the migration done in theengs/decoder#691: replace VuePress 1.x (Webpack 4 / Vue 2 / Node 14) with VitePress 1.6.4 (Vite / Vue 3 / Node 18+).

  • Rewrite config in docs/.vitepress/config.mts with sidebar/nav/edit links.
  • Load shared theengs.io commonConfig via docs/.vitepress/commonConfig.mts.
  • Custom theme with medium-zoom for image lightbox.
  • Move favicons from .vuepress/public to .vitepress/public; rename docs/README.md -> docs/index.md.
  • Replace vuepress dep with vitepress + vue + medium-zoom; new docs:dev and docs:build scripts download commonConfig.js as part of the build.
  • Update publish_docs.yml: Node 18, drop Python step, drop curl step (now in npm script), publish from generated/site.
  • Fix dead link in use/use.md.
  • Update .gitignore for VitePress build artifacts.

Checklist:

  • I have created the pull request against the latest development branch
  • I have added only one feature/fix per PR and the code change compiles without warnings
  • I accept the Developer Certificate of Origin (DCO).

Mirror the migration done in theengs/decoder#691: replace VuePress 1.x
(Webpack 4 / Vue 2 / Node 14) with VitePress 1.6.4 (Vite / Vue 3 / Node 18+).

- Rewrite config in docs/.vitepress/config.mts with sidebar/nav/edit links.
- Load shared theengs.io commonConfig via docs/.vitepress/commonConfig.mts.
- Custom theme with medium-zoom for image lightbox.
- Move favicons from .vuepress/public to .vitepress/public; rename
  docs/README.md -> docs/index.md.
- Replace vuepress dep with vitepress + vue + medium-zoom; new docs:dev
  and docs:build scripts download commonConfig.js as part of the build.
- Update publish_docs.yml: Node 18, drop Python step, drop curl step
  (now in npm script), publish from generated/site.
- Fix dead link in use/use.md.
- Update .gitignore for VitePress build artifacts.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@1technophile
1technophile merged commit 991b745 into development May 10, 2026
6 checks passed
@1technophile
1technophile deleted the migrate-vuepress-to-vitepress branch May 10, 2026 17:44
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