craftz
One way to build, check, deploy and release a repository, as a package each one depends on.
Every repository makes the same choices, like its toolchain, versions, workflows, branch protection and deploys. Made in each one separately, they drift. craftz holds them as rules, checks a repository against the version it installs, and fixes what it can. Moving every repository to a new choice is then a version bump, not a copy into each one.
What it does
| Command | Does |
|---|---|
craftz check | checks the repository against every rule, as part of its verify |
craftz fix | writes every fix that can be automated |
craftz upgrade | moves the repository to the latest craftz, and runs its fix |
craftz settings | checks and writes what lives outside the files, on GitHub and Cloudflare |
craftz status | reads what's live: CI, pull requests, npm, and a site's latest build and addresses |
craftz deploy | deploys a site the way its Worker config says |
craftz pr | opens a pull request that merges itself once CI passes |
craftz gone | deletes the local branches that merged |
craftz release | opens the pull request that releases a package |
craftz deps | says what the install holds, and which dependency brings it |
craftz shot | saves a page as a PNG, with the repository's Playwright |
craftz rules | prints the rules, or one rule or part, from the installed version |
craftz help | lists the commands, or prints what one does |
craftz new | starts a repository that already follows the rules |
An agent reads the rules with craftz rules, from the version the repository installed, so it never works from a fetched page or an older copy.
It's opinionated, and built for one setup: Vite+, pnpm, Node 26, GitHub and Cloudflare Workers. A repository on that setup gets the same build, checks, pull requests, releases and deploys as every other one.
Install
pnpm add -D @amitkaps/craftz
pnpm exec craftz fix
The first fix writes the craftz, pr and gone scripts, and the rest of what can be fixed. From then on, pnpm craftz runs it.
It needs Node 26.13.0 or newer, the Node it's built and tested on.
Use
pnpm craftz check # what's out of line
pnpm craftz fix # fix what can be fixed
pnpm craftz rules scripts-verify # what one rule asks, and why
pnpm craftz rules scripts # the Scripts part, and Practice
To start a repository instead, run pnpm dlx @amitkaps/craftz new. To move to a new craftz, add it again at @latest and run pnpm craftz fix, as its usage says.
Read the docs for its design, the rules, its usage, the plan and the lessons.