dearsky/numa
1
0
Fork 0
Code Issues 10 Pull Requests 1 Actions Packages Projects Releases 25 Wiki Activity

chore(site): live-reload dev server #132

Merged
razvandimescu merged 1 commits from chore/site-live-reload into main 2026-04-22 22:17:38 +08:00
Conversation 0 Commits 1 Files Changed 1 +36 -9
razvandimescu commented 2026-04-22 21:36:09 +08:00 (Migrated from github.com)
Copy Link

Summary

  • scripts/serve-site.sh now uses chokidar-cli + browser-sync instead of plain python3 -m http.server: MD edits regenerate HTML, browser reloads on rendered-asset changes.
  • First run pulls both via npx (slow once, instant after).
  • Preflight checks for npx and pandoc.
  • Cleanup trap kills watcher + server on exit so re-runs don't leave orphans.
  • Port arg parsing tolerates legacy --drafts flag ordering; drafts are always included now (that's what the dev loop actually wants).

CI is intentionally skipped for scripts/serve-site.sh via paths-ignore in .github/workflows/ci.yml — no Rust surface to test.

Test plan

  • bash -n scripts/serve-site.sh clean (syntax valid).
  • scripts/serve-site.sh 9000 serves at http://localhost:9000.
  • Editing a drafts/*.md file regenerates HTML; browser tab reloads automatically.
  • Ctrl-C leaves no orphaned chokidar / browser-sync processes (pgrep -f chokidar empty).
  • Missing pandoc or npx produces a clear install-pointer error.
## Summary - `scripts/serve-site.sh` now uses `chokidar-cli` + `browser-sync` instead of plain `python3 -m http.server`: MD edits regenerate HTML, browser reloads on rendered-asset changes. - First run pulls both via `npx` (slow once, instant after). - Preflight checks for `npx` and `pandoc`. - Cleanup trap kills watcher + server on exit so re-runs don't leave orphans. - Port arg parsing tolerates legacy `--drafts` flag ordering; drafts are always included now (that's what the dev loop actually wants). CI is intentionally skipped for `scripts/serve-site.sh` via `paths-ignore` in `.github/workflows/ci.yml` — no Rust surface to test. ## Test plan - [x] `bash -n scripts/serve-site.sh` clean (syntax valid). - [ ] `scripts/serve-site.sh 9000` serves at `http://localhost:9000`. - [ ] Editing a `drafts/*.md` file regenerates HTML; browser tab reloads automatically. - [ ] Ctrl-C leaves no orphaned `chokidar` / `browser-sync` processes (`pgrep -f chokidar` empty). - [ ] Missing `pandoc` or `npx` produces a clear install-pointer error.
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
bug
Something isn't working
 dependencies
Pull requests that update a dependency file
 docker
Pull requests that update docker code
 documentation
Improvements or additions to documentation
 duplicate
This issue or pull request already exists
 enhancement
New feature or request
 github_actions
Pull requests that update GitHub Actions code
 good first issue
Good for newcomers
 help wanted
Extra attention is needed
 invalid
This doesn't seem right
 question
Further information is requested
 rust
Pull requests that update rust code
 wontfix
This will not be worked on
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
dearsky
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: dearsky/numa#132
Delete Branch "chore/site-live-reload"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?