nextworks 0.0.1 → 0.1.0-alpha.1

package/dist/kits/blocks/lib/themes.ts

@@ -0,0 +1,399 @@
+import { type ThemeConfig, type ThemeVariant } from "@nextworks/blocks-core";
+
+export const themes: Record<ThemeVariant, ThemeConfig> = {
+  default: {
+    name: "Default",
+    colors: {
+      primary: "oklch(0.205 0 0)",
+      primaryForeground: "oklch(0.985 0 0)",
+      secondary: "oklch(0.97 0 0)",
+      secondaryForeground: "oklch(0.205 0 0)",
+      accent: "oklch(0.97 0 0)",
+      accentForeground: "oklch(0.205 0 0)",
+      background: "oklch(1 0 0)",
+      foreground: "oklch(0.145 0 0)",
+      card: "oklch(1 0 0)",
+      cardForeground: "oklch(0.145 0 0)",
+      popover: "oklch(1 0 0)",
+      popoverForeground: "oklch(0.145 0 0)",
+      muted: "oklch(0.97 0 0)",
+      mutedForeground: "oklch(0.556 0 0)",
+      border: "oklch(0.922 0 0)",
+      input: "oklch(0.922 0 0)",
+      ring: "oklch(0.708 0 0)",
+      destructive: "oklch(0.577 0.245 27.325)",
+      chart1: "oklch(0.646 0.222 41.116)",
+      chart2: "oklch(0.6 0.118 184.704)",
+      chart3: "oklch(0.398 0.07 227.392)",
+      chart4: "oklch(0.828 0.189 84.429)",
+      chart5: "oklch(0.769 0.188 70.08)",
+    },
+  },
+  monochrome: {
+    name: "Monochrome",
+    colors: {
+      primary: "oklch(0.2 0 0)",
+      primaryForeground: "oklch(0.98 0 0)",
+      secondary: "oklch(0.95 0 0)",
+      secondaryForeground: "oklch(0.2 0 0)",
+      accent: "oklch(0.9 0 0)",
+      accentForeground: "oklch(0.2 0 0)",
+      background: "oklch(1 0 0)",
+      foreground: "oklch(0.1 0 0)",
+      card: "oklch(0.99 0 0)",
+      cardForeground: "oklch(0.1 0 0)",
+      popover: "oklch(0.99 0 0)",
+      popoverForeground: "oklch(0.1 0 0)",
+      muted: "oklch(0.95 0 0)",
+      mutedForeground: "oklch(0.5 0 0)",
+      border: "oklch(0.9 0 0)",
+      input: "oklch(0.9 0 0)",
+      ring: "oklch(0.7 0 0)",
+      destructive: "oklch(0.4 0 0)",
+      chart1: "oklch(0.2 0 0)",
+      chart2: "oklch(0.4 0 0)",
+      chart3: "oklch(0.6 0 0)",
+      chart4: "oklch(0.8 0 0)",
+      chart5: "oklch(0.3 0 0)",
+    },
+  },
+  blue: {
+    name: "Blue",
+    colors: {
+      primary: "oklch(0.5 0.2 240)",
+      primaryForeground: "oklch(0.98 0 0)",
+      secondary: "oklch(0.95 0.05 240)",
+      secondaryForeground: "oklch(0.2 0.1 240)",
+      accent: "oklch(0.9 0.1 240)",
+      accentForeground: "oklch(0.2 0.1 240)",
+      background: "oklch(1 0 0)",
+      foreground: "oklch(0.1 0 0)",
+      card: "oklch(0.99 0 0)",
+      cardForeground: "oklch(0.1 0 0)",
+      popover: "oklch(0.99 0 0)",
+      popoverForeground: "oklch(0.1 0 0)",
+      muted: "oklch(0.95 0.02 240)",
+      mutedForeground: "oklch(0.5 0.05 240)",
+      border: "oklch(0.9 0.05 240)",
+      input: "oklch(0.9 0.05 240)",
+      ring: "oklch(0.5 0.2 240)",
+      destructive: "oklch(0.6 0.2 0)",
+      chart1: "oklch(0.5 0.2 240)",
+      chart2: "oklch(0.6 0.15 200)",
+      chart3: "oklch(0.7 0.1 180)",
+      chart4: "oklch(0.4 0.2 280)",
+      chart5: "oklch(0.8 0.1 220)",
+    },
+  },
+  green: {
+    name: "Green",
+    colors: {
+      primary: "oklch(0.5 0.2 140)",
+      primaryForeground: "oklch(0.98 0 0)",
+      secondary: "oklch(0.95 0.05 140)",
+      secondaryForeground: "oklch(0.2 0.1 140)",
+      accent: "oklch(0.9 0.1 140)",
+      accentForeground: "oklch(0.2 0.1 140)",
+      background: "oklch(1 0 0)",
+      foreground: "oklch(0.1 0 0)",
+      card: "oklch(0.99 0 0)",
+      cardForeground: "oklch(0.1 0 0)",
+      popover: "oklch(0.99 0 0)",
+      popoverForeground: "oklch(0.1 0 0)",
+      muted: "oklch(0.95 0.02 140)",
+      mutedForeground: "oklch(0.5 0.05 140)",
+      border: "oklch(0.9 0.05 140)",
+      input: "oklch(0.9 0.05 140)",
+      ring: "oklch(0.5 0.2 140)",
+      destructive: "oklch(0.6 0.2 0)",
+      chart1: "oklch(0.5 0.2 140)",
+      chart2: "oklch(0.6 0.15 120)",
+      chart3: "oklch(0.7 0.1 100)",
+      chart4: "oklch(0.4 0.2 160)",
+      chart5: "oklch(0.8 0.1 130)",
+    },
+  },
+  purple: {
+    name: "Purple",
+    colors: {
+      primary: "oklch(0.5 0.2 300)",
+      primaryForeground: "oklch(0.98 0 0)",
+      secondary: "oklch(0.95 0.05 300)",
+      secondaryForeground: "oklch(0.2 0.1 300)",
+      accent: "oklch(0.9 0.1 300)",
+      accentForeground: "oklch(0.2 0.1 300)",
+      background: "oklch(1 0 0)",
+      foreground: "oklch(0.1 0 0)",
+      card: "oklch(0.99 0 0)",
+      cardForeground: "oklch(0.1 0 0)",
+      popover: "oklch(0.99 0 0)",
+      popoverForeground: "oklch(0.1 0 0)",
+      muted: "oklch(0.95 0.02 300)",
+      mutedForeground: "oklch(0.5 0.05 300)",
+      border: "oklch(0.9 0.05 300)",
+      input: "oklch(0.9 0.05 300)",
+      ring: "oklch(0.5 0.2 300)",
+      destructive: "oklch(0.6 0.2 0)",
+      chart1: "oklch(0.5 0.2 300)",
+      chart2: "oklch(0.6 0.15 280)",
+      chart3: "oklch(0.7 0.1 260)",
+      chart4: "oklch(0.4 0.2 320)",
+      chart5: "oklch(0.8 0.1 290)",
+    },
+  },
+  orange: {
+    name: "Orange",
+    colors: {
+      primary: "oklch(0.6 0.2 40)",
+      primaryForeground: "oklch(0.98 0 0)",
+      secondary: "oklch(0.95 0.05 40)",
+      secondaryForeground: "oklch(0.2 0.1 40)",
+      accent: "oklch(0.9 0.1 40)",
+      accentForeground: "oklch(0.2 0.1 40)",
+      background: "oklch(1 0 0)",
+      foreground: "oklch(0.1 0 0)",
+      card: "oklch(0.99 0 0)",
+      cardForeground: "oklch(0.1 0 0)",
+      popover: "oklch(0.99 0 0)",
+      popoverForeground: "oklch(0.1 0 0)",
+      muted: "oklch(0.95 0.02 40)",
+      mutedForeground: "oklch(0.5 0.05 40)",
+      border: "oklch(0.9 0.05 40)",
+      input: "oklch(0.9 0.05 40)",
+      ring: "oklch(0.6 0.2 40)",
+      destructive: "oklch(0.6 0.2 0)",
+      chart1: "oklch(0.6 0.2 40)",
+      chart2: "oklch(0.7 0.15 20)",
+      chart3: "oklch(0.8 0.1 0)",
+      chart4: "oklch(0.5 0.2 60)",
+      chart5: "oklch(0.9 0.1 30)",
+    },
+  },
+  custom: {
+    name: "Custom",
+    colors: {
+      primary: "oklch(0.205 0 0)",
+      primaryForeground: "oklch(0.985 0 0)",
+      secondary: "oklch(0.97 0 0)",
+      secondaryForeground: "oklch(0.205 0 0)",
+      accent: "oklch(0.97 0 0)",
+      accentForeground: "oklch(0.205 0 0)",
+      background: "oklch(1 0 0)",
+      foreground: "oklch(0.145 0 0)",
+      card: "oklch(1 0 0)",
+      cardForeground: "oklch(0.145 0 0)",
+      popover: "oklch(1 0 0)",
+      popoverForeground: "oklch(0.145 0 0)",
+      muted: "oklch(0.97 0 0)",
+      mutedForeground: "oklch(0.556 0 0)",
+      border: "oklch(0.922 0 0)",
+      input: "oklch(0.922 0 0)",
+      ring: "oklch(0.708 0 0)",
+      destructive: "oklch(0.577 0.245 27.325)",
+      chart1: "oklch(0.646 0.222 41.116)",
+      chart2: "oklch(0.6 0.118 184.704)",
+      chart3: "oklch(0.398 0.07 227.392)",
+      chart4: "oklch(0.828 0.189 84.429)",
+      chart5: "oklch(0.769 0.188 70.08)",
+    },
+  },
+};
+
+export const darkThemes: Record<ThemeVariant, ThemeConfig> = {
+  default: {
+    name: "Default Dark",
+    colors: {
+      primary: "oklch(0.922 0 0)",
+      primaryForeground: "oklch(0.205 0 0)",
+      secondary: "oklch(0.269 0 0)",
+      secondaryForeground: "oklch(0.985 0 0)",
+      accent: "oklch(0.269 0 0)",
+      accentForeground: "oklch(0.985 0 0)",
+      background: "oklch(0.145 0 0)",
+      foreground: "oklch(0.985 0 0)",
+      card: "oklch(0.205 0 0)",
+      cardForeground: "oklch(0.985 0 0)",
+      popover: "oklch(0.205 0 0)",
+      popoverForeground: "oklch(0.985 0 0)",
+      muted: "oklch(0.269 0 0)",
+      mutedForeground: "oklch(0.708 0 0)",
+      border: "oklch(1 0 0 / 10%)",
+      input: "oklch(1 0 0 / 15%)",
+      ring: "oklch(0.556 0 0)",
+      destructive: "oklch(0.704 0.191 22.216)",
+      chart1: "oklch(0.488 0.243 264.376)",
+      chart2: "oklch(0.696 0.17 162.48)",
+      chart3: "oklch(0.769 0.188 70.08)",
+      chart4: "oklch(0.627 0.265 303.9)",
+      chart5: "oklch(0.645 0.246 16.439)",
+    },
+  },
+  monochrome: {
+    name: "Monochrome Dark",
+    colors: {
+      primary: "oklch(0.8 0 0)",
+      primaryForeground: "oklch(0.2 0 0)",
+      secondary: "oklch(0.3 0 0)",
+      secondaryForeground: "oklch(0.9 0 0)",
+      accent: "oklch(0.3 0 0)",
+      accentForeground: "oklch(0.9 0 0)",
+      background: "oklch(0.1 0 0)",
+      foreground: "oklch(0.9 0 0)",
+      card: "oklch(0.15 0 0)",
+      cardForeground: "oklch(0.9 0 0)",
+      popover: "oklch(0.15 0 0)",
+      popoverForeground: "oklch(0.9 0 0)",
+      muted: "oklch(0.3 0 0)",
+      mutedForeground: "oklch(0.6 0 0)",
+      border: "oklch(0.2 0 0)",
+      input: "oklch(0.2 0 0)",
+      ring: "oklch(0.5 0 0)",
+      destructive: "oklch(0.6 0 0)",
+      chart1: "oklch(0.8 0 0)",
+      chart2: "oklch(0.6 0 0)",
+      chart3: "oklch(0.4 0 0)",
+      chart4: "oklch(0.7 0 0)",
+      chart5: "oklch(0.5 0 0)",
+    },
+  },
+  blue: {
+    name: "Blue Dark",
+    colors: {
+      primary: "oklch(0.7 0.2 240)",
+      primaryForeground: "oklch(0.1 0 0)",
+      secondary: "oklch(0.3 0.1 240)",
+      secondaryForeground: "oklch(0.9 0 0)",
+      accent: "oklch(0.3 0.1 240)",
+      accentForeground: "oklch(0.9 0 0)",
+      background: "oklch(0.1 0 0)",
+      foreground: "oklch(0.9 0 0)",
+      card: "oklch(0.15 0.05 240)",
+      cardForeground: "oklch(0.9 0 0)",
+      popover: "oklch(0.15 0.05 240)",
+      popoverForeground: "oklch(0.9 0 0)",
+      muted: "oklch(0.3 0.05 240)",
+      mutedForeground: "oklch(0.6 0.05 240)",
+      border: "oklch(0.2 0.1 240)",
+      input: "oklch(0.2 0.1 240)",
+      ring: "oklch(0.7 0.2 240)",
+      destructive: "oklch(0.6 0.2 0)",
+      chart1: "oklch(0.7 0.2 240)",
+      chart2: "oklch(0.6 0.15 200)",
+      chart3: "oklch(0.5 0.1 180)",
+      chart4: "oklch(0.8 0.2 280)",
+      chart5: "oklch(0.4 0.1 220)",
+    },
+  },
+  green: {
+    name: "Green Dark",
+    colors: {
+      primary: "oklch(0.7 0.2 140)",
+      primaryForeground: "oklch(0.1 0 0)",
+      secondary: "oklch(0.3 0.1 140)",
+      secondaryForeground: "oklch(0.9 0 0)",
+      accent: "oklch(0.3 0.1 140)",
+      accentForeground: "oklch(0.9 0 0)",
+      background: "oklch(0.1 0 0)",
+      foreground: "oklch(0.9 0 0)",
+      card: "oklch(0.15 0.05 140)",
+      cardForeground: "oklch(0.9 0 0)",
+      popover: "oklch(0.15 0.05 140)",
+      popoverForeground: "oklch(0.9 0 0)",
+      muted: "oklch(0.3 0.05 140)",
+      mutedForeground: "oklch(0.6 0.05 140)",
+      border: "oklch(0.2 0.1 140)",
+      input: "oklch(0.2 0.1 140)",
+      ring: "oklch(0.7 0.2 140)",
+      destructive: "oklch(0.6 0.2 0)",
+      chart1: "oklch(0.7 0.2 140)",
+      chart2: "oklch(0.6 0.15 120)",
+      chart3: "oklch(0.5 0.1 100)",
+      chart4: "oklch(0.8 0.2 160)",
+      chart5: "oklch(0.4 0.1 130)",
+    },
+  },
+  purple: {
+    name: "Purple Dark",
+    colors: {
+      primary: "oklch(0.7 0.2 300)",
+      primaryForeground: "oklch(0.1 0 0)",
+      secondary: "oklch(0.3 0.1 300)",
+      secondaryForeground: "oklch(0.9 0 0)",
+      accent: "oklch(0.3 0.1 300)",
+      accentForeground: "oklch(0.9 0 0)",
+      background: "oklch(0.1 0 0)",
+      foreground: "oklch(0.9 0 0)",
+      card: "oklch(0.15 0.05 300)",
+      cardForeground: "oklch(0.9 0 0)",
+      popover: "oklch(0.15 0.05 300)",
+      popoverForeground: "oklch(0.9 0 0)",
+      muted: "oklch(0.3 0.05 300)",
+      mutedForeground: "oklch(0.6 0.05 300)",
+      border: "oklch(0.2 0.1 300)",
+      input: "oklch(0.2 0.1 300)",
+      ring: "oklch(0.7 0.2 300)",
+      destructive: "oklch(0.6 0.2 0)",
+      chart1: "oklch(0.7 0.2 300)",
+      chart2: "oklch(0.6 0.15 280)",
+      chart3: "oklch(0.5 0.1 260)",
+      chart4: "oklch(0.8 0.2 320)",
+      chart5: "oklch(0.4 0.1 290)",
+    },
+  },
+  orange: {
+    name: "Orange Dark",
+    colors: {
+      primary: "oklch(0.8 0.2 40)",
+      primaryForeground: "oklch(0.1 0 0)",
+      secondary: "oklch(0.3 0.1 40)",
+      secondaryForeground: "oklch(0.9 0 0)",
+      accent: "oklch(0.3 0.1 40)",
+      accentForeground: "oklch(0.9 0 0)",
+      background: "oklch(0.1 0 0)",
+      foreground: "oklch(0.9 0 0)",
+      card: "oklch(0.15 0.05 40)",
+      cardForeground: "oklch(0.9 0 0)",
+      popover: "oklch(0.15 0.05 40)",
+      popoverForeground: "oklch(0.9 0 0)",
+      muted: "oklch(0.3 0.05 40)",
+      mutedForeground: "oklch(0.6 0.05 40)",
+      border: "oklch(0.2 0.1 40)",
+      input: "oklch(0.2 0.1 40)",
+      ring: "oklch(0.8 0.2 40)",
+      destructive: "oklch(0.6 0.2 0)",
+      chart1: "oklch(0.8 0.2 40)",
+      chart2: "oklch(0.7 0.15 20)",
+      chart3: "oklch(0.6 0.1 0)",
+      chart4: "oklch(0.9 0.2 60)",
+      chart5: "oklch(0.5 0.1 30)",
+    },
+  },
+  custom: {
+    name: "Custom Dark",
+    colors: {
+      primary: "oklch(0.922 0 0)",
+      primaryForeground: "oklch(0.205 0 0)",
+      secondary: "oklch(0.269 0 0)",
+      secondaryForeground: "oklch(0.985 0 0)",
+      accent: "oklch(0.269 0 0)",
+      accentForeground: "oklch(0.985 0 0)",
+      background: "oklch(0.145 0 0)",
+      foreground: "oklch(0.985 0 0)",
+      card: "oklch(0.205 0 0)",
+      cardForeground: "oklch(0.985 0 0)",
+      popover: "oklch(0.205 0 0)",
+      popoverForeground: "oklch(0.985 0 0)",
+      muted: "oklch(0.269 0 0)",
+      mutedForeground: "oklch(0.708 0 0)",
+      border: "oklch(1 0 0 / 10%)",
+      input: "oklch(1 0 0 / 15%)",
+      ring: "oklch(0.556 0 0)",
+      destructive: "oklch(0.704 0.191 22.216)",
+      chart1: "oklch(0.488 0.243 264.376)",
+      chart2: "oklch(0.696 0.17 162.48)",
+      chart3: "oklch(0.769 0.188 70.08)",
+      chart4: "oklch(0.627 0.265 303.9)",
+      chart5: "oklch(0.645 0.246 16.439)",
+    },
+  },
+};

