@betterstart/cli 0.1.3 → 0.1.4

package/README.md

@@ -0,0 +1,133 @@
+# @betterstart/cli
+
+Scaffold a full-featured, code-generated CMS into any Next.js 16 application. The CMS lives in a self-contained `cms/` directory — you own the code, eject anytime.
+
+## Quick Start
+
+```bash
+npx @betterstart/cli init my-app --preset blog
+```
+
+This will:
+
+1. Create a new Next.js app (or detect your existing project)
+2. Scaffold the CMS into `cms/` with auth, database, admin UI, and API routes
+3. Install all dependencies
+4. Generate blog schemas (posts + categories) with full CRUD
+
+## Commands
+
+### `betterstart init [name]`
+
+Scaffold CMS into a new or existing Next.js project.
+
+```bash
+betterstart init                    # Existing project
+betterstart init my-app             # Fresh project
+betterstart init --preset blank     # No starter content
+betterstart init --preset blog      # Blog (default)
+betterstart init --preset full      # Blog + navigation + contact form
+```
+
+### `betterstart generate <schema>`
+
+Generate entity or form CRUD from a JSON schema in `cms/schemas/`.
+
+```bash
+betterstart generate posts          # Entity CRUD
+betterstart generate contact        # Form (auto-detected)
+betterstart generate posts --force  # Overwrite existing files
+betterstart generate posts --skip-migration  # Skip db:push
+```
+
+### `betterstart remove <schema>`
+
+Remove all generated files for an entity or form.
+
+```bash
+betterstart remove posts
+```
+
+### `betterstart seed`
+
+Create an initial admin user.
+
+```bash
+betterstart seed
+```
+
+## What Gets Generated
+
+For each entity schema, the CLI generates 12 files:
+
+| # | File | Description |
+|---|------|-------------|
+| 1 | `cms/db/schema.ts` | Drizzle table definition (appended) |
+| 2 | `cms/lib/actions/<name>.ts` | Server actions (CRUD) |
+| 3 | `cms/hooks/use-<name>.ts` | React Query hook |
+| 4 | `cms/lib/cache/<name>.ts` | Cache tags + queries |
+| 5 | `app/(cms)/cms/(authenticated)/<name>/columns.tsx` | Table column definitions |
+| 6 | `app/(cms)/cms/(authenticated)/<name>/<name>-table.tsx` | Data table component |
+| 7 | `app/(cms)/cms/(authenticated)/<name>/<name>-page-content.tsx` | Page content (client) |
+| 8 | `app/(cms)/cms/(authenticated)/<name>/page.tsx` | Page (server) |
+| 9 | `app/(cms)/cms/(authenticated)/<name>/<name>-form.tsx` | Create/edit form |
+| 10 | `app/(cms)/cms/(authenticated)/<name>/new/page.tsx` | Create page |
+| 11 | `app/(cms)/cms/(authenticated)/<name>/[id]/edit/page.tsx` | Edit page |
+| 12 | `cms/data/navigation.ts` | Sidebar nav (appended) |
+
+## Schema Format
+
+### Entity Schema
+
+```json
+{
+  "name": "posts",
+  "label": "Posts",
+  "icon": "FileText",
+  "fields": [
+    { "name": "title", "type": "string", "label": "Title", "required": true },
+    { "name": "slug", "type": "string", "label": "Slug", "required": true },
+    { "name": "content", "type": "richtext", "label": "Content" },
+    { "name": "published", "type": "boolean", "label": "Published" },
+    { "name": "publishedAt", "type": "date", "label": "Publish Date" },
+    { "name": "image", "type": "image", "label": "Featured Image" }
+  ]
+}
+```
+
+Field types: `string`, `text`, `richtext`, `number`, `boolean`, `date`, `image`, `select`, `relationship`.
+
+### Form Schema
+
+```json
+{
+  "name": "contact",
+  "label": "Contact Form",
+  "type": "form",
+  "submitButtonText": "Send Message",
+  "fields": [
+    { "name": "name", "type": "text", "label": "Name", "required": true },
+    { "name": "email", "type": "email", "label": "Email", "required": true },
+    { "name": "message", "type": "textarea", "label": "Message", "required": true }
+  ]
+}
+```
+
+## Tech Stack
+
+- **Framework:** Next.js 16 (App Router)
+- **Database:** Drizzle ORM + Neon PostgreSQL
+- **Auth:** Better Auth (email/password, roles)
+- **UI:** Radix UI + Tailwind CSS v4
+- **Rich Text:** TipTap
+- **Storage:** Cloudflare R2
+- **Email:** Resend + React Email (opt-in)
+
+## Requirements
+
+- Node.js >= 22
+- Next.js 16 with TypeScript and Tailwind CSS
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -1,10 +1,2 @@
-#!/usr/bin/env node
-/**
- * CLI entry point for @betterstart/cli
- */
-/**
- * Run the CLI
- */
-declare function run(args?: string[]): Promise<void>;
 
-export { run };
+export {  }