Skip to content

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

Merged
miharp merged 1 commit into
OpenVoxProject:mainfrom
miharp:docs/add-readme
Aug 16, 2026
Merged

Add README with dev setup, build, and deployment docs#12
miharp merged 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>
@avitacco
avitacco self-requested a review August 15, 2026 19:49
@avitacco avitacco added the documentation Improvements or additions to documentation label Aug 15, 2026
@avitacco

Copy link
Copy Markdown
Contributor

@miharp I'm sorry this took so long to get to, I was not following the project so I didn't notifications. That has been corrected.

@miharp
miharp merged commit a785877 into OpenVoxProject:main Aug 16, 2026
2 checks passed
@miharp
miharp deleted the docs/add-readme branch August 16, 2026 10:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants