@microbuild/cli 0.1.0

package/dist/templates/lib/hooks/index.ts

@@ -0,0 +1,98 @@
+/**
+ * Microbuild Hooks
+ * 
+ * Re-exports all React hooks.
+ * This file is copied to your project and can be customized.
+ */
+
+// Relation hooks
+export { useRelationM2M, type M2MRelationInfo } from './useRelationM2M';
+export { useRelationM2MItems, type M2MItem, type M2MQueryParams } from './useRelationM2MItems';
+export { useRelationM2O, useRelationM2OItem, type M2ORelationInfo, type M2OItem } from './useRelationM2O';
+export { useRelationO2M, useRelationO2MItems, type O2MRelationInfo, type O2MItem, type O2MQueryParams } from './useRelationO2M';
+export { 
+  useRelationM2A, 
+  useRelationM2AItems, 
+  type M2ARelationInfo, 
+  type M2AItem, 
+  type M2AQueryParams
+} from './useRelationM2A';
+
+// File hooks
+export { 
+  useFiles, 
+  type FileUpload, 
+  type FileUploadOptions, 
+  type DirectusFile 
+} from './useFiles';
+
+// Selection & Preset hooks
+export { 
+  useSelection, 
+  type UseSelectionOptions, 
+  type UseSelectionReturn 
+} from './useSelection';
+export { 
+  usePreset, 
+  type UsePresetOptions, 
+  type UsePresetReturn,
+  type Filter,
+  type Query
+} from './usePreset';
+
+// Navigation guard hooks (Directus-style)
+export { 
+  useEditsGuard, 
+  useHasEdits,
+  type UseEditsGuardOptions, 
+  type UseEditsGuardReturn 
+} from './useEditsGuard';
+
+// Clipboard and Storage hooks (Directus-style)
+export {
+  useClipboard,
+  type UseClipboardOptions,
+  type UseClipboardReturn
+} from './useClipboard';
+export {
+  useLocalStorage,
+  type LocalStorageValue,
+  type UseLocalStorageOptions,
+  type UseLocalStorageReturn
+} from './useLocalStorage';
+
+// Versioning hooks (DaaS workflow + content versioning)
+export {
+  useVersions,
+  type ContentVersion,
+  type UseVersionsOptions,
+  type UseVersionsReturn
+} from './useVersions';
+export {
+  useWorkflowAssignment,
+  type WorkflowAssignment,
+  type UseWorkflowAssignmentReturn
+} from './useWorkflowAssignment';
+export {
+  useWorkflowVersioning,
+  type WorkflowState,
+  type WorkflowInstance,
+  type UseWorkflowVersioningOptions,
+  type UseWorkflowVersioningProps,
+  type UseWorkflowVersioningReturn
+} from './useWorkflowVersioning';
+
+// API helpers
+export { api, directusAPI, createDirectusAPI, type DirectusAPIConfig, type QueryParams } from './api';
+
+// Re-export types for convenience
+export type { 
+  Relation, 
+  RelationMeta, 
+  RelationSchema, 
+  RelationCollectionMeta, 
+  RelationFieldInfo 
+} from '@/lib/microbuild/types';
+
+// Utility functions
+export { apiRequest, isValidPrimaryKey } from './utils';

package/dist/templates/lib/services/index.ts

@@ -0,0 +1,26 @@
+/**
+ * Microbuild Services
+ * 
+ * Re-exports all service classes.
+ * This file is copied to your project and can be customized.
+ */
+
+export { ItemsService, createItemsService } from './items';
+export { FieldsService, createFieldsService } from './fields';
+export { CollectionsService, createCollectionsService } from './collections';
+export { PermissionsService, createPermissionsService, type FieldPermissions } from './permissions';
+export { apiRequest, type ApiRequestOptions } from './api-request';
+
+// DaaS Context Provider for direct API access (bypassing proxy routes)
+export {
+  DaaSProvider,
+  useDaaSContext,
+  useIsDirectDaaSMode,
+  setGlobalDaaSConfig,
+  getGlobalDaaSConfig,
+  buildApiUrl,
+  getApiHeaders,
+  type DaaSConfig,
+  type DaaSContextValue,
+  type DaaSProviderProps,
+} from './daas-context';

package/dist/templates/lib/theme.ts

