@questpie/admin 0.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1,108 @@
+
+$ tsdown
+ℹ tsdown v0.18.4 powered by rolldown v1.0.0-beta.57
+ℹ config file: /Users/drepkovsky/questpie/repos/questpie-cms/packages/admin/tsdown.config.ts 
+(node:61237) ExperimentalWarning: Type Stripping is an experimental feature and might change at any time
+(Use `node --trace-warnings ...` to show where the warning was created)
+ℹ entry: src/__tests__/setup.ts, src/__tests__/test-utils.tsx, src/__tests__/vitest.d.ts, src/components/admin-app.tsx, src/components/index.ts, src/config/component-registry.ts, src/config/index.ts, src/hooks/admin-provider.tsx, src/hooks/index.ts, src/hooks/store.ts, src/hooks/use-auth.ts, src/hooks/use-collection-db.ts, src/hooks/use-collection.ts, src/hooks/use-global.ts, src/hooks/use-mobile.ts, src/lib/utils.ts, src/styles/index.css, src/utils/index.ts, src/views/index.ts, src/components/primitives/checkbox-input.tsx, src/components/primitives/date-input.tsx, src/components/primitives/index.ts, src/components/primitives/number-input.tsx, src/components/primitives/select-input.tsx, src/components/primitives/tag-input.tsx, src/components/primitives/text-input.tsx, src/components/primitives/textarea-input.tsx, src/components/primitives/toggle-input.tsx, src/components/primitives/types.ts, src/components/fields/array-field.tsx, src/components/fields/checkbox-field.tsx, src/components/fields/custom-field.tsx, src/components/fields/date-field.tsx, src/components/fields/datetime-field.tsx, src/components/fields/email-field.tsx, src/components/fields/embedded-collection.tsx, src/components/fields/field-types.ts, src/components/fields/field-utils.ts, src/components/fields/field-wrapper.tsx, src/components/fields/index.ts, src/components/fields/json-field.tsx, src/components/fields/locale-badge.tsx, src/components/fields/number-field.tsx, src/components/fields/password-field.tsx, src/components/fields/relation-field.tsx, src/components/fields/relation-picker.tsx, src/components/fields/relation-select.tsx, src/components/fields/select-field.tsx, src/components/fields/switch-field.tsx, src/components/fields/text-field.tsx, src/components/fields/textarea-field.tsx, src/views/collection/auto-form-fields.tsx, src/views/collection/collection-form.tsx, src/views/collection/collection-list.tsx, src/views/collection/form-field.tsx, src/views/collection/index.ts, src/views/auth/auth-layout.tsx, src/views/auth/forgot-password-form.tsx, src/views/auth/index.ts, src/views/auth/login-form.tsx, src/views/auth/reset-password-form.tsx, src/views/common/index.ts, src/views/common/locale-switcher.tsx, src/views/common/version-history.tsx, src/components/ui/accordion.tsx, src/components/ui/avatar.tsx, src/components/ui/badge.tsx, src/components/ui/button.tsx, src/components/ui/card.tsx, src/components/ui/checkbox.tsx, src/components/ui/combobox.tsx, src/components/ui/dialog.tsx, src/components/ui/dropdown-menu.tsx, src/components/ui/field.tsx, src/components/ui/input-group.tsx, src/components/ui/input.tsx, src/components/ui/label.tsx, src/components/ui/popover.tsx, src/components/ui/scroll-area.tsx, src/components/ui/select.tsx, src/components/ui/separator.tsx, src/components/ui/sheet.tsx, src/components/ui/sidebar.tsx, src/components/ui/skeleton.tsx, src/components/ui/spinner.tsx, src/components/ui/switch.tsx, src/components/ui/table.tsx, src/components/ui/tabs.tsx, src/components/ui/textarea.tsx, src/components/ui/tooltip.tsx, src/views/layout/admin-layout.tsx, src/views/layout/admin-router.tsx, src/views/layout/admin-sidebar.tsx, src/views/layout/index.ts, src/components/fields/rich-text-editor/index.tsx
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 112 files
+ℹ dist/components/fields/rich-text-editor/index.mjs  32.38 kB │ gzip: 6.23 kB
+ℹ dist/views/collection/auto-form-fields.mjs         18.78 kB │ gzip: 4.56 kB
+ℹ dist/components/ui/sidebar.mjs                     17.89 kB │ gzip: 4.09 kB
+ℹ dist/components/primitives/date-input.mjs          11.73 kB │ gzip: 2.15 kB
+ℹ dist/views/common/version-history.mjs              10.21 kB │ gzip: 2.58 kB
+ℹ dist/components/fields/embedded-collection.mjs      9.04 kB │ gzip: 2.29 kB
+ℹ dist/components/fields/relation-picker.mjs          8.36 kB │ gzip: 2.41 kB
+ℹ dist/components/ui/combobox.mjs                     7.92 kB │ gzip: 2.10 kB
+ℹ dist/components/ui/dropdown-menu.mjs                7.41 kB │ gzip: 1.52 kB
+ℹ dist/components/fields/json-field.mjs               7.19 kB │ gzip: 2.27 kB
+ℹ dist/components/fields/relation-select.mjs          6.70 kB │ gzip: 1.98 kB
+ℹ dist/components/fields/array-field.mjs              6.24 kB │ gzip: 1.86 kB
+ℹ dist/components/primitives/select-input.mjs         6.22 kB │ gzip: 1.99 kB
+ℹ dist/views/auth/reset-password-form.mjs             6.08 kB │ gzip: 1.85 kB
+ℹ dist/components/ui/select.mjs                       5.58 kB │ gzip: 1.61 kB
+ℹ dist/views/auth/login-form.mjs                      5.19 kB │ gzip: 1.65 kB
+ℹ dist/components/ui/field.mjs                        5.17 kB │ gzip: 1.49 kB
+ℹ dist/views/auth/forgot-password-form.mjs            4.78 kB │ gzip: 1.66 kB
+ℹ dist/components/primitives/tag-input.mjs            4.71 kB │ gzip: 1.76 kB
+ℹ dist/components/ui/input-group.mjs                  4.59 kB │ gzip: 1.40 kB
+ℹ dist/hooks/store.mjs                                4.45 kB │ gzip: 1.40 kB
+ℹ dist/components/ui/sheet.mjs                        3.98 kB │ gzip: 1.08 kB
+ℹ dist/components/primitives/checkbox-input.mjs       3.80 kB │ gzip: 1.10 kB
+ℹ dist/hooks/use-collection-db.mjs                    3.80 kB │ gzip: 1.15 kB
+ℹ dist/views/collection/collection-list.mjs           3.60 kB │ gzip: 1.33 kB
+ℹ dist/components/ui/dialog.mjs                       3.50 kB │ gzip: 1.02 kB
+ℹ dist/views/layout/admin-router.mjs                  3.42 kB │ gzip: 1.16 kB
+ℹ dist/components/ui/tabs.mjs                         3.22 kB │ gzip: 1.05 kB
+ℹ dist/hooks/use-collection.mjs                       2.98 kB │ gzip: 0.63 kB
+ℹ dist/views/collection/collection-form.mjs           2.94 kB │ gzip: 1.19 kB
+ℹ dist/components/ui/button.mjs                       2.90 kB │ gzip: 0.98 kB
+ℹ dist/components/fields/relation-field.mjs           2.75 kB │ gzip: 0.98 kB
+ℹ dist/config/index.mjs                               2.75 kB │ gzip: 0.89 kB
+ℹ dist/views/layout/admin-sidebar.mjs                 2.73 kB │ gzip: 1.00 kB
+ℹ dist/components/ui/avatar.mjs                       2.68 kB │ gzip: 0.79 kB
+ℹ dist/components/primitives/number-input.mjs         2.64 kB │ gzip: 0.98 kB
+ℹ dist/components/ui/accordion.mjs                    2.44 kB │ gzip: 0.85 kB
+ℹ dist/hooks/use-auth.mjs                             2.34 kB │ gzip: 0.94 kB
+ℹ dist/components/ui/card.mjs                         2.26 kB │ gzip: 0.69 kB
+ℹ dist/hooks/admin-provider.mjs                       2.16 kB │ gzip: 0.84 kB
+ℹ dist/components/ui/tooltip.mjs                      2.16 kB │ gzip: 0.78 kB
+ℹ dist/components/admin-app.mjs                       2.15 kB │ gzip: 0.93 kB
+ℹ dist/components/ui/popover.mjs                      2.10 kB │ gzip: 0.71 kB
+ℹ dist/components/ui/table.mjs                        2.09 kB │ gzip: 0.63 kB
+ℹ dist/views/collection/form-field.mjs                1.93 kB │ gzip: 0.52 kB
+ℹ dist/components/ui/badge.mjs                        1.77 kB │ gzip: 0.78 kB
+ℹ dist/components/ui/switch.mjs                       1.70 kB │ gzip: 0.69 kB
+ℹ dist/views/auth/auth-layout.mjs                     1.60 kB │ gzip: 0.69 kB
+ℹ dist/components/ui/scroll-area.mjs                  1.52 kB │ gzip: 0.60 kB
+ℹ dist/views/layout/admin-layout.mjs                  1.38 kB │ gzip: 0.54 kB
+ℹ dist/views/common/locale-switcher.mjs               1.37 kB │ gzip: 0.62 kB
+ℹ dist/components/ui/checkbox.mjs                     1.36 kB │ gzip: 0.63 kB
+ℹ dist/components/fields/index.mjs                    1.33 kB │ gzip: 0.38 kB
+ℹ dist/components/fields/field-wrapper.mjs            1.24 kB │ gzip: 0.53 kB
+ℹ dist/components/fields/datetime-field.mjs           1.21 kB │ gzip: 0.55 kB
+ℹ dist/hooks/use-global.mjs                           1.18 kB │ gzip: 0.49 kB
+ℹ dist/components/fields/date-field.mjs               1.16 kB │ gzip: 0.54 kB
+ℹ dist/components/fields/select-field.mjs             1.16 kB │ gzip: 0.54 kB
+ℹ dist/components/fields/textarea-field.mjs           1.05 kB │ gzip: 0.50 kB
+ℹ dist/components/fields/number-field.mjs             1.04 kB │ gzip: 0.50 kB
+ℹ dist/components/fields/text-field.mjs               1.04 kB │ gzip: 0.50 kB
+ℹ dist/components/fields/password-field.mjs           1.03 kB │ gzip: 0.50 kB
+ℹ dist/__tests__/test-utils.mjs                       1.02 kB │ gzip: 0.50 kB
+ℹ dist/components/ui/input.mjs                        1.01 kB │ gzip: 0.52 kB
+ℹ dist/components/fields/email-field.mjs              1.00 kB │ gzip: 0.49 kB
+ℹ dist/components/fields/checkbox-field.mjs           0.95 kB │ gzip: 0.45 kB
+ℹ dist/components/fields/switch-field.mjs             0.93 kB │ gzip: 0.46 kB
+ℹ dist/__tests__/setup.mjs                            0.90 kB │ gzip: 0.43 kB
+ℹ dist/components/index.mjs                           0.89 kB │ gzip: 0.24 kB
+ℹ dist/components/primitives/text-input.mjs           0.89 kB │ gzip: 0.50 kB
+ℹ dist/components/ui/textarea.mjs                     0.84 kB │ gzip: 0.46 kB
+ℹ dist/components/fields/custom-field.mjs             0.83 kB │ gzip: 0.40 kB
+ℹ dist/hooks/index.mjs                                0.83 kB │ gzip: 0.24 kB
+ℹ dist/components/primitives/textarea-input.mjs       0.81 kB │ gzip: 0.45 kB
+ℹ dist/config/component-registry.mjs                  0.78 kB │ gzip: 0.34 kB
+ℹ dist/components/primitives/toggle-input.mjs         0.64 kB │ gzip: 0.38 kB
+ℹ dist/components/primitives/index.mjs                0.61 kB │ gzip: 0.21 kB
+ℹ dist/components/ui/separator.mjs                    0.60 kB │ gzip: 0.33 kB
+ℹ dist/hooks/use-mobile.mjs                           0.60 kB │ gzip: 0.34 kB
+ℹ dist/components/ui/label.mjs                        0.54 kB │ gzip: 0.34 kB
+ℹ dist/components/ui/spinner.mjs                      0.41 kB │ gzip: 0.28 kB
+ℹ dist/components/fields/locale-badge.mjs             0.38 kB │ gzip: 0.27 kB
+ℹ dist/components/ui/skeleton.mjs                     0.35 kB │ gzip: 0.25 kB
+ℹ dist/components/primitives/types.mjs                0.34 kB │ gzip: 0.21 kB
+ℹ dist/views/auth/index.mjs                           0.28 kB │ gzip: 0.14 kB
+ℹ dist/views/collection/index.mjs                     0.27 kB │ gzip: 0.13 kB
+ℹ dist/components/fields/field-utils.mjs              0.25 kB │ gzip: 0.18 kB
+ℹ dist/views/layout/index.mjs                         0.19 kB │ gzip: 0.10 kB
+ℹ dist/lib/utils.mjs                                  0.18 kB │ gzip: 0.15 kB
+ℹ dist/views/common/index.mjs                         0.15 kB │ gzip: 0.10 kB
+ℹ dist/utils/index.mjs                                0.14 kB │ gzip: 0.13 kB
+ℹ dist/views/index.mjs                                0.12 kB │ gzip: 0.08 kB
+ℹ dist/__tests__/vitest.d.mjs                         0.03 kB │ gzip: 0.05 kB
+ℹ dist/components/fields/field-types.mjs              0.01 kB │ gzip: 0.03 kB
+ℹ dist/styles/index.mjs                               0.01 kB │ gzip: 0.03 kB
+ℹ dist/styles/index.css                               8.31 kB │ gzip: 1.92 kB
+ℹ 96 files, total: 306.19 kB
+✔ Build complete in 128ms

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# @questpie/admin
+
+## 0.0.1
+
+### Patch Changes
+
+- feat: initial release
+- Updated dependencies
+  - @questpie/tanstack-query@0.0.1
+  - questpie@0.0.1

