@nextsparkjs/core 0.1.0-beta.2 → 0.1.0-beta.21

package/dist/templates/contents/themes/starter/config/dev.config.ts

@@ -30,42 +30,23 @@ export const DEV_CONFIG_OVERRIDES: DevConfig = {
     enabled: true,
     users: [
       // ========================================
-      // STARTER THEME TEST USERS
+      // STARTER THEME - INITIAL USERS ONLY
+      // These are the only users that exist after init.
+      // Additional users are created via sample data migrations.
       // ========================================
       {
         id: 'superadmin',
-        email: 'superadmin@starter.dev',
+        email: 'superadmin@nextspark.dev',
         name: 'Super Admin',
-        password: 'Test1234',
-        teamRoles: 'Starter Team (owner) - SUPERADMIN ROLE',
+        password: 'Pandora1234',
+        teamRoles: 'Initial Team (owner) - SUPERADMIN ROLE',
       },
       {
         id: 'developer',
-        email: 'developer@starter.dev',
+        email: 'developer@nextspark.dev',
         name: 'Developer',
-        password: 'Test1234',
-        teamRoles: 'Starter Team (admin) - DEVELOPER ROLE',
-      },
-      {
-        id: 'owner',
-        email: 'owner@starter.dev',
-        name: 'Team Owner',
-        password: 'Test1234',
-        teamRoles: 'Starter Team (owner)',
-      },
-      {
-        id: 'admin',
-        email: 'admin@starter.dev',
-        name: 'Team Admin',
-        password: 'Test1234',
-        teamRoles: 'Starter Team (admin)',
-      },
-      {
-        id: 'member',
-        email: 'member@starter.dev',
-        name: 'Team Member',
-        password: 'Test1234',
-        teamRoles: 'Starter Team (member)',
+        password: 'Pandora1234',
+        teamRoles: 'Initial Team (admin) - DEVELOPER ROLE',
       },
     ],
   },

package/dist/templates/contents/themes/starter/entities/tasks/tasks.config.ts

@@ -99,21 +99,6 @@ export const taskEntityConfig: EntityConfig = {
     ],
   },
 
-  // ==========================================
-  // 5. INTERNATIONALIZATION
-  // ==========================================
-  i18n: {
-    fallbackLocale: 'en',
-    loaders: {
-      en: () => import('./messages/en.json'),
-      es: () => import('./messages/es.json'),
-      fr: () => import('./messages/fr.json'),
-      it: () => import('./messages/it.json'),
-      de: () => import('./messages/de.json'),
-      pt: () => import('./messages/pt.json'),
-    },
-  },
-
   // ==========================================
   // FIELDS (imported from separate file)
   // ==========================================

package/dist/templates/contents/themes/starter/lib/.gitkeep

@@ -0,0 +1 @@
+# Add your theme-specific utilities and helpers here

package/dist/templates/contents/themes/starter/lib/hooks/index.ts

@@ -1 +1,2 @@
 export { useTaskStats } from './useTaskStats'
+export { useAnalyticsData } from './useAnalyticsData'

package/dist/templates/contents/themes/starter/lib/hooks/useTaskStats.ts

@@ -2,7 +2,7 @@
 
 import { useMemo } from 'react'
 import { useQuery } from '@tanstack/react-query'