@@ -0,0 +1,241 @@
+"use client";
+
+import { createTheme } from "@mantine/core";
+
+export const theme = createTheme({
+  colors: {
+    primary: [
+      "var(--ds-primary-100, #ece6fb)",
+      "var(--ds-primary-200, #cfcbfd)",
+      "var(--ds-primary-300, #a29bfb)",
+      "var(--ds-primary-400, #7857ff)",
+      "var(--ds-primary, #5925dc)",
+      "var(--ds-primary-600, #491db6)",
+      "var(--ds-primary-700, #39178e)",
+      "var(--ds-primary-800, #291167)",
+      "var(--ds-primary-900, #190a3f)",
+      "var(--ds-primary-950, #0f0629)"
+    ],
+    secondary: [
+      "var(--ds-secondary-100, #ebf1ff)",
+      "var(--ds-secondary-200, #d3e2ff)",
+      "var(--ds-secondary-300, #99bbff)",
+      "var(--ds-secondary-400, #70a0ff)",
+      "var(--ds-secondary, #1f69ff)",
+      "var(--ds-secondary-600, #004ff0)",
+      "var(--ds-secondary-700, #0040c2)",
+      "var(--ds-secondary-800, #003194)",
+      "var(--ds-secondary-900, #002266)",
+      "var(--ds-secondary-950, #001a4d)"
+    ],
+    success: [
+      "var(--ds-success-100, #ecfbee)",
+      "var(--ds-success-200, #c4e8c8)",
+      "var(--ds-success-300, #9dd9a3)",
+      "var(--ds-success-400, #58be62)",
+      "var(--ds-success-500, #3bb346)",
+      "var(--ds-success, #198754)",
+      "var(--ds-success-700, #2da337)",
+      "var(--ds-success-800, #196f25)",
+      "var(--ds-success-900, #0d4f15)",
+      "var(--ds-success-950, #0a3e11)"
+    ],
+    info: [
+      "var(--ds-info-100, #e6f3fb)",
+      "var(--ds-info-200, #b9d8ee)",
+      "var(--ds-info-300, #90c1e4)",
+      "var(--ds-info-400, #58a1d4)",
+      "var(--ds-info-500, #59a1d4)",
+      "var(--ds-info, #0f71bb)",
+      "var(--ds-info-700, #0c5b97)",
+      "var(--ds-info-800, #0a4776)",
+      "var(--ds-info-900, #08395e)",
+      "var(--ds-info-950, #062b47)"
+    ],
+    warning: [
+      "var(--ds-warning-100, #fffaeb)",
+      "var(--ds-warning-200, #fef0c7)",
+      "var(--ds-warning-300, #fedf89)",
+      "var(--ds-warning-400, #fec84b)",
+      "var(--ds-warning-500, #fdb022)",
+      "var(--ds-warning, #f79009)",
+      "var(--ds-warning-700, #dc6803)",
+      "var(--ds-warning-800, #b7571e)",
+      "var(--ds-warning-900, #8f4419)",
+      "var(--ds-warning-950, #6d3314)"
+    ],
+    danger: [
+      "var(--ds-danger-100, #fff4f3)",
+      "var(--ds-danger-200, #ffcfc8)",
+      "var(--ds-danger-300, #fc9c90)",
+      "var(--ds-danger-400, #fb7463)",
+      "var(--ds-danger-500, #fa5741)",
+      "var(--ds-danger, #d7260f)",
+      "var(--ds-danger-700, #f8331c)",
+      "var(--ds-danger-800, #c4281a)",
+      "var(--ds-danger-900, #9a1f15)",
+      "var(--ds-danger-950, #72170f)"
+    ],
+    gray: [
+      "var(--ds-gray-100, #f7f7f9)",
+      "var(--ds-gray-200, #e4e7ec)",
+      "var(--ds-gray-300, #d0d5dd)",
+      "var(--ds-gray-400, #98a2b3)",
+      "var(--ds-gray-500, #667085)",
+      "var(--ds-gray-600, #344054)",
+      "var(--ds-gray-700, #1d2939)",
+      "var(--ds-gray-800, #101828)",
+      "var(--ds-gray-900, #000000)",
+      "var(--ds-gray-950, #000000)"
+    ]
+  },
+  primaryColor: "primary",
+  fontFamily: "var(--ds-font-family)",
+  fontFamilyMonospace:
+    "SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace",
+  headings: {
+    fontWeight: "700",
+    fontFamily: "var(--ds-font-family)"
+  },
+  fontSizes: {
+    xs: "var(--ds-font-size-xs)",
+    sm: "var(--ds-font-size-sm)",
+    md: "var(--ds-font-size-base)",
+    lg: "var(--ds-font-size-lg)",
+    xl: "var(--ds-font-size-2xl)"
+  },
+  spacing: {
+    xs: "var(--ds-spacing-2)",
+    sm: "var(--ds-spacing-4)",
+    md: "var(--ds-spacing-6)",
+    lg: "var(--ds-spacing-8)",
+    xl: "var(--ds-spacing-10)"
+  },
+  radius: {
+    xs: "var(--ds-radius-sm)",
+    sm: "var(--ds-radius)",
+    md: "var(--ds-radius-md)",
+    lg: "var(--ds-radius-lg)",
+    xl: "var(--ds-radius-xl)"
+  },
+  shadows: {
+    xs: "var(--ds-shadow-sm)",
+    sm: "var(--ds-shadow-sm)",
+    md: "var(--ds-shadow)",
+    lg: "var(--ds-shadow-lg)",
+    xl: "var(--ds-shadow-xl)"
+  },
+  components: {
+    Button: {
+      styles: {
+        root: {
+          borderRadius: "var(--mantine-radius-xs)",
+          fontWeight: "400",
+          fontSize: "var(--mantine-font-size-md)",
+          padding: "0.5rem 1rem",
+          transition:
+            "color 0.15s ease-in-out, background-color 0.15s ease-in-out, border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out"
+        }
+      }
+    },
+    Input: {
+      styles: {
+        input: {
+          borderRadius: "var(--mantine-radius-xs)",
+          borderColor: "var(--mantine-color-gray-4)",
+          fontSize: "var(--mantine-font-size-md)",
+          padding: "0.5rem 1rem",
+          transition: "border-color 0.15s ease-in-out, box-shadow 0.15s ease-in-out"
+        }
+      }
+    },
+    Card: {
+      styles: {
+        root: {
+          borderRadius: "var(--mantine-radius-xs)",
+          borderColor: "var(--mantine-color-gray-4)",
+          padding: "1.5rem"
+        }
+      }
+    },
+    Paper: {
+      styles: {
+        root: {
+          borderRadius: "var(--mantine-radius-xs)"
+        }
+      }
+    },
+    Modal: {
+      styles: {
+        header: {
+          borderBottom: "1px solid var(--ds-gray-200)",
+          padding: "var(--ds-spacing-4)",
+          marginBottom: 0
+        },
+        title: {
+          fontWeight: 600,
+          fontSize: "var(--ds-font-size-lg)"
+        },
+        body: {
+          padding: "var(--ds-spacing-4)"
+        },
+        content: {
+          borderRadius: "var(--ds-radius-lg)"
+        },
+        close: {
+          color: "var(--ds-gray-500)"
+        }
+      }
+    },
+    Popover: {
+      styles: {
+        dropdown: {
+          borderRadius: "var(--mantine-radius-sm)",
+          boxShadow: "var(--mantine-shadow-md)",
+          padding: "var(--mantine-spacing-md)"
+        }
+      }
+    },
+    Badge: {
+      styles: {
+        root: {
+          borderRadius: "var(--mantine-radius-xs)",
+          fontSize: "0.875rem",
+          fontWeight: "700",
+          padding: "0.285em 0.571em"
+        }
+      }
+    },
+    TextInput: {
+      styles: {
+        label: {
+          fontSize: "var(--mantine-font-size-sm)",
+          fontWeight: "500",
+          marginBottom: "var(--mantine-spacing-xs)"
+        },
+        input: {
+          fontFamily: "var(--mantine-font-family)"
+        }
+      }
+    },
+    NumberInput: {
+      styles: {
+        label: {
+          fontSize: "var(--mantine-font-size-sm)",
+          fontWeight: "500",
+          marginBottom: "var(--mantine-spacing-xs)"
+        }
+      }
+    },
+    Group: {
+      defaultProps: {
+        gap: "sm"
+      }
+    },
+    Stack: {
+      defaultProps: {
+        gap: "md"
+      }
+    }
+  }
+});

