Skip to content

feat(docs): migrate to VitePress - #105

Closed
aidil-coder-bot wants to merge 3 commits into
developfrom
feat/vitepress-migration
Closed

aidil-coder-bot wants to merge 3 commits into
developfrom
feat/vitepress-migration

Conversation

@aidil-coder-bot

Copy link
Copy Markdown
Collaborator

Summary

Migrates the documentation site from Vue 3 SPA to VitePress.

Changes

VitePress Site (docs/)

  • Home page with hero, features grid, API preview, and data sources table
  • Guide (Indonesian + English):
    • Memulai / Getting Started
    • Autentikasi / Authentication
    • Penanganan Error / Error Handling
    • Glosarium / Glossary
  • API Reference — 11 endpoint pages:
    • Overview, Health Check, National Latest, National Historical
    • Provinces, Province Cases, Regencies, Hospitals
    • Task Forces, Vaccination, Statistics
  • All images preserved from public/ → docs/public/

Dockerfile

  • Changed build command: pnpm build → pnpm docs:build
  • Changed dist path: /app/dist → /app/docs/.vitepress/dist

Package.json

  • Added scripts: docs:dev, docs:build, docs:preview
  • Added VitePress as devDependency

Build

pnpm docs:build ✅ succeeds locally

- Replace Vue 3 SPA with VitePress documentation site
- Bilingual: Indonesian (default) + English (/en/)
- Guide: memulai, autentikasi, error handling, glosarium
- API reference: 11 endpoint pages (health-check, national, provinces,
  regencies, hospitals, task-forces, vaccination, statistics)
- Update Dockerfile: build with pnpm docs:build, serve from docs/.vitepress/dist
- Add docs:dev, docs:build, docs:preview scripts
@aidil-coder-bot aidil-coder-bot self-assigned this Apr 3, 2026
- Add ApiPlayground Vue component with live request capability
- Add SSR-safe wrapper (ApiPlaygroundWrapper) using onMounted
- Add playground to: health-check, national-latest, national-historical,
  provinces, province-cases, regencies, hospitals, vaccination, statistics,
  task-forces endpoints
- Supports path params, query params, response display with status code & timing
Swagger UI already provides interactive testing. Playground is more
appropriate for stadata_js SDK docs where users need to explore the API.
@ryanaidilp

Copy link
Copy Markdown
Contributor

Closing without merging. The redesign (PR #107, released as 1.6.0 and 1.6.1) is live on production. This PR changes the Dockerfile to build and serve the VitePress site, so merging it and cutting a release would replace the redesigned site. It also conflicts with the redesign in package.json and the lockfile. If a VitePress migration is still wanted, reopen it on top of current develop and decide first whether it should replace the Vue site.

@ryanaidilp ryanaidilp closed this Oct 23, 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.

2 participants