@thinhnguyencth1204/nextcli 0.7.0 → 0.9.0

package/templates/next-base/.env

@@ -1,2 +1,18 @@
 # --- App ---
 NEXT_PUBLIC_APP_URL="http://localhost:3000"
+
+# --- module: database ---
+DATABASE_URL="postgresql://postgres.your-project-ref:your-supabase-db-password@aws-0-us-east-1.pooler.supabase.com:6543/postgres?pgbouncer=true"
+DIRECT_URL="postgresql://postgres.your-project-ref:your-supabase-db-password@aws-0-us-east-1.pooler.supabase.com:5432/postgres"
+
+# --- module: supabase ---
+NEXT_PUBLIC_SUPABASE_URL=""
+NEXT_PUBLIC_SUPABASE_ANON_KEY=""
+NEXT_PUBLIC_SUPABASE_STORAGE_BUCKET="public"
+
+# --- module: auth ---
+BETTER_AUTH_SECRET=""
+BETTER_AUTH_URL="http://localhost:3000"
+
+# --- module: i18n ---
+NEXT_PUBLIC_DEFAULT_LOCALE="vi"

package/templates/next-base/.env.development

@@ -1,2 +1,18 @@
 # --- App ---
 NEXT_PUBLIC_APP_URL="http://localhost:3000"
+
+# --- module: database ---
+DATABASE_URL="postgresql://postgres.your-project-ref:your-supabase-db-password@aws-0-us-east-1.pooler.supabase.com:6543/postgres?pgbouncer=true"
+DIRECT_URL="postgresql://postgres.your-project-ref:your-supabase-db-password@aws-0-us-east-1.pooler.supabase.com:5432/postgres"
+
+# --- module: supabase ---
+NEXT_PUBLIC_SUPABASE_URL=""
+NEXT_PUBLIC_SUPABASE_ANON_KEY=""
+NEXT_PUBLIC_SUPABASE_STORAGE_BUCKET="public"
+
+# --- module: auth ---
+BETTER_AUTH_SECRET=""
+BETTER_AUTH_URL="http://localhost:3000"
+
+# --- module: i18n ---
+NEXT_PUBLIC_DEFAULT_LOCALE="vi"

package/templates/next-base/.env.example

@@ -1,2 +1,18 @@
 # --- App ---
 NEXT_PUBLIC_APP_URL="http://localhost:3000"
+
+# --- module: database ---
+DATABASE_URL="postgresql://postgres.your-project-ref:your-supabase-db-password@aws-0-us-east-1.pooler.supabase.com:6543/postgres?pgbouncer=true"
+DIRECT_URL="postgresql://postgres.your-project-ref:your-supabase-db-password@aws-0-us-east-1.pooler.supabase.com:5432/postgres"
+
+# --- module: supabase ---
+NEXT_PUBLIC_SUPABASE_URL=""
+NEXT_PUBLIC_SUPABASE_ANON_KEY=""
+NEXT_PUBLIC_SUPABASE_STORAGE_BUCKET="public"
+
+# --- module: auth ---
+BETTER_AUTH_SECRET=""
+BETTER_AUTH_URL="http://localhost:3000"
+
+# --- module: i18n ---
+NEXT_PUBLIC_DEFAULT_LOCALE="vi"

package/templates/next-base/PROJECT_STRUCTURE.md

@@ -17,6 +17,7 @@ Generated by NexTCLI. Folders marked **(module)** appear only when that add-on i
 | ------------- | --------------------------------------- |
 | `layout.tsx`  | Root layout, metadata from `branding`   |
 | `page.tsx`    | Welcome landing page                    |
+| `blog-demo/`  | Rich text create/edit/read demo         |
 | `globals.css` | Design tokens (`nextcli:theme` markers) |
 
 ## `src/config/`
@@ -27,27 +28,37 @@ Generated by NexTCLI. Folders marked **(module)** appear only when that add-on i
 
 ## `src/components/`
 
