One config, whole stack. laxative conducts poops (frontend) and septic (backend) into a single MVP — from one poops.json.
It's a conductor, not an engine. poops bundles and renders; septic serves the API, generates the forms, and feeds the static build. laxative just runs them together, on one origin. It reimplements nothing.
You already have the organs:
- poops — the bundler + static-site generator.
- septic — config → SQLite + REST API + generated forms + the poops build bridge.
They already share poops.json. What was missing: running them as one thing — the API and the static site on the same host, so a generated <form> POSTs to /api on the origin that served the page. That's laxative.
npm i -D poops laxative
laxative init # scaffold poops.json (markup + styles + scripts + septic + a form) + the pages
laxative dev # site + /api on one origin; poops watches + live-reloads behind it
laxative build # septic build (DB → markup + forms) → poops compile → dist/
laxative serve # production: serve dist/ + /api + /uploads from one processEvery command takes -c <path> (a config file other than poops.json), -p <number> (the port, over PORT and the 3000 default) and -q (hide the info lines — warnings and errors still print), spelled the way poops spells them.
septic comes along as laxative's own dependency — you never install it separately. poops is an optional peer you install yourself.
Full reference: stamat.info/laxative.
laxative serve/dev boots septic's app (mounting /api/*, /uploads) and serves the poops-built site behind it. Same host, same port:
GET / → dist/index.html (poops output)
GET /api/messages → septic REST (JSON or, for HTMX, HTML)
POST /api/messages → the generated form's target
GET /uploads/… → septic media
A frontend-only project (no septic block) still works — laxative just serves the static site.
Define a resource once in poops.json → septic makes the table + API + form partial, poops renders the page that includes it, laxative serves both together. Define messages → get a working, validated contact form on a static page, wired to its own endpoint.
Yes, still a fan of toilet humor. 💩🚽💊
MIT © Stamat