@plutocms/supabase 0.0.1-alpha.1

package/.agents/skills/nuxt-ui/references/layouts/dashboard.md

@@ -0,0 +1,220 @@
+# Dashboard Layout
+
+Build admin interfaces with resizable sidebars, multi-panel layouts, and toolbars.
+
+## Component tree
+
+```
+UApp
+└── NuxtLayout (dashboard)
+    └── UDashboardGroup
+        ├── UDashboardSidebar
+        │   ├── #header (logo, search button)
+        │   ├── #default (navigation) — receives { collapsed } slot prop
+        │   └── #footer (user menu)
+        └── NuxtPage
+            └── UDashboardPanel
+                ├── #header → UDashboardNavbar + UDashboardToolbar
+                ├── #body (scrollable content)
+                └── #footer (optional)
+```
+
+## Layout
+
+```vue [layouts/dashboard.vue]
+<script setup lang="ts">
+import type { NavigationMenuItem } from '@nuxt/ui'
+
+const items = computed<NavigationMenuItem[]>(() => [{
+  label: 'Home',
+  icon: 'i-lucide-house',
+  to: '/dashboard'
+}, {
+  label: 'Inbox',
+  icon: 'i-lucide-inbox',
+  to: '/dashboard/inbox'
+}, {
+  label: 'Users',
+  icon: 'i-lucide-users',
+  to: '/dashboard/users'
+}, {
+  label: 'Settings',
+  icon: 'i-lucide-settings',
+  to: '/dashboard/settings'
+}])
+</script>
+
+<template>
+  <UDashboardGroup>
+    <UDashboardSidebar collapsible resizable>
+      <template #header="{ collapsed }">
+        <UDashboardSearchButton :collapsed="collapsed" />
+      </template>
+
+      <template #default="{ collapsed }">
+        <UNavigationMenu
+          :items="items"
+          orientation="vertical"
+          :ui="{ link: collapsed ? 'justify-center' : undefined }"
+        />
+      </template>
+
+      <template #footer="{ collapsed }">
+        <UButton
+          :icon="collapsed ? 'i-lucide-log-out' : undefined"
+          :label="collapsed ? undefined : 'Sign out'"
+          color="neutral"
+          variant="ghost"
+          block
+        />
+      </template>
+    </UDashboardSidebar>
+
+    <slot />
+  </UDashboardGroup>
+</template>
+```
+
+## Page
+
+```vue [pages/dashboard/index.vue]
+<script setup lang="ts">
+definePageMeta({ layout: 'dashboard' })
+</script>
+
+<template>
+  <UDashboardPanel>
+    <template #header>
+      <UDashboardNavbar title="Home">
+        <template #right>
+          <UButton icon="i-lucide-plus" label="New" />
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <template #body>
+      <!-- Page content -->
+    </template>
+  </UDashboardPanel>
+</template>
+```
+
+## Key components
+
+### DashboardGroup
+
+Root layout wrapper. Manages sidebar state and persistence.
+
+| Prop | Default | Description |
+|---|---|---|
+| `storage` | `'cookie'` | State persistence: `'cookie'`, `'localStorage'`, `false` |
+| `storage-key` | `'dashboard'` | Storage key name |
+| `unit` | `'percentages'` | Size unit: `'percentages'` or `'pixels'` |
+
+### DashboardSidebar
+
+Resizable, collapsible sidebar. Must be inside `DashboardGroup`.
+
+| Prop | Default | Description |
+|---|---|---|
+| `resizable` | `false` | Enable resize by dragging |
+| `collapsible` | `false` | Enable collapse when dragged to edge |
+| `side` | `'left'` | `'left'` or `'right'` |
+| `mode` | `'slideover'` | Mobile menu mode: `'modal'`, `'slideover'`, `'drawer'` |
+
+Slots receive `{ collapsed }` prop. Control state: `v-model:collapsed`, `v-model:open` (mobile).
+
+### DashboardPanel
+
+Content panel with `#header`, `#body` (scrollable), `#footer`, and `#default` (raw) slots.
+
+| Prop | Default | Description |
+|---|---|---|
+| `id` | `—` | Unique ID (required for multi-panel) |
+| `resizable` | `false` | Enable resize by dragging |
+
+### DashboardNavbar / DashboardToolbar
+
+Navbar has `#left`, `#default`, `#right` slots and a `title` prop. Toolbar has the same slots for filters/actions below the navbar.
+
+## Multi-panel (list-detail)
+
+```vue [pages/dashboard/inbox.vue]
+<script setup lang="ts">
+definePageMeta({ layout: 'dashboard' })
+</script>
+
+<template>
+  <UDashboardPanel id="inbox-list" resizable>
+    <template #header>
+      <UDashboardNavbar title="Inbox" />
+    </template>
+    <template #body>
+      <!-- Email list -->
+    </template>
+  </UDashboardPanel>
+
+  <UDashboardPanel id="inbox-detail" class="hidden lg:flex">
+    <template #header>
+      <UDashboardNavbar title="Message" />
+    </template>
+    <template #body>
+      <!-- Email content -->
+    </template>
+  </UDashboardPanel>
+</template>
+```
+
+## With toolbar
+
+```vue
+<UDashboardPanel>
+  <template #header>
+    <UDashboardNavbar title="Users" />
+
+    <UDashboardToolbar>
+      <template #left>
+        <UInput icon="i-lucide-search" placeholder="Search..." />
+      </template>
+      <template #right>
+        <USelect :items="['All', 'Active', 'Inactive']" />
+      </template>
+    </UDashboardToolbar>
+  </template>
+</UDashboardPanel>
+```
+
+## With search
+
+```vue [layouts/dashboard.vue]
+<template>
+  <UDashboardGroup>
+    <UDashboardSidebar>
+      <template #header>
+        <UDashboardSearchButton />
+      </template>
+      <!-- ... -->
+    </UDashboardSidebar>
+
+    <slot />
+
+    <UDashboardSearch :groups="searchGroups" />
+  </UDashboardGroup>
+</template>
+```
+
+## Right sidebar
+
+```vue
+<UDashboardGroup>
+  <UDashboardSidebar collapsible resizable>
+    <!-- Left sidebar -->
+  </UDashboardSidebar>
+
+  <slot />
+
+  <UDashboardSidebar side="right" resizable>
+    <!-- Right sidebar -->
+  </UDashboardSidebar>
+</UDashboardGroup>
+```

