@kardoe/quickback 0.5.13 → 0.5.14

package/dist/index.js

@@ -10,7 +10,7 @@
  */
 import pc from "picocolors";
 // Version injected at build time by scripts/inject-version.ts
-const CLI_VERSION = "0.5.13";
+const CLI_VERSION = "0.5.14";
 function getPackageVersion() {
     return CLI_VERSION;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kardoe/quickback",
-  "version": "0.5.13",
+  "version": "0.5.14",
   "description": "CLI for Quickback - one-shot backend generator",
   "author": "Paul Stenhouse",
   "license": "MIT",

package/src/skill/SKILL.md

@@ -147,6 +147,15 @@ export default defineTable(todos, {
   masking: {
     userId: { type: "redact", show: { roles: ["admin"] } },
   },
+
+  layouts: {
+    default: {
+      sections: [
+        { label: "Details", columns: 2, fields: ["title", "completed"] },
+        { label: "Audit", collapsed: true, fields: ["userId"] },
+      ],
+    },
+  },
 });
 ```
 
@@ -378,6 +387,44 @@ export default defineTable(rooms, {
 
 ---
 
+# CMS Record Layouts
+
+Control how fields are grouped on the CMS record detail page. Without layouts, fields are auto-grouped by naming heuristics.
+
+```typescript
+export default defineTable(contacts, {
+  // ... firewall, crud, guards, etc.
+
+  layouts: {
+    default: {
+      sections: [
+        { label: "Contact Info", columns: 2, fields: ["name", "email", "phone", "mobile"] },
+        { label: "Address", columns: 2, fields: ["address1", "address2", "city", "state", "zip"] },
+        { label: "Internal Notes", collapsed: true, fields: ["notes", "internalNotes"] },
+      ],
+    },
+    compact: {
+      sections: [
+        { label: "Summary", fields: ["name", "status", "email"] },
+      ],
+    },
+  },
+});
+```
+
+### Section Options
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `label` | string | required | Section header text |
+| `fields` | string[] | required | Column names to display |
+| `columns` | `1 \| 2` | `1` | Number of columns for field layout |
+| `collapsed` | boolean | `false` | Whether the section starts collapsed |
+
+Fields not assigned to any section are collected into an "Other Fields" section. When multiple layouts are defined, a dropdown appears in the CMS record detail header.
+
+---
+
 # Actions — Custom Business Logic
 
 Actions are custom API endpoints for business logic beyond CRUD. Defined in a separate `actions.ts` file using `defineActions()`.
@@ -726,18 +773,34 @@ Detect from `quickback.config.ts` and use the correct imports:
 
 # Documentation
 
+## CLI Docs (Recommended)
+
+The fastest way to access documentation is via the Quickback CLI. It bundles all docs offline:
+
+```bash
+quickback docs                    # List all available topics
+quickback docs <topic>            # Show docs for a specific topic
+quickback docs firewall           # Example: firewall docs
+quickback docs cms/record-layouts # Example: CMS record layouts
+```
+
+## Online Docs
+
 Full documentation at https://docs.quickback.dev
 
-- [Quick Start](https://docs.quickback.dev/definitions/quick-start)
-- [Concepts](https://docs.quickback.dev/definitions/concepts)
-- [Database Schema](https://docs.quickback.dev/definitions/database-schema)
-- [CRUD Endpoints](https://docs.quickback.dev/definitions/crud-endpoints)
-- [Views](https://docs.quickback.dev/definitions/views)
-- [Actions](https://docs.quickback.dev/definitions/actions)
-- [Firewall](https://docs.quickback.dev/definitions/firewall)
-- [Access](https://docs.quickback.dev/definitions/access)
-- [Guards](https://docs.quickback.dev/definitions/guards)
-- [Masking](https://docs.quickback.dev/definitions/masking)
-- [CLI Reference](https://docs.quickback.dev/compiler/cli)
-- [Cloudflare Stack](https://docs.quickback.dev/stack/cloudflare)
-- [Quick Reference](https://docs.quickback.dev/stack/reference)
+- [Getting Started](https://docs.quickback.dev/compiler/getting-started)
+- [Concepts](https://docs.quickback.dev/compiler/definitions/concepts)
+- [Database Schema](https://docs.quickback.dev/compiler/definitions/schema)
+- [Firewall](https://docs.quickback.dev/compiler/definitions/firewall)
+- [Access](https://docs.quickback.dev/compiler/definitions/access)
+- [Guards](https://docs.quickback.dev/compiler/definitions/guards)
+- [Masking](https://docs.quickback.dev/compiler/definitions/masking)
+- [Views](https://docs.quickback.dev/compiler/definitions/views)
+- [Validation](https://docs.quickback.dev/compiler/definitions/validation)
+- [Actions](https://docs.quickback.dev/compiler/definitions/actions)
+- [CRUD API](https://docs.quickback.dev/compiler/using-the-api/crud)
+- [Query Parameters](https://docs.quickback.dev/compiler/using-the-api/query-params)
+- [CLI Reference](https://docs.quickback.dev/compiler/cloud-compiler/cli)
+- [CMS Overview](https://docs.quickback.dev/cms)
+- [CMS Record Layouts](https://docs.quickback.dev/cms/record-layouts)
+- [CMS Schema Format](https://docs.quickback.dev/cms/schema-format)

package/src/skill/agents/quickback-specialist/AGENT.md

@@ -19,6 +19,7 @@ You deeply understand:
 - **Actions**: Custom endpoints using `defineActions()` with Zod schemas
 - **Views**: Column-level security with named projections
 - **Validation**: Field-level validation rules
+- **Layouts**: CMS record page field grouping with sections, columns, and collapsed state
 
 ## When Invoked
 
@@ -193,10 +194,24 @@ Before finishing, verify:
 - [ ] Masking for any PII fields
 - [ ] Views for different visibility levels (if needed)
 - [ ] Validation rules for constrained fields (if needed)
+- [ ] Layouts for CMS record page field grouping (if needed)
 - [ ] No audit fields in schema (auto-injected)
 - [ ] Using `defineTable()` combined mode (not separate schema.ts + resource.ts)
 - [ ] Actions use `defineActions()` with Zod schemas (not JSON schema)
 
+## Accessing Documentation
+
+When you need to look up Quickback docs, use the CLI — it bundles all docs offline:
+
+```bash
+quickback docs                    # List all available topics
+quickback docs <topic>            # Show docs for a specific topic
+quickback docs firewall           # Example: firewall docs
+quickback docs cms/record-layouts # Example: CMS record layouts
+```
+
+Full online docs: https://docs.quickback.dev
+
 ## Response Style
 
 - Be direct and practical