package/dist/kits/blocks/lib/themes_old.ts

@@ -0,0 +1,37 @@
+// TypeScript cli/kits/blocks/lib/themes.ts
+
+export type Theme = {
+  name: string;
+  colors: {
+    primary: string;
+    background: string;
+    surface: string;
+    text: string;
+    muted: string;
+  };
+};
+
+export const themes: Theme[] = [
+  {
+    name: "light",
+    colors: {
+      primary: "#7c3aed",
+      background: "#ffffff",
+      surface: "#f8fafc",
+      text: "#0f172a",
+      muted: "#64748b",
+    },
+  },
+  {
+    name: "dark",
+    colors: {
+      primary: "#8b5cf6",
+      background: "#0b1220",
+      surface: "#071026",
+      text: "#e6eef8",
+      muted: "#93c5fd",
+    },
+  },
+];
+
+export const defaultTheme = themes[0];

package/dist/kits/blocks/lib/utils.ts

@@ -0,0 +1,9 @@
+// Copyright (c) 2025 Jakob Bro Liebe Hansen
+// SPDX-License-Identifier: MIT
+
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/dist/kits/blocks/next.config.ts

@@ -0,0 +1,11 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  /* config options here */
+  images: {
+    // Configure supported qualities to silence Next.js 16 warning
+    qualities: [60, 75, 85, 92],
+  },
+};
+
+export default nextConfig;