package/.agents/skills/nuxt-ui/references/layouts/docs.md

@@ -0,0 +1,141 @@
+# Docs Layout
+
+Build documentation sites with sidebar navigation, table of contents, and surround links.
+
+> Requires `@nuxt/content` module for navigation, search, and TOC.
+
+## Component tree
+
+```
+UApp
+├── UHeader
+├── UMain
+│   └── NuxtLayout (docs)
+│       └── UPage
+│           ├── #left → UPageAside → UContentNavigation
+│           └── NuxtPage
+│               ├── UPageHeader
+│               ├── UPageBody → ContentRenderer + UContentSurround
+│               └── #right → UContentToc
+└── UFooter
+```
+
+## App shell
+
+```vue [app.vue]
+<script setup lang="ts">
+import type { NavigationMenuItem } from '@nuxt/ui'
+
+const route = useRoute()
+
+const { data: navigation } = await useAsyncData('navigation', () => queryCollectionNavigation('docs'))
+
+provide('navigation', navigation)
+
+const items = computed<NavigationMenuItem[]>(() => [{
+  label: 'Docs',
+  to: '/docs/getting-started',
+  active: route.path.startsWith('/docs')
+}])
+</script>
+
+<template>
+  <UApp>
+    <UHeader>
+      <template #title>
+        <Logo class="h-6 w-auto" />
+      </template>
+
+      <UNavigationMenu :items="items" />
+
+      <template #right>
+        <UContentSearchButton />
+        <UColorModeButton />
+      </template>
+    </UHeader>
+
+    <UMain>
+      <NuxtLayout>
+        <NuxtPage />
+      </NuxtLayout>
+    </UMain>
+
+    <UFooter />
+
+    <UContentSearch :navigation="navigation" />
+  </UApp>
+</template>
+```
+
+## Layout
+
+```vue [layouts/docs.vue]
+<script setup lang="ts">
+import type { ContentNavigationItem } from '@nuxt/content'
+
+const navigation = inject<Ref<ContentNavigationItem[]>>('navigation')
+</script>
+
+<template>
+  <UPage>
+    <template #left>
+      <UPageAside>
+        <UContentNavigation :navigation="navigation" />
+      </UPageAside>
+    </template>
+
+    <slot />
+  </UPage>
+</template>
+```
+
+## Page
+
+```vue [pages/docs/[...slug].vue]
+<script setup lang="ts">
+const route = useRoute()
+
+definePageMeta({ layout: 'docs' })
+
+const { data: page } = await useAsyncData(route.path, () => {
+  return queryCollection('docs').path(route.path).first()
+})
+
+const { data: surround } = await useAsyncData(`${route.path}-surround`, () => {
+  return queryCollectionItemSurroundings('docs', route.path)
+})
+</script>
+
+<template>
+  <UPage>
+    <UPageHeader :title="page.title" :description="page.description" />
+
+    <UPageBody>
+      <ContentRenderer :value="page" />
+
+      <USeparator />
+
+      <UContentSurround :surround="surround" />
+    </UPageBody>
+
+    <template #right>
+      <UContentToc :links="page.body.toc.links" />
+    </template>
+  </UPage>
+</template>
+```
+
+> The outer `UPage` in the layout handles the left sidebar. The inner `UPage` in the page handles the right sidebar. They nest correctly.
+
+## Key components
+
+- `UPage` — Multi-column grid layout with `#left`, `#default`, `#right` slots
+- `UPageAside` — Sticky sidebar wrapper (visible from `lg` breakpoint)
+- `UPageHeader` — Page title and description
+- `UPageBody` — Main content area
+- `UContentNavigation` — Sidebar navigation tree
+- `UContentToc` — Table of contents
+- `UContentSurround` — Prev/next links
+- `UContentSearch` / `UContentSearchButton` — Search command palette
+- `UPageAnchors` — Simpler alternative to full TOC
+- `UPageLinks` — Related resource links

