update readme

Author: leonurium

CHANGELOG.md

@@ -7,6 +7,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## 2026-01-30
+
+### Added
+- 📄 **Static API on GitHub Pages** – Same data as JSON files, no backend required:
+  - Generator script: `scripts/generate-static-api.js` (reads `data/2025/` CSVs, outputs `static-api/api/`)
+  - Response shape matches main API: `{ data, meta }` for lists, single object for detail
+  - Endpoints: `api/provinces.json`, `api/province/{code}.json`, `api/regencies/{provinceCode}.json`, `api/regency/{code}.json`, `api/districts/{regencyCode}.json`, `api/district/{code}.json`, `api/villages/{districtCode}.json`, `api/village/{code}.json`
+- 🌐 **Landing page on GitHub Pages** – Root URL serves the same landing page as Vercel; when served from `*.github.io`, demos and playground use the same-origin static API
+- 🤖 **GitHub Actions workflow** – `Deploy Static API to GitHub Pages` (push to `main` or manual): generates static API, copies `public/index.html` to output, deploys to GitHub Pages (Source: GitHub Actions)
+- 📜 **npm script** – `npm run generate:static` to generate static API locally
+- 🧪 **Test script** – `scripts/test-static-api.sh [BASE_URL]` to test all static API endpoints with curl
+- 📖 **Documentation** – [docs/STATIC_API.md](docs/STATIC_API.md) for fork-and-host steps and endpoint reference
+
+### Changed
+- **README** – Option 2 (Static API) now describes landing page + API URLs, feature bullet for static API, `generate:static` and test script in Available Scripts, roadmap item checked, acknowledgments for api-wilayah-indonesia and GitHub Pages
+
+---
+
 ## 2026-01-24
 
 ### 🎉 Major Update: 2025 Government Data

README.md

@@ -30,6 +30,7 @@
 - 🔄 **Backward Compatible** - Drop-in replacement for legacy API
 - 📦 **Self-Hostable** - Deploy to your own Vercel account
 - 🔀 **Advanced Features** - Sorting, pagination, and legacy aliases support
+- 📄 **Static API** - Same data as JSON files for GitHub Pages (no backend)
 
 ## 🚀 Quick Start
 
@@ -48,7 +49,11 @@ curl https://konoland-api.vercel.app/province?name=Jawa
 ```
 
 ### Option 2: Static API on GitHub Pages (no backend)
-Same data as JSON files you can host on GitHub Pages. **Fork** → **Settings → Pages → Source: GitHub Actions** → push to `main` (or run the "Deploy Static API to GitHub Pages" workflow). Your API: `https://<username>.github.io/<repo>/api/provinces.json`. Full guide: [docs/STATIC_API.md](docs/STATIC_API.md).
+Same data as static JSON files you can host on GitHub Pages—no database or server required. **Fork** → **Settings → Pages → Source: GitHub Actions** → push to `main` (or run the "Deploy Static API to GitHub Pages" workflow). You get:
+- **Landing page**: `https://<username>.github.io/<repo>/`
+- **Static API**: `https://<username>.github.io/<repo>/api/` (e.g. `.../api/provinces.json`)
+
+Full guide: [docs/STATIC_API.md](docs/STATIC_API.md). Test locally: `npm run generate:static` then `./scripts/test-static-api.sh [BASE_URL]`.
 
 ### Option 3: Self-Host on Vercel (5 minutes)
 1. **Fork this repository** on GitHub
@@ -289,9 +294,12 @@ npm run start:dev
 npm run start:dev      # Start with hot reload
 npm run build          # Build for production
 npm run start:prod     # Start production server
+npm run generate:static # Generate static API JSON from data/2025 (output: static-api/api/)
 npm run lint           # Run linter
 ```
 
+To test the static API locally after generating: `./scripts/test-static-api.sh` (optional base URL: `./scripts/test-static-api.sh https://leonurium.github.io/konoland-api/api`).
+
 ## 📊 Data Statistics
 
 **2025 Data** (Kepmendagri No 300.2.2-2138 Tahun 2025):
@@ -344,6 +352,7 @@ Existing applications can switch to this API without any code changes!
 
 - [x] ~~Update Data to 2025~~ **✅ DONE** (January 2026)
 - [x] ~~Integrate Postal Codes~~ **✅ DONE** (100% coverage)
+- [x] ~~Static API on GitHub Pages~~ **✅ DONE** (landing page + JSON API, same response shape)
 - [ ] Add caching layer for improved performance
 - [ ] Add API rate limiting
 
@@ -365,9 +374,11 @@ ISC License - See [LICENSE](LICENSE) file
 ## 🙏 Acknowledgments
 
 - **[Wilayah Nusantara API](https://github.com/theodevoid/wilayah-nusantara)** by [@theodevoid](https://github.com/theodevoid) - Original inspiration
+- **[api-wilayah-indonesia](https://github.com/emsifa/api-wilayah-indonesia)** by [@emsifa](https://github.com/emsifa) - Inspiration for static API on GitHub Pages
 - **Kementerian Dalam Negeri (Kemendagri)** - Official 2025 data
 - [Supabase](https://supabase.com) for free PostgreSQL hosting
 - [Vercel](https://vercel.com) for free serverless hosting
+- [GitHub Pages](https://pages.github.com) for static API hosting
 
 ## 📞 Support