-import { useTeamContext } from '@nextsparkjs/core/hooks/useTeamContext'
+import { useTeamContext } from '@nextsparkjs/core/contexts/TeamContext'
 import { calculateTaskStats, type TaskStats } from '../utils'
 
 interface Task {

package/dist/templates/contents/themes/starter/messages/de/public.json

@@ -0,0 +1,18 @@
+{
+  "home": {
+    "hero": {
+      "title": "Willkommen in Ihrer App",
+      "description": "Eine moderne SaaS-Anwendung gebaut mit NextSpark",
+      "cta": "Loslegen"
+    },
+    "features": {
+      "title": "Funktionen",
+      "subtitle": "Alles was Sie brauchen um Ihr SaaS zu bauen"
+    }
+  },
+  "footer": {
+    "copyright": "Alle Rechte vorbehalten.",
+    "privacyPolicy": "Datenschutzrichtlinie",
+    "termsOfService": "Nutzungsbedingungen"
+  }
+}

package/dist/templates/contents/themes/starter/messages/en/public.json

@@ -0,0 +1,18 @@
+{
+  "home": {
+    "hero": {
+      "title": "Welcome to Your App",
+      "description": "A modern SaaS application built with NextSpark",
+      "cta": "Get Started"
+    },
+    "features": {
+      "title": "Features",
+      "subtitle": "Everything you need to build your SaaS"
+    }
+  },
+  "footer": {
+    "copyright": "All rights reserved.",
+    "privacyPolicy": "Privacy Policy",
+    "termsOfService": "Terms of Service"
+  }
+}

package/dist/templates/contents/themes/starter/messages/es/public.json

@@ -0,0 +1,18 @@
+{
+  "home": {
+    "hero": {
+      "title": "Bienvenido a Tu App",
+      "description": "Una aplicación SaaS moderna construida con NextSpark",
+      "cta": "Comenzar"
+    },
+    "features": {
+      "title": "Características",
+      "subtitle": "Todo lo que necesitas para construir tu SaaS"
+    }
+  },
+  "footer": {
+    "copyright": "Todos los derechos reservados.",
+    "privacyPolicy": "Política de Privacidad",
+    "termsOfService": "Términos de Servicio"
+  }
+}

package/dist/templates/contents/themes/starter/messages/fr/public.json

@@ -0,0 +1,18 @@
+{
+  "home": {
+    "hero": {
+      "title": "Bienvenue dans Votre Application",
+      "description": "Une application SaaS moderne construite avec NextSpark",
+      "cta": "Commencer"
+    },
+    "features": {
+      "title": "Fonctionnalités",
+      "subtitle": "Tout ce dont vous avez besoin pour construire votre SaaS"
+    }
+  },
+  "footer": {
+    "copyright": "Tous droits réservés.",
+    "privacyPolicy": "Politique de Confidentialité",
+    "termsOfService": "Conditions d'Utilisation"
+  }
+}

package/dist/templates/contents/themes/starter/templates/(dashboard)/analytics/page.tsx

@@ -1,8 +1,6 @@
 import { Metadata } from 'next'
 import { getTranslations } from 'next-intl/server'
-import { StatsCard } from './components/StatsCard'
-import { TasksChart } from './components/TasksChart'
-import { RecentActivity } from './components/RecentActivity'
+import { StatsCard, TasksChart, RecentActivity } from '../../../components/analytics'
 
 export async function generateMetadata(): Promise<Metadata> {
   const t = await getTranslations('analytics')

package/dist/types/theme.d.ts

@@ -72,4 +72,29 @@ export interface ComponentOverride {
     priority?: number;
     [key: string]: any;
 }
+/**
+ * Template override configuration
+ * Used in auto-generated template registries
+ */
+export interface TemplateOverride {
+    name: string;
+    themeName: string;
+    templateType: string;
+    fileName: string;
+    relativePath: string;
+    appPath: string;
+    templatePath: string;
+    priority: number;
+    metadata?: any;
+}
+/**
+ * Template registry entry
+ * Used in auto-generated template registries
+ */
+export interface TemplateRegistryEntry {
+    appPath: string;
+    component: any;
+    template: TemplateOverride;
+    alternatives: TemplateOverride[];
+}
 //# sourceMappingURL=theme.d.ts.map

package/dist/types/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/types/theme.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KACnC,CAAA;IACD,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,UAAU,CAAC,EAAE,eAAe,CAAA;IAC5B,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/types/theme.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/core",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.21",
   "description": "NextSpark - The complete SaaS framework for Next.js",
   "license": "MIT",
   "author": "NextSpark <hello@nextspark.dev>",
@@ -44,6 +44,10 @@
       "types": "./dist/i18n.d.ts",
       "import": "./dist/i18n.js"
     },
+    "./config/protected-paths": {
+      "types": "./dist/config/protected-paths.d.ts",
+      "import": "./dist/config/protected-paths.js"
+    },
     "./globals.css": "./globals.css",
     "./theme-styles.css": "./theme-styles.css",
     "./styles/ui.css": {
@@ -150,6 +154,14 @@
       "types": "./dist/components/public/entities/index.d.ts",
       "import": "./dist/components/public/entities/index.js"
     },
+    "./components/public/pageBuilder": {
+      "types": "./dist/components/public/pageBuilder/index.d.ts",
+      "import": "./dist/components/public/pageBuilder/index.js"
+    },
+    "./components/public": {
+      "types": "./dist/components/public/index.d.ts",
+      "import": "./dist/components/public/index.js"
+    },
     "./components/superadmin/filters": {
       "types": "./dist/components/superadmin/filters/index.d.ts",
       "import": "./dist/components/superadmin/filters/index.js"
@@ -206,21 +218,16 @@
     "tests/cypress/support",
     "tests/jest/setup.ts",
     "tests/jest/__mocks__",
-    "bin/dist",
     "globals.css",
     "theme-styles.css",
     "README.md",
     "scripts"
   ],
-  "bin": {
-    "nextspark": "./bin/dist/init.js"
-  },
   "scripts": {
-    "build": "tsup && pnpm build:dts && pnpm build:ui-css && pnpm build:cli",
+    "build": "tsup && pnpm build:dts && pnpm build:ui-css",
     "build:js": "tsup",
     "build:dts": "tsc -p tsconfig.dts.json || echo '⚠️  DTS generation completed with some type errors (partial coverage)'",
     "build:ui-css": "node scripts/build/build-ui-css.mjs",
-    "build:cli": "tsc -p bin/tsconfig.json",
     "dev": "tsup --watch",
     "test": "jest",
     "test:watch": "jest --watch",

package/scripts/build/registry/config.mjs

@@ -4,6 +4,11 @@
  * Central configuration for the registry build process.
  * Contains paths, flags, and content type definitions.
  *
+ * Supports three modes:
+ * 1. Monorepo mode: themes/plugins at repo root as workspace packages
+ * 2. NPM mode: @nextsparkjs/core installed in node_modules
+ * 3. User project mode: themes/plugins in contents/ directory
+ *
  * @module core/scripts/build/registry/config
  */
 
@@ -13,10 +18,13 @@ import { existsSync } from 'fs'
 import dotenv from 'dotenv'
 import { loadNextSparkConfigSync } from '../config-loader.mjs'
 
-// Load .env BEFORE accessing process.env
-// This must happen before CONFIG is defined since ES modules
-// execute imports before the importing module's code runs
-dotenv.config()
+// Load .env from the correct project root
+// Priority: NEXTSPARK_PROJECT_ROOT env var > cwd
+// This is critical for npm mode where cwd might be node_modules/@nextsparkjs/core
+const envPath = process.env.NEXTSPARK_PROJECT_ROOT
+  ? join(process.env.NEXTSPARK_PROJECT_ROOT, '.env')
+  : undefined
+dotenv.config({ path: envPath, override: true })
 
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = dirname(__filename)
@@ -24,11 +32,37 @@ const __dirname = dirname(__filename)
 // Root directory (5 levels up from packages/core/scripts/build/registry/)
 export const rootDir = join(__dirname, '../../../../..')
 
+/**
+ * Detect monorepo root by searching for pnpm-workspace.yaml
+ * @param {string} startDir - Directory to start searching from
+ * @returns {string|null} Monorepo root path or null if not in monorepo
+ */
+export function detectMonorepoRoot(startDir = process.cwd()) {
+  let dir = startDir
+  const maxDepth = 10
+  let depth = 0
+
+  while (dir !== '/' && depth < maxDepth) {
+    if (existsSync(join(dir, 'pnpm-workspace.yaml'))) {
+      return dir
+    }
+    dir = dirname(dir)
+    depth++
+  }
+
+  return null
+}
+
 /**
  * Detect project root by searching for nextspark.config.ts or apps/dev in monorepo
  * @returns {string} Project root path
  */
 export function detectProjectRoot() {
+  // Check for explicit project root from CLI
+  if (process.env.NEXTSPARK_PROJECT_ROOT) {
+    return process.env.NEXTSPARK_PROJECT_ROOT
+  }
+
   let dir = process.cwd()
   const maxDepth = 10
   let depth = 0
@@ -72,6 +106,10 @@ export function getConfig(projectRoot = null) {
   // Check if running in npm mode
   const isNpmMode = isInstalledAsPackage(root)
 
+  // Check if running in monorepo mode
+  const monorepoRoot = detectMonorepoRoot(root)
+  const isMonorepoMode = !isNpmMode && monorepoRoot !== null
+
   // Determine paths based on mode
   const coreDir = isNpmMode
     ? join(root, 'node_modules/@nextsparkjs/core')
@@ -84,12 +122,33 @@ export function getConfig(projectRoot = null) {
   // Load nextspark.config.ts for features and other settings
   const nextsparkConfig = loadNextSparkConfigSync(root)
 
+  // Determine content directories based on mode
+  // Monorepo: themes/plugins at repo root as workspace packages
+  // User project: themes/plugins in contents/ directory
+  let contentsDir, themesDir, pluginsDir
+
+  if (isMonorepoMode) {
+    // Monorepo mode: themes and plugins are at the repo root
+    contentsDir = join(monorepoRoot, 'contents') // Legacy, kept for compatibility
+    themesDir = join(monorepoRoot, 'themes')
+    pluginsDir = join(monorepoRoot, 'plugins')
+  } else {
+    // User project mode (npm or standalone)
+    contentsDir = join(root, 'contents')
+    themesDir = join(root, 'contents/themes')
+    pluginsDir = join(root, 'contents/plugins')
+  }
+
   return {
     projectRoot: root,
+    monorepoRoot,
     isNpmMode,
+    isMonorepoMode,
     coreDir,
     outputDir,
-    contentsDir: join(root, 'contents'),
+    contentsDir,
+    themesDir,
+    pluginsDir,
     watchMode: process.argv.includes('--watch') && !process.argv.includes('--build'),
     buildMode: process.argv.includes('--build'),
     verbose: process.argv.includes('--verbose') || process.argv.includes('-v'),

package/scripts/build/registry/discovery/blocks.mjs

@@ -28,7 +28,7 @@ export async function discoverBlocks(config = DEFAULT_CONFIG) {
   }
 
   const themeName = config.activeTheme
-  const blocksDir = join(config.contentsDir, 'themes', themeName, 'blocks')
+  const blocksDir = join(config.themesDir, themeName, 'blocks')
 
   // Check if blocks directory exists
   try {

package/scripts/build/registry/discovery/middlewares.mjs

@@ -18,7 +18,7 @@ import { verbose } from '../../../utils/index.mjs'
  * @returns {Promise<Array>} Array of discovered middlewares
  */
 export async function discoverMiddlewares(config = DEFAULT_CONFIG) {
-  const themesDir = join(config.contentsDir, 'themes')
+  const themesDir = config.themesDir
   const middlewares = []
 
   // Only check the active theme if specified

package/scripts/build/registry/discovery/parent-child.mjs

@@ -29,11 +29,10 @@ export async function discoverParentChildRelations(config = DEFAULT_CONFIG) {
   const childTypeMappings = new Map()
 
   // Scan all discovered entities to find parent-child patterns in filesystem
-  const contentsDir = config.contentsDir
   const scanDirs = [
-    join(contentsDir, 'themes'),
-    join(contentsDir, 'plugins'),
-    join(contentsDir, 'entities')
+    config.themesDir,
+    config.pluginsDir,
+    join(config.contentsDir, 'entities')
   ]
 
   for (const baseDir of scanDirs) {

package/scripts/build/registry/discovery/permissions.mjs

@@ -159,7 +159,7 @@ export async function discoverPermissionsConfig(config = DEFAULT_CONFIG) {
     return null
   }
 
-  const permissionsPath = join(config.contentsDir, 'themes', themeName, 'config', 'permissions.config.ts')
+  const permissionsPath = join(config.themesDir, themeName, 'config', 'permissions.config.ts')
 
   if (!existsSync(permissionsPath)) {
     log(`No permissions.config.ts found for theme ${themeName}`, 'info')

package/scripts/build/registry/discovery/plugins.mjs

@@ -1,7 +1,9 @@
 /**
  * Plugin Discovery
  *
- * Discovers plugins and their API routes from contents/plugins
+ * Discovers plugins and their API routes.
+ * In monorepo mode: plugins/ at repo root
+ * In user project mode: contents/plugins/
  *
  * @module core/scripts/build/registry/discovery/plugins
  */
@@ -43,7 +45,7 @@ async function getActiveThemePlugins(config) {
     return null // null means no filtering
   }
 
-  const themeConfigPath = join(config.contentsDir, 'themes', config.activeTheme, 'config', 'theme.config.ts')
+  const themeConfigPath = join(config.themesDir, config.activeTheme, 'config', 'theme.config.ts')
 
   try {
     const configContent = await readFile(themeConfigPath, 'utf8')
@@ -63,7 +65,7 @@ async function getActiveThemePlugins(config) {
 }
 
 /**
- * Discover plugins from contents/plugins directory
+ * Discover plugins
  * @param {object} config - Optional configuration object (defaults to DEFAULT_CONFIG)
  * @returns {Promise<Array>} Array of discovered plugins
  */
@@ -71,7 +73,7 @@ export async function discoverPlugins(config = DEFAULT_CONFIG) {
   // Get plugins from nextspark.config.ts or theme config
   const allowedPlugins = await getActivePlugins(config)
 
-  const pluginsDir = join(config.contentsDir, 'plugins')
+  const pluginsDir = config.pluginsDir
   const plugins = []
 
   try {

package/scripts/build/registry/discovery/templates.mjs

@@ -23,7 +23,7 @@ import {
  */
 export async function discoverTemplates(config = DEFAULT_CONFIG) {
   log('Discovering template overrides...', 'info')
-  const themesDir = join(config.contentsDir, 'themes')
+  const themesDir = config.themesDir
   const templates = []
 
   // REQUIRED: Active theme must be specified

package/scripts/build/registry/discovery/themes.mjs

@@ -1,7 +1,9 @@
 /**
  * Theme Discovery
  *
- * Discovers themes and their configurations from contents/themes
+ * Discovers themes and their configurations.
+ * In monorepo mode: themes/ at repo root
+ * In user project mode: contents/themes/
  *
  * @module core/scripts/build/registry/discovery/themes
  */
@@ -15,12 +17,12 @@ import { verbose, extractExportName, extractHttpMethods } from '../../../utils/i
 import { discoverNestedEntities } from './entities.mjs'
 
 /**
- * Discover all themes in contents/themes/
+ * Discover all themes
  * @param {object} config - Optional configuration object (defaults to DEFAULT_CONFIG)
  * @returns {Promise<Array>} Array of discovered themes
  */
 export async function discoverThemes(config = DEFAULT_CONFIG) {
-  const themesDir = join(config.contentsDir, 'themes')
+  const themesDir = config.themesDir
   const themes = []
 
   // Only process the active theme if specified

package/scripts/build/registry/generators/billing-registry.mjs

@@ -109,13 +109,15 @@ export type { BillingConfig, PlanDefinition, FeatureDefinition, LimitDefinition
  */
 export async function generateBillingRegistry(activeTheme, contentsDir, config) {
   const themeName = activeTheme || 'default'
-  const billingConfigPath = join(contentsDir, 'themes', themeName, 'config', 'billing.config.ts')
+  // Use config.themesDir for monorepo support (contentsDir kept for backward compatibility)
+  const themesDir = config.themesDir || join(contentsDir, 'themes')
+  const billingConfigPath = join(themesDir, themeName, 'config', 'billing.config.ts')
 
   // Check if billing config exists for active theme
   if (!existsSync(billingConfigPath)) {
     log(`No billing config found for theme '${themeName}', using default`, 'warning')
     // Fall back to default theme
-    const defaultPath = join(contentsDir, 'themes', 'default', 'config', 'billing.config.ts')
+    const defaultPath = join(themesDir, 'default', 'config', 'billing.config.ts')
     if (!existsSync(defaultPath)) {
       log('No billing config found for default theme either!', 'error')
       return generateEmptyBillingRegistry(config)
@@ -125,7 +127,7 @@ export async function generateBillingRegistry(activeTheme, contentsDir, config)
   // Dynamically import the billing config at build time
   const themePath = existsSync(billingConfigPath) ? themeName : 'default'
   // Use file:// URL for ESM dynamic import
-  const absolutePath = join(contentsDir, 'themes', themePath, 'config', 'billing.config.ts')
+  const absolutePath = join(themesDir, themePath, 'config', 'billing.config.ts')
 
   let billingConfig
   try {

package/scripts/build/registry/generators/block-registry.mjs

@@ -27,12 +27,15 @@ export function generateBlockRegistry(blocks, config) {
  * DO NOT EDIT - This file is auto-generated by scripts/build-registry.mjs
  */
 
+import React from 'react'
 import type { BlockConfig } from '${convertCorePath('@/core/types/blocks', outputFilePath, config)}'
 
 export const BLOCK_REGISTRY: Record<string, BlockConfig> = {}
 
 export const BLOCK_CATEGORIES: string[] = []
 
+export const BLOCK_COMPONENTS: Record<string, React.LazyExoticComponent<React.ComponentType<any>>> = {}
+
 export const BLOCK_METADATA = {
   totalBlocks: 0,
   categories: [],

package/scripts/build/registry/generators/feature-registry.mjs

@@ -274,7 +274,7 @@ export interface FeatureEntry {
   key: string
   name: string
   description: string
-  category: 'core' | 'entities' | 'content' | 'settings' | 'admin'
+  category: 'core' | 'entities' | 'content' | 'settings' | 'admin' | 'public'
   icon: string
   tag: string
   testing: FeatureTesting
@@ -284,7 +284,7 @@ export interface FlowEntry {
   key: string
   name: string
   description: string
-  category: 'acquisition' | 'navigation' | 'content' | 'settings' | 'admin'
+  category: 'acquisition' | 'navigation' | 'content' | 'settings' | 'admin' | 'public'
   icon: string
   tag: string
   criticalPath?: boolean
@@ -369,12 +369,15 @@ export type FlowCategory = FlowEntry['category']
 /**
  * Main generator function - orchestrates the full generation
  * @param {string} themeName - Active theme name
- * @param {string} contentsDir - Path to contents directory
+ * @param {string} contentsDir - Path to contents directory (legacy, use config.themesDir instead)
  * @param {string} outputDir - Path for registry output
+ * @param {object} config - Optional configuration object from getConfig()
  * @returns {Object} Generation result
  */
-export async function generateFeatureRegistryFull(themeName, contentsDir, outputDir) {
-  const themePath = join(contentsDir, 'themes', themeName)
+export async function generateFeatureRegistryFull(themeName, contentsDir, outputDir, config = null) {
+  // Use config.themesDir for monorepo support, fall back to contentsDir/themes
+  const themesDir = config?.themesDir || join(contentsDir, 'themes')
+  const themePath = join(themesDir, themeName)
   const testsDir = join(themePath, 'tests', 'cypress', 'e2e')
 
   // Load configs
@@ -385,7 +388,7 @@ export async function generateFeatureRegistryFull(themeName, contentsDir, output
   const blocks = loadBlockSlugs(outputDir)
 
   // Discover tags from tests
-  const rootDir = join(contentsDir, '..')
+  const rootDir = config?.monorepoRoot || join(contentsDir, '..')
   const discoveredTags = discoverTestTags(testsDir, rootDir)
 
   // Validate (includes block tag validation)

package/scripts/build/registry/generators/route-handlers.mjs

@@ -22,9 +22,36 @@
  * @returns {string} Generated TypeScript content
  */
 export function generateRouteHandlersRegistry(plugins, themes, coreRoutes = [], entities = [], config) {
+  // Filter themes by activeTheme if set (monorepo optimization)
+  let filteredThemes = themes
+  let filteredPlugins = plugins
+  let requiredPluginNames = []
+
+  if (config.activeTheme) {
+    // Only include the active theme
+    filteredThemes = themes.filter(t => t.name === config.activeTheme)
+
+    // Get required plugins from the active theme's plugins array
+    const activeTheme = filteredThemes[0]
+    if (activeTheme && activeTheme.plugins && activeTheme.plugins.length > 0) {
+      // plugins can be full names like '@nextsparkjs/plugin-langchain' or just 'langchain'
+      requiredPluginNames = activeTheme.plugins.map(p =>
+        p.replace('@nextsparkjs/plugin-', '').replace(/['"]/g, '')
+      )
+    }
+
+    // Filter plugins to only include required ones by the active theme
+    if (requiredPluginNames.length > 0) {
+      filteredPlugins = plugins.filter(p => requiredPluginNames.includes(p.name))
+    } else {
+      // If no required plugins specified, don't include any plugin routes
+      filteredPlugins = []
+    }
+  }
+
   // Collect all route handlers from themes
   const themeRoutes = []
-  themes.forEach(theme => {
+  filteredThemes.forEach(theme => {
     if (theme.routeFiles && theme.routeFiles.length > 0) {
       theme.routeFiles.forEach(route => {
         const routeKey = route.relativePath === '/' ? '' : route.relativePath
@@ -41,7 +68,7 @@ export function generateRouteHandlersRegistry(plugins, themes, coreRoutes = [],
 
   // Collect all route handlers from plugins
   const pluginRoutes = []
-  plugins.forEach(plugin => {
+  filteredPlugins.forEach(plugin => {
     if (plugin.routeFiles && plugin.routeFiles.length > 0) {
       plugin.routeFiles.forEach(route => {
         const routeKey = route.relativePath === '/' ? '' : route.relativePath