Feature: Incremental Rendering with Partial Updates
Instead of full page reloads on file change, swap just the article content via a partial endpoint.
Details
- Add a
/partial/<path> endpoint that returns only the rendered article HTML (no layout)
- Use HTMX, Turbo, or vanilla JS to swap the
#article-content element on change
- Preserve scroll position during content swaps
- Re-run syntax highlighting and TOC generation after swap
- Combine with WebSocket notifications for triggering the swap
- Significantly reduce perceived latency on file changes
Why
Full page reloads are jarring — they reset scroll position, close mobile menus, and flash the screen. Partial updates feel instant and preserve state.
Feature: Incremental Rendering with Partial Updates
Instead of full page reloads on file change, swap just the article content via a partial endpoint.
Details
/partial/<path>endpoint that returns only the rendered article HTML (no layout)#article-contentelement on changeWhy
Full page reloads are jarring — they reset scroll position, close mobile menus, and flash the screen. Partial updates feel instant and preserve state.