package/.agents/skills/nuxt-ui/references/layouts/editor.md

@@ -0,0 +1,167 @@
+# Editor Layout
+
+Build a rich text editor with toolbars, slash commands, mentions, and drag-and-drop.
+
+## Component tree
+
+```
+UApp
+├── UHeader
+├── UMain
+│   └── NuxtPage
+│       └── UContainer
+│           └── UEditor
+│               ├── UEditorToolbar (fixed / bubble / floating)
+│               ├── UEditorDragHandle
+│               ├── UEditorSuggestionMenu
+│               ├── UEditorMentionMenu
+│               └── UEditorEmojiMenu
+└── UFooter
+```
+
+## Page
+
+```vue [pages/editor.vue]
+<script setup lang="ts">
+const content = ref({
+  type: 'doc',
+  content: [
+    {
+      type: 'heading',
+      attrs: { level: 1 },
+      content: [{ type: 'text', text: 'Hello World' }]
+    },
+    {
+      type: 'paragraph',
+      content: [{ type: 'text', text: 'Start writing...' }]
+    }
+  ]
+})
+</script>
+
+<template>
+  <UPage>
+    <UPageHeader title="Editor">
+      <template #actions>
+        <UButton label="Save" icon="i-lucide-save" />
+      </template>
+    </UPageHeader>
+
+    <UPageBody>
+      <UEditor v-model="content">
+        <UEditorToolbar />
+        <UEditorDragHandle />
+        <UEditorSuggestionMenu />
+        <UEditorMentionMenu
+          :items="[
+            { label: 'Benjamin', avatar: { src: 'https://github.com/benjamincanac.png' } },
+            { label: 'Sébastien', avatar: { src: 'https://github.com/atinux.png' } }
+          ]"
+        />
+        <UEditorEmojiMenu />
+      </UEditor>
+    </UPageBody>
+  </UPage>
+</template>
+```
+
+> If you encounter prosemirror-related errors, add prosemirror packages to `vite.optimizeDeps.include` in `nuxt.config.ts`.
+
+## Key components
+
+- `UEditor` — Rich text editor (`v-model` accepts JSON, HTML, or markdown via `content-type` prop)
+- `UEditorToolbar` — Toolbar with `layout`: `'fixed'` (default), `'bubble'` (on selection), `'floating'` (on empty lines)
+- `UEditorDragHandle` — Block drag-and-drop handle
+- `UEditorSuggestionMenu` — Slash command menu
+- `UEditorMentionMenu` — @ mention menu
+- `UEditorEmojiMenu` — Emoji picker
+
+## Toolbar modes
+
+```vue
+<!-- Fixed (default) -->
+<UEditor v-model="content">
+  <UEditorToolbar />
+</UEditor>
+
+<!-- Bubble (appears on text selection) -->
+<UEditor v-model="content">
+  <UEditorToolbar layout="bubble" />
+</UEditor>
+
+<!-- Floating (appears on empty lines) -->
+<UEditor v-model="content">
+  <UEditorToolbar layout="floating" />
+</UEditor>
+```
+
+## Content types
+
+```vue
+<!-- JSON (default) -->
+<UEditor v-model="jsonContent" />
+
+<!-- HTML -->
+<UEditor v-model="htmlContent" content-type="html" />
+
+<!-- Markdown -->
+<UEditor v-model="markdownContent" content-type="markdown" />
+```
+
+## With document sidebar
+
+Combine with Dashboard components for a multi-document editor with a sidebar.
+
+```vue [layouts/editor.vue]
+<template>
+  <UDashboardGroup>
+    <UDashboardSidebar collapsible resizable>
+      <template #header>
+        <UButton icon="i-lucide-plus" label="New document" block />
+      </template>
+
+      <template #default>
+        <UNavigationMenu
+          :items="documents.map(doc => ({
+            label: doc.title,
+            to: `/editor/${doc.id}`,
+            icon: 'i-lucide-file-text'
+          }))"
+          orientation="vertical"
+        />
+      </template>
+    </UDashboardSidebar>
+
+    <slot />
+  </UDashboardGroup>
+</template>
+```
+
+```vue [pages/editor/[id].vue]
+<script setup lang="ts">
+definePageMeta({ layout: 'editor' })
+
+const content = ref({ type: 'doc', content: [] })
+</script>
+
+<template>
+  <UDashboardPanel>
+    <template #header>
+      <UDashboardNavbar title="Editor">
+        <template #right>
+          <UButton label="Save" icon="i-lucide-save" />
+        </template>
+      </UDashboardNavbar>
+    </template>
+
+    <UContainer class="py-8">
+      <UEditor v-model="content">
+        <UEditorToolbar />
+        <UEditorDragHandle />
+        <UEditorSuggestionMenu />
+        <UEditorEmojiMenu />
+      </UEditor>
+    </UContainer>
+  </UDashboardPanel>
+</template>
+```