package/dist/templates/lib/types/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Microbuild Types
+ * 
+ * Re-exports all type definitions.
+ * This file is copied to your project and can be customized.
+ */
+
+export * from './core';
+export * from './file';
+export * from './relations';

package/dist/templates/lib/utils-index.ts

@@ -0,0 +1,32 @@
+// @ts-nocheck
+/**
+ * Microbuild Utils
+ * 
+ * Re-exports all utility functions.
+ * This file is copied to your project and can be customized.
+ */
+
+// Basic utilities
+export { cn, formatFileSize, getFileCategory, getAssetUrl, slugify, slugify as generateSlug, debounce, isValidPrimaryKey, deepMerge, generateId } from '../common-utils';
+
+// Field interface mapping (from @microbuild/utils)
+export { 
+  getFieldInterface,
+  getFieldDefault,
+  type InterfaceType,
+  type InterfaceConfig,
+} from '../field-interface-mapper';
+
+// Field utilities
+export {
+  isFieldReadOnly,
+  isPresentationField,
+  getFieldValidation,
+  formatFieldValue,
+} from '../field-interface-mapper';
+
+// Interface type definitions
+export type {
+  InterfaceDefinition,
+  InterfaceGroup,
+} from '../interface-types';

package/dist/templates/lib/utils.ts

