Add local dev workspace script and localhost binding#990
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a PowerShell-based local development workflow for building and serving the Jekyll documentation site using a merged workspace (docs repo + template repo), with artifacts isolated under .dev/.
Changes:
- Added
scripts/dev.ps1to automate template cloning/updating, workspace merging, bundler setup, andjekyll serve(with flags like-NoServe,-NoTemplateUpdate,-Port,-BindHost). - Updated
README.mdto document the new PowerShell workflow, flags, and local preview URL. - Updated
.gitignoreto ignore the new.dev/workspace and common local Jekyll/Bundler caches.
Reviewed changes
Copilot reviewed 2 out of 3 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| scripts/dev.ps1 | Implements the automated local workspace + serve workflow and isolates Bundler/Jekyll paths under .dev/. |
| README.md | Replaces prior local dev steps with PowerShell script usage and workspace/flag documentation. |
| .gitignore | Ignores .dev/ and common local build/cache directories to keep the repo clean. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Contributor
There was a problem hiding this comment.
Pull request overview
Copilot reviewed 4 out of 5 changed files in this pull request and generated 3 comments.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
lyzhang0113
force-pushed
the
codex/local-dev-workflow-localhost
branch
from
cbf2d00 to
78393db
Compare
tony-xlh
approved these changes
Apr 10, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request introduces a new PowerShell-based local development workflow for the project, replacing the previous manual and Bash-based instructions. The new workflow simplifies setup, automates environment preparation, and provides flexible options for serving and previewing the documentation site. The
README.mdhas been updated with clear instructions for using the new script, and a comprehensivescripts/dev.ps1script has been added to handle all setup tasks.Local development workflow improvements:
scripts/dev.ps1that automates cloning/updating the template repo, merging docs, installing dependencies, and serving the site, with support for various flags (e.g.,-NoServe,-NoTemplateUpdate,-Port,-BindHost).README.mdto document the new PowerShell-based workflow, replacing the previous Bash/manual steps, and describing available script flags and local workspace structure.Environment and reproducibility enhancements:
.dev/directory, improving workspace cleanliness and reproducibility. [1] [2].dev/, reducing the risk of polluting the global environment.Quality-of-life improvements:
git,robocopy,bundle) before proceeding.README.md.