package/dist/kits/blocks/notes/THEME_GUIDE.md

@@ -0,0 +1,29 @@
+# Theme Guide (Blocks kit)
+
+This guide explains the theming system used by the Blocks kit.
+
+Overview
+
+- Theme definitions live in lib/themes.ts and export a list of theme presets and a default theme.
+- The ThemeProvider and EnhancedThemeProvider components consume these presets to provide runtime theme switching and CSS variable injection.
+
+Creating new themes
+
+1. Edit lib/themes.ts and add a new theme object with name and color tokens.
+2. Update any PresetThemeVars components in app/templates/* if you need template-specific variables.
+
+Usage
+
+- Wrap your app with the EnhancedThemeProvider in app/layout.tsx to enable theme switching.
+- Use CSS variables or the theme tokens directly in components when styling.
+
+Example
+
+import { themes } from "@/lib/themes";
+
+const custom = {
+  name: "brand",
+  colors: { primary: "#ff6600", background: "#fff8f0", surface: "#fff", text: "#1f2937", muted: "#9ca3af" }
+};
+
+themes.push(custom);

package/dist/kits/blocks/notes/THEMING_CONVERSION_SUMMARY.md

@@ -0,0 +1,14 @@
+# Theming Conversion Summary
+
+This document summarizes the changes made when converting the components to the new theming system.
+
+Key changes
+
+- All hardcoded tailwind classes for colors were replaced with semantic theme tokens defined in lib/themes.ts.
+- Components now read theme values via CSS variables injected by the EnhancedThemeProvider.
+- PresetThemeVars components in each template set CSS variables for each preset theme.
+
+Recommended follow-ups
+
+- Review components for any remaining hardcoded colors and replace them with theme tokens.
+- Add more theme presets into lib/themes.ts and update the PresetThemeVars where necessary.

package/dist/kits/blocks/package-deps.json

@@ -0,0 +1,22 @@
+{
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "class-variance-authority": "^0.7.1",
+    "lucide-react": "^0.542.0",
+    "@radix-ui/react-slot": "^1.2.3",
+    "@radix-ui/react-label": "^2.1.7",
+    "@radix-ui/react-alert-dialog": "^1.1.15",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
+    "tailwind-merge": "^3.3.1",
+    "tw-animate-css": "^1.3.7",
+    "next-themes": "^0.4.6",
+    "motion": "^12.23.12",
+    "sonner": "^2.0.7",
+    "@nextworks/blocks-core": "0.1.0-alpha.0",
+    "@nextworks/blocks-sections": "0.1.0-alpha.0",
+    "@nextworks/blocks-templates": "0.1.0-alpha.0"
+  },
+  "devDependencies": {
+    "tailwindcss": "^4.1.12"
+  }
+}

package/dist/kits/data/README.md

@@ -0,0 +1,104 @@
+Data kit (cli/kits/data)
+
+This kit provides a standalone example Data layer with Posts + Users CRUD: API routes, admin UI, Prisma helpers and a seed script. The kit is designed to be installed via the `nextworks` CLI:
+
+```bash
+npx nextworks add data
+```
+
+and is packaged with its own kit dependencies metadata.
+
+What the kit includes
+
+- API routes:
+  - app/api/posts/route.ts
+  - app/api/posts/[id]/route.ts
+  - app/api/users/route.ts
+  - app/api/users/[id]/route.ts
+  - app/api/users/check-unique/route.ts
+  - app/api/users/check-email/route.ts
+  - app/api/seed-demo/route.ts
+- Admin UI components (now standalone in the kit):
+  - components/admin/posts-manager.tsx
+  - components/admin/users-manager.tsx
+- Protected admin pages:
+  - app/(protected)/admin/posts/page.tsx
+  - app/(protected)/admin/users/page.tsx
+- Example/demo pages and helpers:
+  - app/examples/demo/create-post-form.tsx
+  - app/examples/demo/page.tsx
+  - app/examples/demo/README.md
+- Prisma helpers and utilities:
+  - lib/prisma.ts
+  - lib/server/result.ts (ApiResult helpers)
+  - lib/utils.ts
+- Seed script: scripts/seed-demo.mjs
+- Kit metadata: package-deps.json (declares @prisma/client and zod; prisma is a devDependency)
+
+Database requirements
+
+- The data kit is designed and tested with **PostgreSQL**, using a Postgres database hosted on [Neon](https://neon.tech/) during development.
+- Any Prisma‑supported provider _may_ work, but **Postgres is the recommended and currently tested path**.
+
+Quick start with Postgres (recommended):
+
+1. Create a Postgres database (for example on Neon).
+2. Copy the connection string into your `.env` as:
+
+   ```bash
+   DATABASE_URL="postgres://..."
+   ```
+
+3. Merge the Data/Auth Prisma models into your project's `prisma/schema.prisma` (see `prisma/auth-models.prisma` referenced by the manifest).
+4. Run:
+
+   ```bash
+   npx prisma generate
+   npx prisma migrate dev -n init_data
+   ```
+
+If you choose a different database provider, update the `provider` field in your Prisma schema and carefully review indexes/constraints before running migrations.
+
+Notes and important behavior
+
+- Kit dependencies:
+  - Data depends on Auth (for RBAC/session) and Forms (for form primitives/validation). The CLI currently auto-installs `auth-core` and `forms` when you run `nextworks add data` to ensure the required pieces are present. If you prefer an interactive prompt instead of auto-install, the CLI can be adjusted to prompt (ask the maintainers).
+  - The kit's package-deps.json lists runtime and dev dependencies that the CLI will merge into the project's package.json; after installation you must run npm install in the project.
+
+- Standalone admin components:
+  - The admin UI components have been copied into the kit so the Data kit is self-contained. They may still import shared UI primitives (for example from a Blocks or shared ui package) — ensure the consumer project has those UI packages or the CLI installs the required kits.
+
+- Auth overlap:
+  - The Data kit references the signup API route (app/api/signup/route.ts) in its manifest but does not duplicate the signup implementation — signup is provided by the Auth kit.
+
+- Prisma schema & migrations:
+  - The kit manifest references prisma/schema.prisma, prisma/migrations/\* and prisma/auth-models.prisma snippets, but the kit does not ship a full migrations directory. You must merge the provided model snippets into your project's prisma/schema.prisma, then run:
+    1. npx prisma generate
+    2. npx prisma migrate dev
+
+Post-install checklist
+
+1. Run `npm install` in your project to install dependencies merged by the kit.
+2. Merge the Data/Auth Prisma models into your project's `prisma/schema.prisma` (see `prisma/auth-models.prisma` referenced by the manifest) and run:
+   - `npx prisma generate`
+   - `npx prisma migrate dev`
+3. Populate demo data if desired:
+   - Either run the kit seed script locally: `node scripts/seed-demo.mjs`
+   - Or call the included API seed endpoint (POST to `/api/seed-demo`) if you prefer an HTTP-driven seed.
+
+CLI behavior and packaging (for maintainers)
+
+- Command: the CLI exposes the command `nextworks add data` which copies the files listed in `cli/cli_manifests/data_manifest.json` into your project and merges `package-deps.json` entries.
+- Auto-install: when running the command the CLI ensures Forms and Auth are installed first (auto-installs them if missing).
+- Manifest: keep cli_manifests/data_manifest.json and the files in this kit folder in sync — the CLI uses the manifest to know which files to copy.
+- Packaging: the kit includes package-deps.json and is included in the CLI distribution tarball (dist/kits/data). When the CLI package is built/packed it will include the standalone Data kit files.
+
+Caveats & tips
+
+- The kit is intended as example/demo code — consumers should review and adapt for production use (security, RBAC rules, validation, etc.).
+- If you want the CLI to prompt before installing Auth/Forms instead of auto-installing, open an issue or request the interactive behavior; it can be added.
+- If you want a timestamped or additional tarball build, the CLI packing step can be re-run to produce another artifact.
+
+CLI manifest
+
+- In the Nextworks repo, the CLI copies files listed in `cli/cli_manifests/data_manifest.json`. Keep that manifest and this kit folder in sync when editing the repo.

package/dist/kits/data/app/(protected)/admin/posts/page.tsx

@@ -0,0 +1,5 @@
+import PostsManager from "@/components/admin/posts-manager";
+
+export default function Page() {
+  return <PostsManager />;
+}