@@ -0,0 +1,14 @@
+/**
+ * Microbuild Utils - Barrel Export
+ * 
+ * This file re-exports all utilities from the utils folder.
+ * It exists to support both import patterns:
+ *   - import { cn } from '@/lib/microbuild/utils'     (folder import)
+ *   - import { cn } from '@/lib/microbuild/utils.ts'  (file import)
+ * 
+ * @microbuild-origin lib/utils
+ * @microbuild-version 1.0.0
+ */
+
+// Re-export everything from the utils folder
+export * from './utils/index';

package/dist/templates/lib/vform/index.ts

@@ -0,0 +1,24 @@
+/**
+ * VForm - Dynamic Form Component
+ * 
+ * Re-exports VForm and related components.
+ * This file is copied to your project and can be customized.
+ * 
+ * NOTE: Import paths must match actual file names (PascalCase for VForm folder)
+ */
+
+// Main VForm export - VForm.tsx uses PascalCase filename
+export { VForm } from './VForm';
+export type { VFormProps } from './VForm';
+
+// Component exports - files in components/ use PascalCase
+export { FormField } from './components/FormField';
+export type { FormFieldProps } from './components/FormField';
+
+export { FormFieldLabel } from './components/FormFieldLabel';
+
+export { FormFieldInterface } from './components/FormFieldInterface';
+export type { FormFieldInterfaceProps } from './components/FormFieldInterface';
+
+export * from './types';
+export * from './utils';

package/dist/templates/middleware/middleware.ts

@@ -0,0 +1,29 @@
+/**
+ * Next.js Middleware
+ * 
+ * Root middleware file that handles auth session refresh.
+ * This file is copied to your project by the Microbuild CLI.
+ * 
+ * @microbuild/origin: middleware
+ * @microbuild/version: 1.0.0
+ */
+
+import { type NextRequest } from 'next/server';
+import { updateSession } from '@/lib/supabase/middleware';
+
+export async function middleware(request: NextRequest) {
+  return await updateSession(request);
+}
+
+export const config = {
+  matcher: [
+    /*
+     * Match all request paths except for the ones starting with:
+     * - _next/static (static files)
+     * - _next/image (image optimization files)
+     * - favicon.ico (favicon file)
+     * - public folder
+     */
+    '/((?!_next/static|_next/image|favicon.ico|.*\\.(?:svg|png|jpg|jpeg|gif|webp)$).*)',
+  ],
+};

package/dist/templates/supabase/client.ts

@@ -0,0 +1,25 @@
+/**
+ * Supabase Browser Client
+ * 
+ * Client-side Supabase client for use in React components.
+ * This file is copied to your project by the Microbuild CLI.
+ * 
+ * @microbuild/origin: supabase/client
+ * @microbuild/version: 1.0.0
+ */
+
+import { createBrowserClient } from '@supabase/ssr';
+
+export function createClient() {
+  const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL;
+  const supabaseAnonKey = process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY;
+
+  if (!supabaseUrl || !supabaseAnonKey) {
+    throw new Error(
+      'Missing Supabase environment variables. ' +
+      'Please set NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY in .env.local'
+    );
+  }
+
+  return createBrowserClient(supabaseUrl, supabaseAnonKey);
+}

package/dist/templates/supabase/middleware.ts

