create-xerobi
v0.1.6
Published
Scaffold opinionated Xerobi Lab projects (Cloudflare Workers + Hono + D1 + KV + R2 + React)
Maintainers
Readme
create-xerobi
Opinionated project scaffolder for Xerobi Lab: Cloudflare Workers + Hono + D1 + KV + R2 + React.
Usage
npm create xerobi@latest my-projectStatus
Early release (v0.1.0) — reserving the package name and shipping a working
Cloudflare Worker + Hono API template first. More templates (React, Next.js,
fullstack Worker + React monorepo) are planned.
Templates
- [x] Cloudflare Worker + Hono API (D1, R2, Drizzle optional)
- [ ] React App
- [ ] Next.js App
- [ ] Fullstack Worker + React (Turborepo)
Development
git clone <repo>
cd create-xerobi
npm install
npm link
create-xerobi my-test-appPublishing
Publishing is automated via GitHub Actions (.github/workflows/publish.yml).
- Bump the version and let
npm versioncreate the commit + tag:npm version patch # or minor / major git push && git push --tags - On GitHub, create a Release using the tag that was just pushed (e.g.
v0.2.0). - Publishing to npm happens automatically once the Release is published. The
workflow verifies the release tag matches
package.json's version before publishing, so a mismatch fails safely instead of shipping the wrong version.
One-time setup
Add an npm Automation access token as a repo secret named NPM_TOKEN:
npm token create --read-only=falseGitHub repo → Settings → Secrets and variables → Actions → New repository secret
→ name NPM_TOKEN.
Manual/local publish is still possible if needed:
npm publish --access public