create-workerstack 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,58 @@
+# create-workerstack
+
+Scaffold a full-stack Cloudflare Workers app in seconds.
+
+## Quick Start
+
+```bash
+# With bun (recommended)
+bunx create-workerstack@latest my-app
+
+# With npm
+npm create workerstack@latest my-app
+
+# With pnpm
+pnpm create workerstack@latest my-app
+```
+
+## What's Included
+
+| Technology | Role |
+|---|---|
+| **Cloudflare Workers** | Edge-first serverless runtime |
+| **Hono** | Ultrafast web framework |
+| **React 19** | UI library with SSR support |
+| **MUI Material** | Production-grade component library |
+| **Better Auth** | Authentication (email/password, OAuth, admin) |
+| **Drizzle ORM** | Type-safe SQL ORM with PostgreSQL |
+| **Vite** | Build tool with HMR |
+| **Resend** | Transactional email service |
+| **TypeScript** | End-to-end type safety |
+
+## CLI Options
+
+The CLI walks you through an interactive setup:
+
+- **Project name** — also used for `package.json` and `wrangler.jsonc`
+- **Description** — sets `package.json` description
+- **Package manager** — bun, npm, or pnpm
+- **Install dependencies** — run install automatically after scaffolding
+- **Initialize git** — run `git init` in the new project
+
+You can also pass the project name as an argument to skip the first prompt:
+
+```bash
+bunx create-workerstack@latest my-app
+```
+
+## After Scaffolding
+
+```bash
+cd my-app
+cp .env.example .env   # configure your environment variables
+bun run dev             # start the development server
+```
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-workerstack",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Scaffold a full-stack Cloudflare Workers app with Hono, React, MUI, Better Auth, and Drizzle",
   "type": "module",
   "bin": {

package/template/README.md

@@ -0,0 +1,109 @@
+# WorkerStack App
+
+Full-stack app running on Cloudflare Workers, built with [WorkerStack](https://www.npmjs.com/package/create-workerstack).
+
+## Stack
+
+- **Runtime** — Cloudflare Workers (edge serverless)
+- **Backend** — Hono
+- **Frontend** — React 19 + MUI Material
+- **Auth** — Better Auth (email/password, admin plugin)
+- **Database** — Drizzle ORM + PostgreSQL
+- **Email** — Resend
+- **Build** — Vite + TypeScript
+
+## Prerequisites
+
+- [Bun](https://bun.sh/) (or npm/pnpm)
+- [Cloudflare account](https://dash.cloudflare.com/sign-up)
+- PostgreSQL database (e.g. [Neon](https://neon.tech/), [Supabase](https://supabase.com/))
+
+## Getting Started
+
+```bash
+# Install dependencies
+bun install
+
+# Set up environment variables
+cp .env.example .env
+# Edit .env with your DATABASE_URL, BETTER_AUTH_SECRET, etc.
+
+# Generate Cloudflare types
+bun run cf-typegen
+
+# Run database migrations
+bun run db:migrate
+
+# Start development server
+bun run dev
+```
+
+The app will be available at `http://localhost:5000`.
+
+## Scripts
+
+| Script | Description |
+|---|---|
+| `bun run dev` | Start Vite dev server with HMR |
+| `bun run build` | Production build |
+| `bun run preview` | Build and preview locally |
+| `bun run deploy` | Build and deploy to Cloudflare |
+| `bun run deploy:dev` | Deploy to dev environment |
+| `bun run cf-typegen` | Generate Cloudflare bindings types |
+| `bun run typecheck:client` | Type-check client code |
+| `bun run typecheck:server` | Type-check server code |
+| `bun run db:generate` | Generate Drizzle migrations |
+| `bun run db:migrate` | Run database migrations |
+| `bun run ba:schema` | Generate Better Auth schema |
+
+## Project Structure
+
+```
+src/
+├── api/
+│   ├── index.ts              # API routes (Hono)
+│   └── middlewares/
+│       └── auth.ts           # Authentication middleware
+├── client/
+│   ├── App.tsx               # React app entry point
+│   ├── main.tsx              # React DOM mount
+│   └── tsconfig.json         # Client TypeScript config
+├── database/
+│   ├── db.ts                 # Drizzle ORM setup
+│   ├── schema.ts             # Database schema
+│   ├── auth-schema.ts        # Better Auth generated schema
+│   └── migrations/           # SQL migrations
+├── lib/
+│   └── better-auth/
+│       ├── index.ts          # Auth instance factory
+│       └── options.ts        # Auth configuration
+├── services/
+│   └── email.ts              # Email service (Resend)
+├── utils/
+│   ├── logger.ts             # Structured logging
+│   └── noCache.ts            # Cache control middleware
+├── index.tsx                 # Server entry (Hono app)
+├── client.tsx                # HTML shell renderer
+└── style.css                 # Global styles
+```
+
+## Environment Variables
+
+| Variable | Description |
+|---|---|
+| `DATABASE_URL` | PostgreSQL connection string |
+| `BETTER_AUTH_URL` | Base URL for auth (e.g. `http://localhost:5000`) |
+| `BETTER_AUTH_SECRET` | Secret key for sessions |
+| `RESEND_API_KEY` | Resend API key for emails |
+
+## Deploy
+
+```bash
+# Production
+bun run deploy
+
+# Dev environment
+bun run deploy:dev
+```
+
+Make sure to set your environment variables in the Cloudflare dashboard under **Workers & Pages > your-worker > Settings > Variables**.