create-crm-starter 0.1.0

package/README.md

@@ -0,0 +1,53 @@
+# create-crm-starter
+
+Interactive scaffolder for **Next.js 15 home-services CRMs** — HVAC, plumbing,
+electrical, and general field-service businesses. Answer a few questions and it
+assembles a runnable, branded CRM with realistic demo data.
+
+```bash
+npx create-crm-starter my-crm
+```
+
+Think **create-t3-app, but for home-services CRMs**: a base Next.js app plus
+opt-in feature modules, two auth/DB stacks, and industry presets that pick
+sensible defaults.
+
+## What you get
+
+- **Customers, Jobs, Calendar/Dispatch** — real CRUD, drag-drop scheduling, a job status pipeline.
+- **Estimates, Invoices, Payments** — Stripe Checkout + webhook reconciliation, a public pay page.
+- **Price Book, Service Plans, Checklists** — catalog-driven line items and field checklists.
+- **Comms** — Twilio SMS (two-way inbox) + Resend email.
+- **Reviews, Reporting, Landing page** with an online booking widget.
+- **Industry presets** — HVAC, plumbing, electrical, cleaning, landscaping, roofing, general — each sets brand colors, service types, and the right extra modules.
+- **Optional field-tech iPhone app** (Expo) — a branded app for technicians: today's schedule, job detail with Navigate/Call, status updates, photo + signature capture, push notifications, clock in/out, checklists, in-field invoicing + take payment, an estimate builder, and a two-way SMS inbox. Ships with a JSON API + token auth wired into the generated CRM.
+- **Realistic seed data** so `pnpm dev` shows a populated dashboard on first run.
+
+## Pick your stack at prompt time
+
+- **Better-Auth + Postgres + Drizzle** *(recommended for client delivery)* — full-featured, no vendor lock-in, owns its data. The iPhone app and all modules target this stack.
+- **Clerk + Convex** *(preview)* — core modules (customers + jobs) fully working; richer modules render sample data.
+
+## The flow
+
+`npx create-crm-starter my-crm` asks for: project name, industry, branding
+(name, colors, logo), which modules you want, the auth/DB stack, user roles,
+the first admin, whether to seed demo data, and your deploy target — then
+writes a tailored project you can `pnpm dev` immediately.
+
+## Per-client delivery
+
+This tool is built to spin up a **separate CRM per client** (one scaffold →
+one Vercel deploy → one Postgres database, fully isolated). The generated
+project ships its own README hand-off checklist, and the repo's
+`DEPLOYMENT.md` is the agency zero-to-live runbook (Neon + Vercel, env vars,
+Stripe/Twilio webhooks, and the per-client iPhone-app build).
+
+## Requirements
+
+- Node **≥ 18.18**
+- A package manager (pnpm recommended). For the Drizzle stack: a Postgres database (Neon, Supabase, RDS, or the included docker-compose).
+
+## License
+
+MIT © Doug Allen