WoozieDeployment
Deployment
How to build your Woozie project for production and deploy it to Vercel, Netlify, GitHub Pages, or anywhere else.
Deployment
Woozie compiles to plain static files. You can host the output literally anywhere.
Build for production
woozie buildThis creates a build/ folder:
build/
index.html
about.html
contact.html
styles.css
app.js
custom.js -- only if you have a script.jsWhere to deploy
Vercel
- Push your project to GitHub
- Import the repo at vercel.com
- Build command:
woozie build - Output directory:
build - Hit deploy
For clean URLs (no .html in the address bar), add a vercel.json:
{
"cleanUrls": true
}Netlify
- Push your project to GitHub
- Import at netlify.com
- Build command:
woozie build - Publish directory:
build - Deploy
For clean URLs, add a netlify.toml:
[[redirects]]
from = "/*"
to = "/index.html"
status = 200Or turn on "Pretty URLs" in the Netlify dashboard under Site settings > Build & deploy.
GitHub Pages
- Run
woozie build - Push the
build/folder to agh-pagesbranch - Enable GitHub Pages in your repo settings
Anywhere else
Upload the build/ folder. It's just HTML, CSS, and JS. Any static host works — Cloudflare Pages, Surge, S3, your own server, whatever.
Clean URLs in production
The dev server handles clean URLs automatically (visiting /about serves about.html). In production, you need to configure your host to do the same. See the provider-specific instructions above.
Before you deploy
- Run
woozie buildand check the output - Open the built files locally to make sure pages work
- Check that images and assets are in the project folder (they get copied to build)
- Make sure
woozie.ruleshas the right title, theme, and font - Add clean URL config for your hosting provider