Skip to content

Add README with dev setup, build, and deployment docs - #12

Open
miharp wants to merge 1 commit into
OpenVoxProject:mainfrom
miharp:docs/add-readme
Open

Add README with dev setup, build, and deployment docs#12
miharp wants to merge 1 commit into
OpenVoxProject:mainfrom
miharp:docs/add-readme

Conversation

@miharp

@miharp miharp commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

The repo had no README. This adds one covering:

  • What the site is (Jekyll + Vite on the voxblocks component library)
  • Local development setup and the npm run dev workflow, plus a Docker-only option for contributors without Node/Ruby installed
  • The build-order requirement (Vite must run before Jekyll so _data/manifest.json exists)
  • Project layout, including how to add a product page under _products/
  • Both deployment paths: GitHub Pages via deploy.yml and the ghcr.io Docker image via docker-publish.yml

_config.yml already excludes README.md, so nothing leaks into the published site.

Written with AI assistance (Claude Code); reviewed and verified by me.

Covers the Jekyll + Vite architecture, local development workflow,
the Vite-before-Jekyll build order, adding product pages, and both
deployment paths (GitHub Pages and the ghcr.io Docker image).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Signed-off-by: Michael Harp <mike@mikeharp.com>
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