-| Path                | Purpose                 |
-| ------------------- | ----------------------- |
-| `branding/logo.tsx` | Logo + project name     |
-| `ui/`               | shadcn-style primitives |
-| `providers/`        | Theme provider          |
+| Path                | Purpose                                 |
+| ------------------- | --------------------------------------- |
+| `branding/logo.tsx` | Logo + project name                     |
+| `rich-text/`        | Lexical editor adapters, renderer, demo |
+| `ui/`               | shadcn-style primitives                 |
+| `providers/`        | Theme provider                          |
+
+## `src/lib/rich-text/` (base)
+
+| Path                       | Purpose                                              |
+| -------------------------- | ---------------------------------------------------- |
+| `image-urls.ts`            | Extract image URLs from Lexical JSON                 |
+| `supabase-url.ts`          | Map Supabase public URLs to storage paths            |
+| `sync-removed-images.ts`   | Lifecycle helper for removed images                  |
+| `default-image-removal.ts` | No-op remover (swap when `supabase` module is added) |
 
 ## Optional modules (via `nextcli add module`)
 
-| Module              | Adds                                                         |
-| ------------------- | ------------------------------------------------------------ |
-| `database`          | Prisma schema, client, `DATABASE_URL`, db scripts            |
-| `supabase`          | Supabase browser client + Storage helpers                    |
-| `auth`              | Better Auth, sign-in pages, user APIs, bootstrap admin       |
-| `api`               | Axios client, API envelope helpers, React Query provider     |
-| `i18n`              | next-intl config, messages, locale switcher                  |
-| `dashboard`         | Protected dashboard shell, sidebar, data-table UI            |
-| `example`           | Starter CRUD demo feature + `Example` Prisma model           |
-| `chat`              | Chat routes, hooks, Prisma chat models (+ auto deps)         |
-| `supabase-realtime` | Realtime channel helpers (+ auto `supabase`)                 |
-| `seo`               | robots/sitemap/JSON-LD helpers                               |
-| `email`             | `src/lib/email/*`, `src/emails/*` (provider: SMTP or Resend) |
+| Module              | Adds                                                                  |
+| ------------------- | --------------------------------------------------------------------- |
+| `database`          | Prisma schema, client, `DATABASE_URL`, db scripts                     |
+| `supabase`          | Supabase browser client + Storage helpers + `rich-text-image-sync.ts` |
+| `auth`              | Better Auth, sign-in pages, user APIs, bootstrap admin                |
+| `api`               | Axios client, API envelope helpers, React Query provider              |
+| `i18n`              | next-intl config, messages, locale switcher                           |
+| `dashboard`         | Protected dashboard shell, sidebar, data-table UI                     |
+| `example`           | Starter CRUD demo feature + `Example` Prisma model                    |
+| `chat`              | Chat routes, hooks, Prisma chat models (+ auto deps)                  |
+| `supabase-realtime` | Realtime channel helpers (+ auto `supabase`)                          |
+| `seo`               | robots/sitemap/JSON-LD helpers                                        |
+| `email`             | `src/lib/email/*`, `src/emails/*` (provider: SMTP or Resend)          |
 
 Module **env variables** and where to find them: see `SETUP.md` → **Optional module environment**.
 

package/templates/next-base/SETUP.md

@@ -2,16 +2,18 @@
 
 Quick reference for env vars and branding after `nextcli create`.
 
-## Minimal base project
+## Default stack
 
-The default template ships a lightweight Next.js shell with branding, theme, and UI primitives only. No database, auth, or dashboard code is included until you select modules at create time or run `nextcli add module`.
+The base template ships with database (Prisma + Postgres), Supabase client + Storage, Better Auth + RBAC, API client (Axios + React Query), i18n (next-intl), dashboard shell, and an example CRUD demo. Optional modules (`chat`, `supabase-realtime`, `seo`, `email`) can be added at create time or via `nextcli add module`.
 
 ## First run
 
-1. `bun run dev` (or your package manager equivalent)
-2. Open `http://localhost:3000`
+1. Fill env keys in `.env` (see tables below).
+2. `bun run db:migrate` (or your package manager equivalent)
+3. `bun run dev`
+4. Open `http://localhost:3000` (redirects to `/dashboard`)
 