package/README.md

@@ -0,0 +1,556 @@
+# @questpie/admin
+
+**Config-driven, batteries-included admin UI for QUESTPIE CMS**
+
+A fully-featured admin interface that auto-generates from your CMS schema with extensive customization options.
+
+## Features
+
+- **Zero Config** - Works out of the box with just a CMS client
+- **Config-Driven** - Customize everything via `defineAdminConfig`
+- **Type-Safe** - Full TypeScript inference from your CMS schema
+- **Tailwind v4** - Built with Tailwind CSS v4 + shadcn/ui components
+- **Rich Text** - Tiptap editor with slash commands, tables, images
+- **Relations** - Inline, picker, and create modes for related content
+- **Layouts** - Sections, tabs, columns, grids, sidebars
+- **Realtime** - SSE-powered live updates
+- **Versioning** - Built-in version history and audit logging
+- **i18n Ready** - Localization support for content
+
+## Installation
+
+```bash
+bun add @questpie/admin @questpie/cms @questpie/tanstack-query
+bun add @tanstack/react-query @tanstack/react-table
+```
+
+## Quick Start
+
+### Minimal Setup (One Component!)
+
+```tsx
+import { AdminApp } from "@questpie/admin";
+import { cmsClient } from "./lib/cms-client";
+import {
+  Link,
+  useLocation,
+  useNavigate,
+  useParams,
+} from "@tanstack/react-router";
+
+function App() {
+  const location = useLocation();
+  const navigate = useNavigate();
+  const params = useParams();
+  const segments = params._.split("/").filter(Boolean);
+
+  return (
+    <AdminApp
+      client={cmsClient} // That's it! Everything else is auto-generated
+      router={{
+        LinkComponent: Link,
+        currentPath: location.pathname,
+        segments,
+        navigate,
+      }}
+    />
+  );
+}
+```
+
+### With Custom Config
+
+```tsx
+import { AdminApp } from '@questpie/admin'
+import { cmsClient } from './lib/cms-client'
+import { adminConfig } from './configs/admin'
+
+function App() {
+  return (
+    <AdminApp
+      client={cmsClient}
+      config={adminConfig}  // Optional customization
+      router={{ ... }}
+    />
+  )
+}
+```
+
+## 🎨 Configuration
+
+Most UI is auto-generated from CMS collections. Field types and relation targets must be explicit in admin config.
+
+```typescript
+import { defineAdminConfig } from "@questpie/admin/config";
+import type { AppCMS } from "./server/cms";
+
+export const adminConfig = defineAdminConfig<AppCMS>()({
+  app: {
+    brand: { name: "My Admin" },
+  },
+  collections: {
+    posts: {
+      label: "Blog Posts", // Override label
+
+      // List view
+      list: {
+        defaultColumns: ["title", "author", "publishedAt"],
+        defaultSort: { field: "publishedAt", direction: "desc" },
+        with: ["author"], // Auto-load relations
+      },
+
+      // Edit form
+      edit: {
+        // Optional: explicit order (recommended)
+        fields: ["title", "content", "status", "publishedAt"],
+
+        // Organize into sections
+        sections: [
+          {
+            title: "Content",
+            fields: ["title", "content"],
+          },
+          {
+            title: "Publishing",
+            fields: ["status", "publishedAt"],
+          },
+        ],
+      },
+
+      // Field-level overrides
+      fields: {
+        title: {
+          label: "Post Title",
+          required: true,
+        },
+        content: {
+          type: "richText", // Custom field type
+          placeholder: "Write your post...",
+        },
+        status: {
+          type: "select",
+          options: [
+            { label: "Draft", value: "draft" },
+            { label: "Published", value: "published" },
+          ],
+        },
+        publishedAt: {
+          label: "Publish Date",
+          type: "datetime",
+          // Conditional: readonly unless draft
+          readOnly: (values) => values.status !== "draft",
+        },
+      },
+    },
+  },
+});
+```
+
+## ✨ What's Automatic
+
+### From CMS Schema
+
+- 🚫 Schema introspection (field types, required, defaults, relations) - not planned (explicit config)
+
+### From Admin Config
+
+- ✅ **Sidebar navigation** - auto-generated from collections
+- ✅ **Routing** - `/admin/:collection/:id` patterns
+- ✅ **List views** - columns, sorting, filtering
+- ✅ **Form views** - create/edit with validation
+- ✅ **Realtime sync** - SSE enabled by default
+- ✅ **Relations loading** - auto-load with `with` config
+
+## 🎯 Features
+
+### Conditional Fields
+
+```typescript
+fields: {
+  status: {
+    type: "select",
+    options: [...]
+  },
+
+  // Show only when status is "cancelled"
+  cancellationReason: {
+    type: "textarea",
+    visible: (values) => values.status === "cancelled",
+    required: (values) => values.status === "cancelled"
+  },
+
+  // Readonly unless draft
+  publishedAt: {
+    readOnly: (values) => values.status !== "draft"
+  },
+
+  // Dynamic options based on other fields
+  category: {
+    type: "select",
+    options: (values) => {
+      if (values.type === "tech") {
+        return [{ label: "Frontend", value: "frontend" }, ...]
+      }
+      return [{ label: "Design", value: "design" }, ...]
+    }
+  }
+}
+```
+
+### Sections & Organization
+
+```typescript
+edit: {
+  sections: [
+    {
+      title: "Basic Info",
+      description: "Main appointment details",
+      fields: ["customer", "barber", "service", "scheduledAt"],
+      collapsible: true,
+      defaultOpen: true,
+    },
+    {
+      title: "Status",
+      fields: ["status", "notes"],
+    },
+  ];
+}
+```
+
+### Advanced Layouts
+
+Columns, grids, and inline layouts are supported:
+
+```typescript
+edit: {
+  sections: [
+    {
+      title: "Basic",
+      layout: "columns",
+      columns: 2,
+      fields: ["title", "slug", "author", "category"],
+    },
+    {
+      title: "Pricing",
+      layout: "grid",
+      grid: { columns: 4, gap: 4 },
+      fields: [
+        { field: "price", span: 1 },
+        { field: "currency", span: 1 },
+        { field: "stock", span: 2 },
+      ],
+    },
+    {
+      title: "Dates",
+      layout: "inline",
+      fields: ["startDate", "endDate"],
+    },
+  ];
+}
+```
+
+Sidebar layouts:
+
+```typescript
+edit: {
+  layout: "with-sidebar",
+  sections: [
+    { title: "Content", fields: ["title", "content"] }
+  ],
+  sidebar: {
+    position: "right",
+    width: "320px",
+    fields: ["status", "publishedAt"]
+  }
+}
+```
+
+### Tabs
+
+```typescript
+edit: {
+  tabs: [
+    {
+      id: "content",
+      label: "Content",
+      fields: ["title", "content"],
+    },
+    {
+      id: "meta",
+      label: "Metadata",
+      fields: ["seo", "tags", "category"],
+    },
+  ];
+}
+```
+
+### Localization (i18n)
+
+```typescript
+app: {
+  locales: {
+    default: "en",
+    available: ["en", "sk", "de"]
+  }
+},
+collections: {
+  posts: {
+    fields: {
+      title: { type: "text", localized: true },
+      content: { type: "richText", localized: true }
+    }
+  }
+}
+```
+
+### Relation Fields
+
+Automatic relation field support with create/edit capabilities:
+
+Display label uses the target record’s `_title`.
+
+```typescript
+fields: {
+  // Single relation (one-to-one) - explicit config
+  barberId: {
+    label: "Barber",
+    relation: {
+      targetCollection: "barbers",  // Required target collection
+      mode: "inline"                // or "picker" or "create"
+    }
+  },
+
+  // Multiple relations (one-to-many, many-to-many)
+  tags: {
+    relation: {
+      targetCollection: "tags",
+      mode: "picker",              // Enables multi-select
+      orderable: true,             // Enable drag-and-drop reordering
+
+      // Filter options based on current form values
+      filter: (values) => ({
+        where: { type: { eq: values.postType } }
+      })
+    }
+  }
+}
+```
+
+**Features:**
+
+- ✅ **Plus button** - Create new related item (opens side sheet)
+- ✅ **Edit button** - Modify selected item (opens side sheet)
+- ✅ **Auto-complete** - Search and filter options
+- ✅ **Drag-and-drop** - Reorder multiple relations (when `orderable: true`)
+- ✅ **Conditional filtering** - Filter options based on form state
+
+### Rich Text Editor (Tiptap)
+
+Built-in rich text editing with toolbar controls:
+
+```typescript
+fields: {
+  content: {
+    type: "richText",
+    placeholder: "Start writing...",
+    richText: {
+      outputFormat: "html", // "json" (default) or "markdown"
+      enableImages: true,
+      showCharacterCount: true,
+      maxCharacters: 10000,
+      features: {
+        slashCommands: true,
+        tableControls: true,
+        bubbleMenu: true
+      },
+      onImageUpload: async (file) => {
+        // Return a public URL after upload
+        return await uploadImage(file)
+      }
+    }
+  }
+}
+```
+
+Note: Markdown output requires a Markdown extension in the `extensions` array.
+Slash commands, table tools, and the bubble menu can be toggled via `features`.
+
+### Embedded Collections
+
+```typescript
+fields: {
+  gallery: {
+    embedded: {
+      collection: "post_images",
+      orderable: true,  // Drag-and-drop reordering
+      mode: "inline",   // or "modal" or "drawer"
+      rowLabel: (item) => item.caption || item.id
+    }
+  }
+}
+```
+
+### Array Fields
+
+```typescript
+fields: {
+  tags: {
+    type: "array",
+    label: "Tags",
+    array: {
+      itemType: "text",
+      orderable: true,
+      maxItems: 10
+    }
+  },
+
+  ratings: {
+    type: "array",
+    label: "Ratings",
+    array: {
+      itemType: "number",
+      minItems: 1
+    }
+  }
+}
+```
+
+### Version History & Audit Logging
+
+Track all changes to collection items with built-in versioning:
+
+```typescript
+collections: {
+  posts: {
+    // Enable versioning for this collection
+    versioned: true,
+
+    // Configure audit logging
+    auditLog: {
+      fields: ["title", "content", "status"],  // Fields to track
+      trackUser: true,                         // Track who made changes
+      retentionDays: 365                       // Keep logs for 1 year
+    },
+
+    edit: {
+      // Show version history in edit form
+      showVersionHistory: true
+    }
+  }
+}
+```
+
+**Features:**
+
+- ✅ **Version tracking** - Every change creates a new version
+- ✅ **Change history** - See what changed, when, and by whom
+- ✅ **Diff view** - Compare old vs new values
+- ✅ **Restore versions** - Roll back to previous versions
+- ✅ **User tracking** - Know who made each change
+- ✅ **Configurable retention** - Control how long to keep history
+
+### Tree Views (Coming Soon)
+
+```typescript
+list: {
+  view: "tree",  // Enable tree view
+  tree: {
+    parentField: "parentId",
+    labelField: "name",
+    collapsible: true
+  }
+}
+```
+
+## 🧩 Component Registry
+
+Override default field components:
+
+```typescript
+import { RichTextEditor } from './components/RichTextEditor'
+import { ImagePicker } from './components/ImagePicker'
+
+<AdminApp
+  client={cmsClient}
+  config={adminConfig}
+  registry={{
+    fields: {
+      richText: RichTextEditor,
+      image: ImagePicker
+    }
+  }}
+  router={{ ... }}
+/>
+```
+
+## 📦 Package Exports
+
+```typescript
+// Main component
+import { AdminApp } from "@questpie/admin";
+
+// Config helper
+import { defineAdminConfig } from "@questpie/admin/config";
+
+// Hooks
+import { AdminProvider, useCollection } from "@questpie/admin/hooks";
+
+// Components
+import {
+  CollectionList,
+  CollectionForm,
+  RelationSelect,
+  RelationPicker,
+  VersionHistory,
+} from "@questpie/admin/components";
+
+// Utilities
+import { cn } from "@questpie/admin/utils";
+
+// Styles
+import "@questpie/admin/styles";
+```
+
+## 🎨 Styling
+
+Complete shadcn/ui setup with Tailwind CSS v4:
+
+- 53+ pre-built components (base-lyra style)
+- Light/dark theme support
+- oklch color space
+- Customizable via Tailwind tokens
+
+## 📚 Examples
+
+See [tanstack-barbershop](../../examples/tanstack-barbershop) for complete example.
+
+## 🚀 Roadmap
+
+- [ ] Schema introspection (auto field type inference) - not planned
+- [x] Conditional visibility/readonly/disabled
+- [x] Sections organization
+- [x] Advanced layouts (columns, grid, inline, sidebar)
+- [x] Component registry
+- [x] Relation fields (RelationSelect, RelationPicker)
+- [x] Version history & audit logging
+- [x] Embedded collections (inline, modal, drawer)
+- [x] Array fields
+- [x] Tabs layout
+- [ ] Tree views (hierarchical data)
+- [ ] Bulk actions
+- [ ] Saved views/filters
+- [ ] Custom dashboard
+- [ ] Permissions UI
+
+## Related Packages
+
+- [`@questpie/cms`](../cms) - Core CMS engine
+- [`@questpie/tanstack-query`](../tanstack-query) - TanStack Query integration
+- [`@questpie/hono`](../hono) - Hono adapter
+- [`@questpie/elysia`](../elysia) - Elysia adapter
+- [`@questpie/next`](../next) - Next.js adapter
+- [`@questpie/tanstack-start`](../tanstack-start) - TanStack Start adapter
+
+## License
+
+MIT