@@ -0,0 +1,66 @@
+/**
+ * Supabase Auth Middleware
+ * 
+ * Refreshes auth tokens and protects routes.
+ * This file is copied to your project by the Microbuild CLI.
+ * 
+ * @microbuild/origin: supabase/middleware
+ * @microbuild/version: 1.0.0
+ */
+
+import { createServerClient } from '@supabase/ssr';
+import { NextResponse, type NextRequest } from 'next/server';
+
+export async function updateSession(request: NextRequest) {
+  const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL;
+  const supabaseAnonKey = process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY;
+
+  if (!supabaseUrl || !supabaseAnonKey) {
+    // Allow request to proceed but log warning
+    console.warn('Supabase not configured - auth middleware skipped');
+    return NextResponse.next({ request });
+  }
+
+  let supabaseResponse = NextResponse.next({ request });
+
+  const supabase = createServerClient(supabaseUrl, supabaseAnonKey, {
+    cookies: {
+      getAll() {
+        return request.cookies.getAll();
+      },
+      setAll(cookiesToSet) {
+        cookiesToSet.forEach(({ name, value }) =>
+          request.cookies.set(name, value)
+        );
+        supabaseResponse = NextResponse.next({ request });
+        cookiesToSet.forEach(({ name, value, options }) =>
+          supabaseResponse.cookies.set(name, value, options)
+        );
+      },
+    },
+  });
+
+  // IMPORTANT: Avoid writing any logic between createServerClient and
+  // supabase.auth.getUser(). A simple mistake could make it very hard to debug
+  // issues with users being randomly logged out.
+
+  const {
+    data: { user },
+  } = await supabase.auth.getUser();
+
+  // Define public routes that don't require authentication
+  const publicRoutes = ['/login', '/signup', '/auth', '/api/auth'];
+  const isPublicRoute = publicRoutes.some(route => 
+    request.nextUrl.pathname.startsWith(route)
+  );
+  const isApiRoute = request.nextUrl.pathname.startsWith('/api');
+
+  // Redirect unauthenticated users to login (except for public and API routes)
+  if (!user && !isPublicRoute && !isApiRoute) {
+    const url = request.nextUrl.clone();
+    url.pathname = '/login';
+    return NextResponse.redirect(url);
+  }
+
+  return supabaseResponse;
+}

package/dist/templates/supabase/server.ts

@@ -0,0 +1,45 @@
+/**
+ * Supabase Server Client
+ * 
+ * Server-side Supabase client for use in Server Components, API routes, and Server Actions.
+ * This file is copied to your project by the Microbuild CLI.
+ * 
+ * @microbuild/origin: supabase/server
+ * @microbuild/version: 1.0.0
+ */
+
+import { createServerClient } from '@supabase/ssr';
+import { cookies } from 'next/headers';
+
+export async function createClient() {
+  const supabaseUrl = process.env.NEXT_PUBLIC_SUPABASE_URL;
+  const supabaseAnonKey = process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY;
+
+  if (!supabaseUrl || !supabaseAnonKey) {
+    throw new Error(
+      'Missing Supabase environment variables. ' +
+      'Please set NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY in .env.local'
+    );
+  }
+
+  const cookieStore = await cookies();
+
+  return createServerClient(supabaseUrl, supabaseAnonKey, {
+    cookies: {
+      getAll() {
+        return cookieStore.getAll();
+      },
+      setAll(cookiesToSet) {
+        try {
+          cookiesToSet.forEach(({ name, value, options }) =>
+            cookieStore.set(name, value, options)
+          );
+        } catch {
+          // The `setAll` method was called from a Server Component.
+          // This can be ignored if you have middleware refreshing
+          // user sessions.
+        }
+      },
+    },
+  });
+}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@microbuild/cli",
+  "version": "0.1.0",
+  "description": "CLI tool for adding Microbuild components to your project - like shadcn/ui",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "microbuild": "dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/microbuild-ui/ui.git",
+    "directory": "packages/cli"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^11.1.0",
+    "fast-glob": "^3.3.2",
+    "fs-extra": "^11.2.0",
+    "ora": "^8.0.1",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^20.10.0",
+    "@types/prompts": "^2.4.9",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^2.1.9"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "cli",
+    "components",
+    "directus",
+    "cms",
+    "microbuild",
+    "shadcn",
+    "copy-own",
+    "ui"
+  ],
+  "author": "Microbuild",
+  "license": "MIT"
+}