Skip to content

Add local serving and preview - #12

Closed
ritorhymes wants to merge 3 commits into
eips-wg:masterfrom
ritovision:local-build-system-03-serve-preview
Closed

Add local serving and preview#12
ritorhymes wants to merge 3 commits into
eips-wg:masterfrom
ritovision:local-build-system-03-serve-preview

Conversation

@ritorhymes

Copy link
Copy Markdown
Contributor

Important

This is the third PR in the stacked preprocessor series for preprocessor#8, splitting the original implementation in preprocessor#9 into smaller reviewable slices. This PR builds on the workspace foundation (#10) and editorial command surface (#11) from the earlier stacked PRs, and adds the local runtime paths for serving and previewing the site. The final stacked PR adds the public workflow documentation.

Description

This PR adds the local serving and preview paths on top of the earlier workspace, site build/check, and editorial slices.

It introduces the live local dev-serving loop and a separate built-output preview path, so local runtime work no longer depends only on one-shot site builds.

Changes

  • add the local serve command for the live Zola dev loop
  • add dirty live-serving support for tracked working-tree edits
  • sync tracked source changes into the build-time repo during local serving
  • add the local preview command for serving already-built output
  • add the runtime support and dependencies required for the local serving and preview paths

Not Yet In This PR

This PR does not yet add:

  • the full public workflow documentation

That lands in the final stacked PR.

Validation

This serving and preview slice builds cleanly on top of the earlier stacked slices:

  • cargo build

The broader runtime and staging paths for the local build system were validated on the original combined implementation in preprocessor#9 before restacking, including clean and dirty site builds, parity-oriented checks, and downstream staging verification from the rewritten EIPs#10 and ERCs#10 branches.

This stacked series preserves the final tracked tree of the original local-build-system implementation from preprocessor#9 exactly.

Add the local workspace model for the multi-repo build system.

This adds workspace config and profile support, workspace init,
refresh, and doctor commands, generated helper tasks, and the
local site build path against sibling repos and theme inputs.

The site commands support normal local usage, parity checks,
standard clone and git worktree checkouts, and explicit dirty
builds from the active content repo.
Add explicit editorial commands and keep them separate from the
site command surface.

This adds targeted editorial selection and lets proposal validation
run independently from the normal site build and check commands.
Add local serving and preview paths for the multi-repo workflow.

serve runs the live Zola dev loop and syncs tracked working-tree
edits into the build-time repo during the session. preview serves
already-built output without rebuilding.
@ritorhymes
ritorhymes marked this pull request as ready for review April 16, 2026 02:23
@ritorhymes ritorhymes closed this May 3, 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.

1 participant