-When you add the `database` module, run `bun run db:migrate` before relying on Prisma models.
+Bootstrap seeds `admin` / `admin1234` on first dev start.
 
 ## Branding (edit in repo, not env)
 
@@ -29,21 +31,71 @@ Set in `.env` / `.env.development`.
 | --------------------- | ---------------------- | ------------------------------------- |
 | `NEXT_PUBLIC_APP_URL` | Client-visible app URL | Your public site URL (e.g. localhost) |
 
-## Optional module environment
-
-Reference for all optional modules. Matching keys are merged into `.env` when selected at `nextcli create` or via `nextcli add module`.
+## Base module environment
 
 <!-- nextcli:enabled-modules:start -->
 
-**Enabled modules:** none
+**Enabled modules:** `database`, `supabase`, `auth`, `api`, `i18n`, `dashboard`, `example`
 
 <!-- nextcli:enabled-modules:end -->
 
 <!-- nextcli:module-env:start -->
 
+### Module: Database (Prisma + Postgres) (`database`)
+
+| Variable       | Where to get                                                                           |
+| -------------- | -------------------------------------------------------------------------------------- |
+| `DATABASE_URL` | Supabase Dashboard → Connect → ORMs → Prisma → pooled URL (`:6543`, `?pgbouncer=true`) |
+| `DIRECT_URL`   | Supabase Dashboard → Connect → direct/session URL (`:5432`)                            |
+
+Run `bun run db:migrate` after setting `DATABASE_URL`.
+
+### Module: Supabase client + Storage (`supabase`)
+
+| Variable                              | Where to get                                              |
+| ------------------------------------- | --------------------------------------------------------- |
+| `NEXT_PUBLIC_SUPABASE_URL`            | Supabase Dashboard → Project Settings → API → Project URL |
+| `NEXT_PUBLIC_SUPABASE_ANON_KEY`       | Same page → `anon` `public` key                           |
+| `NEXT_PUBLIC_SUPABASE_STORAGE_BUCKET` | Storage bucket name (default scaffold: `public`)          |
+
+Create the bucket and RLS policies in Supabase Dashboard before uploads.
+
+### Module: Auth (Better Auth + RBAC) (`auth`)
+
+| Variable             | Where to get                                   |
+| -------------------- | ---------------------------------------------- |
+| `BETTER_AUTH_SECRET` | Auto-generated on create; rotate in production |
+| `BETTER_AUTH_URL`    | Your app URL (e.g. `http://localhost:3000`)    |
+
+Requires `database` (included in base). Bootstrap seeds `admin` / `admin1234` on first dev start.
+
+### Module: API client (Axios + React Query) (`api`)
+
+No extra env keys. Use `publicApi` / `protectedApi` from `src/lib/api/axios.ts` and `ok` / `fail` from `src/lib/api/response.ts`.
+
+### Module: Internationalization (next-intl) (`i18n`)
+
+| Variable                     | Where to get                         |
+| ---------------------------- | ------------------------------------ |
+| `NEXT_PUBLIC_DEFAULT_LOCALE` | Default locale code (scaffold: `vi`) |
+
+Add more locales with `nextcli add language`.
+
+### Module: Dashboard shell (`dashboard`)
+
+Requires `auth`, `api`, and `i18n` (included in base). Protected routes redirect unauthenticated users to `/sign-in`.
+
+### Module: Example CRUD demo (`example`)
+
+Requires `dashboard` and `database` (included in base). Includes demo `Example` model in `prisma/schema.prisma` — run `db:migrate` after create.
+
 <!-- nextcli:module-env:end -->
 
-## After adding modules
+## Optional module environment
+
+Additional keys are merged when optional modules are selected at `nextcli create` or via `nextcli add module`.
+
+## After adding optional modules
 
 1. Fill new env keys in `.env` and `.env.example`.
 2. Run `bun run db:migrate` when a module adds Prisma models.