rahman-resources 1.13.2 → 1.13.3

package/lib/slice-schema.json

@@ -171,6 +171,10 @@
               "range": {
                 "type": "string"
               },
+              "optional": {
+                "type": "boolean",
+                "description": "Peer is optional — slice degrades gracefully without it (e.g. a swappable payment provider)."
+              },
               "reason": {
                 "type": "string"
               }

package/lib/starter/_README.md

@@ -1,6 +1,6 @@
 # __APP_NAME__
 
-Scaffolded with [`rahman-resources`](https://www.npmjs.com/package/rahman-resources) — Next 16 + React 19 + Convex (self-hosted) + Tailwind 4 + shadcn/ui.
+Scaffolded with [`rahman-resources`](https://www.npmjs.com/package/rahman-resources) — Next 16 + React 19 + Convex + Tailwind 4 + shadcn/ui.
 
 ## Setup
 
@@ -11,21 +11,44 @@ npx convex dev --once                 # generates convex/_generated
 npm run dev
 ```
 
-## Add a layout / recipe / feature
+## Add a slice
+
+Browse the live showcase — the [Grand Tour](https://resource.rahmanef.com/tour) —
+where every slice is mounted live with its `add` command. Then:
 
 ```bash
 npx rahman-resources list
 npx rahman-resources info <slug>
-npx rahman-resources add personal-brand-os .   # full-app template (T1)
-npx rahman-resources add ai-sdk-openrouter .   # feature (npm install)
+npx rahman-resources add landing-sections .    # marketing sections (hero/pricing/faq/blog…)
+npx rahman-resources add ai-chat .             # AI chat workbench
+npx rahman-resources add appshell .            # windowed web-OS shell
 ```
 
+> rr is a **slice picker**: each `add` copies files into `slices/<slug>/`, which
+> you own and edit. The showcase at `/tour` is Convex-free (localStorage demo
+> adapters); your app wires the slice into your own backend.
+
+## Deploy — Vercel + Convex Cloud
+
+`vercel.json` sets `buildCommand: npm run build:auto`, which adapts to your env:
+
+| `CONVEX_DEPLOY_KEY` | What `build:auto` runs |
+|---|---|
+| **set** | `setup-auth` (one-time `@convex-dev/auth` keys) → `convex deploy --cmd 'next build'` — deploys functions to Convex Cloud, codegens `convex/_generated`, and injects `NEXT_PUBLIC_CONVEX_URL` into the build. |
+| **unset** | plain `next build` — zero-config deploy of the scaffold as-is (no backend wired yet). |
+
+So a fresh deploy is green either way: set `CONVEX_DEPLOY_KEY` in Vercel for the
+full Cloud-backed app, or leave it unset to ship the static scaffold first.
+
+> **Self-hosted (Docker/Dokploy):** commit `convex/_generated` so the container
+> typecheck/build runs without codegen — see `.gitignore`. (Vercel + Convex Cloud
+> needs no commit; `build:auto` codegens during deploy.)
+
 ## Hard rules
 
 - **NO Clerk.** Auth = `@convex-dev/auth`.
 - **shadcn primitives only** — no raw `<dialog>`, `<input type=date|file>`.
 - Use `proxy.ts` (not `middleware.ts`) on Next 16.
-- `convex/_generated` MUST be committed before deploy.
 
 ## Stack
 
@@ -33,5 +56,5 @@ npx rahman-resources add ai-sdk-openrouter .   # feature (npm install)
 |---|---|
 | Framework | Next.js 16 (App Router + cacheComponents) |
 | UI | React 19 + Tailwind 4 + shadcn |
-| Backend | Convex (self-hosted compatible) |
+| Backend | Convex (Cloud or self-hosted) |
 | Auth | `@convex-dev/auth` (Password provider by default) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rahman-resources",
-  "version": "1.13.2",
+  "version": "1.13.3",
   "description": "Rahman Resources (rr) — shadcn-style installer for vertical slices. `npx resources add <slug>` copies slice into your project's `slices/<slug>/`. You own the files.",
   "type": "module",
   "license": "MIT",