@nextsparkjs/core 0.1.0-beta.27 → 0.1.0-beta.28

package/dist/templates/contents/themes/starter/docs/superadmin/01-setup/01-configuration.md

@@ -0,0 +1,31 @@
+# Admin Configuration
+
+This guide covers the configuration options available to administrators.
+
+## Environment Variables
+
+Configure your application through environment variables:
+
+```bash
+# Database
+DATABASE_URL="postgresql://..."
+
+# Authentication
+BETTER_AUTH_SECRET="your-secret"
+
+# Application
+NEXT_PUBLIC_APP_URL="https://your-domain.com"
+```
+
+## Configuration Files
+
+Customize your application through config files in `config/`:
+
+- `app.config.ts` - Main application settings
+- `permissions.config.ts` - Roles and permissions
+- `billing.config.ts` - Subscription plans
+- `dev.config.ts` - Development settings
+
+## Next Steps
+
+Refer to the main documentation for detailed guides on each configuration area.

package/dist/templates/contents/themes/starter/tests/cypress.config.ts

@@ -2,17 +2,17 @@
  * Cypress Configuration for Starter Theme
  *
  * This config is self-contained for npm projects created with `nextspark init`.
- * Run with: pnpm cy:open
+ * Run with: pnpm cy:open or pnpm cy:run
+ *
+ * Filter by tags: pnpm cy:tags "@smoke" or pnpm cy:run --env grepTags="@smoke"
  */
 
 import { defineConfig } from 'cypress'
 import path from 'path'
 import fs from 'fs'
-import { fileURLToPath } from 'url'
 
-// ESM-compatible __dirname
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = path.dirname(__filename)
+// __dirname is available because ts-node processes this file as CommonJS
+// (Next.js projects don't use "type": "module" in package.json)
 
 // Paths relative to this config file
 const themeRoot = path.resolve(__dirname, '..')

package/dist/templates/scripts/cy-tags.cjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * Cypress Tags Runner
+ *
+ * A wrapper script that converts --tags to --env grepTags for @cypress/grep
+ *
+ * Usage:
+ *   pnpm cy:tags "@smoke"           # Run tests with @smoke tag
+ *   pnpm cy:tags "@P0+@auth"        # Run tests with @P0 AND @auth tags
+ *   pnpm cy:tags "@smoke @auth"     # Run tests with @smoke OR @auth tags
+ *   pnpm cy:tags "-@slow"           # Exclude tests with @slow tag
+ *   pnpm cy:tags "@smoke" --headed  # Run with browser visible
+ */
+
+const { spawnSync } = require('child_process')
+const path = require('path')
+const fs = require('fs')
+
+// Get arguments after script name
+const args = process.argv.slice(2)
+
+// First argument is the tag(s), rest are additional cypress args
+const tags = args[0] || ''
+const extraArgs = args.slice(1)
+
+// Find the active theme's cypress config
+function findCypressConfig() {
+  const contentsDir = path.join(process.cwd(), 'contents', 'themes')
+
+  if (!fs.existsSync(contentsDir)) {
+    console.error('Error: contents/themes directory not found')
+    process.exit(1)
+  }
+
+  const themes = fs.readdirSync(contentsDir).filter((name) => {
+    const themePath = path.join(contentsDir, name)
+    return fs.statSync(themePath).isDirectory()
+  })
+
+  // Check NEXT_PUBLIC_ACTIVE_THEME env var first
+  const activeTheme = process.env.NEXT_PUBLIC_ACTIVE_THEME
+
+  if (activeTheme && themes.includes(activeTheme)) {
+    const configPath = path.join(contentsDir, activeTheme, 'tests', 'cypress.config.ts')
+    if (fs.existsSync(configPath)) {
+      return configPath
+    }
+  }
+
+  // Otherwise use the first theme found
+  for (const theme of themes) {
+    const configPath = path.join(contentsDir, theme, 'tests', 'cypress.config.ts')
+    if (fs.existsSync(configPath)) {
+      return configPath
+    }
+  }
+
+  console.error('Error: No cypress.config.ts found in any theme')
+  process.exit(1)
+}
+
+const configFile = findCypressConfig()
+
+// Build cypress arguments
+const cypressArgs = ['cypress', 'run', '--config-file', configFile]
+
+if (tags) {
+  cypressArgs.push('--env', `grepTags=${tags}`)
+}
+
+// Add any extra arguments
+cypressArgs.push(...extraArgs)
+
+console.log(`Running: npx ${cypressArgs.join(' ')}`)
+
+// Execute cypress
+const result = spawnSync('npx', cypressArgs, {
+  stdio: 'inherit',
+  shell: true,
+  cwd: process.cwd(),
+})
+
+process.exit(result.status || 0)

package/dist/types/docs.d.ts

@@ -3,26 +3,31 @@
  *
  * Type definitions for the documentation registry system.
  * Used by the auto-generated docs-registry.ts file.
+ *
+ * Structure:
+ * - public: User-facing documentation → /docs
+ * - superadmin: Admin documentation → /superadmin/docs
+ *
+ * NOTE: Plugin docs are NOT included in the registry - they are for developer
+ * reference only (IDE/LLM). End users see public documentation at /docs routes.
  */
 export interface DocPageMeta {
     slug: string;
     title: string;
     order: number;
     path: string;
-    source: 'core' | 'theme' | 'plugin';
+    source: 'public' | 'superadmin';
 }
 export interface DocSectionMeta {
     title: string;
     slug: string;
     order: number;
     pages: DocPageMeta[];
-    source: 'core' | 'theme' | 'plugin';
-    pluginName?: string;
+    source: 'public' | 'superadmin';
 }
 export interface DocsRegistryStructure {
-    core: DocSectionMeta[];
-    theme: DocSectionMeta[];
-    plugins: DocSectionMeta[];
+    public: DocSectionMeta[];
+    superadmin: DocSectionMeta[];
     all: DocSectionMeta[];
 }
 //# sourceMappingURL=docs.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/types/docs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IACnC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,cAAc,EAAE,CAAA;IACtB,KAAK,EAAE,cAAc,EAAE,CAAA;IACvB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,GAAG,EAAE,cAAc,EAAE,CAAA;CACtB"}
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/types/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAA;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,MAAM,EAAE,QAAQ,GAAG,YAAY,CAAA;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,GAAG,EAAE,cAAc,EAAE,CAAA;CACtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/core",
-  "version": "0.1.0-beta.27",
+  "version": "0.1.0-beta.28",
   "description": "NextSpark - The complete SaaS framework for Next.js",
   "license": "MIT",
   "author": "NextSpark <hello@nextspark.dev>",

package/scripts/build/docs-registry.mjs

@@ -3,9 +3,15 @@
 /**
  * Documentation Registry Builder
  *
- * Scans core/docs/, contents/themes/{THEME}/docs/, and plugin docs directories
+ * Scans contents/themes/{THEME}/docs/public/ and docs/superadmin/ directories
  * Generates static registry at .nextspark/registries/docs-registry.ts
  *
+ * Structure:
+ * - public: User-facing documentation → /docs
+ * - superadmin: Admin documentation → /superadmin/docs
+ *
+ * NOTE: Plugin docs are NOT included - they are for developer reference only (IDE/LLM).
+ *
  * ZERO RUNTIME I/O - Build-time only
  * Part of the registry system
  */
@@ -61,12 +67,12 @@ console.log(`📚 Building docs registry...`)
 console.log(`   Project root: ${PROJECT_ROOT}`)
 console.log(`   Mode: ${IS_NPM_MODE ? 'NPM' : 'Monorepo'}`)
 
-// Paths based on mode
-const CORE_DIR = IS_NPM_MODE
-  ? path.join(PROJECT_ROOT, 'node_modules/@nextsparkjs/core')
-  : path.join(PROJECT_ROOT, 'packages/core')
-
-const CONTENTS_DIR = path.join(PROJECT_ROOT, 'contents')
+// Paths - themes directory
+// In NPM mode: contents/themes
+// In Monorepo mode: themes/ (directly in root)
+const THEMES_DIR = IS_NPM_MODE
+  ? path.join(PROJECT_ROOT, 'contents/themes')
+  : path.join(PROJECT_ROOT, 'themes')
 
 const OUTPUT_DIR = path.join(PROJECT_ROOT, '.nextspark/registries')
 
@@ -77,7 +83,7 @@ const ROOT_DIR = PROJECT_ROOT
  * Scan a documentation directory and build registry metadata
  *
  * @param {string} docsPath - Absolute path to docs directory
- * @param {'core' | 'theme' | 'plugin'} source - Source type
+ * @param {'theme' | 'plugin'} source - Source type
  * @returns {Array} Array of section metadata
  */
 function scanDocsDirectory(docsPath, source) {
@@ -161,75 +167,6 @@ function slugToTitle(slug) {
     .join(' ')
 }
 
-/**
- * Get active plugins from theme configuration
- */
-function getActiveThemePlugins(activeTheme) {
-  const themeConfigPath = path.join(CONTENTS_DIR, 'themes', activeTheme, 'theme.config.ts')
-
-  try {
-    const configContent = fs.readFileSync(themeConfigPath, 'utf8')
-
-    // Extract plugin dependencies from theme config
-    const pluginsMatch = configContent.match(/plugins:\s*\[([^\]]+)\]/)
-    const plugins = pluginsMatch
-      ? pluginsMatch[1].split(',').map(p => p.trim().replace(/['"]/g, '')).filter(Boolean)
-      : []
-
-    return plugins
-  } catch (error) {
-    console.log(`   Warning: Could not read theme config: ${error.message}`)
-    return []
-  }
-}
-
-/**
- * Read app config to check if plugin docs should be shown in production
- */
-function shouldShowPluginDocsInProd(activeTheme) {
-  const appConfigPath = path.join(CONTENTS_DIR, 'themes', activeTheme, 'app.config.ts')
-
-  try {
-    const configContent = fs.readFileSync(appConfigPath, 'utf8')
-
-    // Look for showPluginsDocsInProd setting
-    const match = configContent.match(/showPluginsDocsInProd:\s*(true|false)/)
-    if (match) {
-      return match[1] === 'true'
-    }
-
-    // Default to false if not found
-    return false
-  } catch (error) {
-    console.log(`   Warning: Could not read app config: ${error.message}`)
-    return false
-  }
-}
-
-/**
- * Scan plugin docs directories for all active plugins
- */
-function scanPluginDocs(activePlugins) {
-  const allPluginDocs = []
-
-  for (const pluginName of activePlugins) {
-    const pluginDocsPath = path.join(CONTENTS_DIR, 'plugins', pluginName, 'docs')
-
-    if (!fs.existsSync(pluginDocsPath)) {
-      continue
-    }
-
-    const sections = scanDocsDirectory(pluginDocsPath, 'plugin')
-
-    // Add plugin context to each section
-    for (const section of sections) {
-      section.pluginName = pluginName
-      allPluginDocs.push(section)
-    }
-  }
-
-  return allPluginDocs
-}
 
 /**
  * Build the documentation registry
@@ -238,49 +175,35 @@ async function buildDocsRegistry() {
   const activeTheme = process.env.NEXT_PUBLIC_ACTIVE_THEME || 'default'
   console.log(`   Active theme: ${activeTheme}`)
 
-  // Scan core docs
-  const coreDocsPath = path.join(CORE_DIR, 'docs')
-  const coreDocs = scanDocsDirectory(coreDocsPath, 'core')
-  console.log(`   Core sections: ${coreDocs.length}`)
+  const themeDocsDir = path.join(THEMES_DIR, activeTheme, 'docs')
 
-  // Scan theme docs
-  const themeDocs = scanDocsDirectory(
-    path.join(CONTENTS_DIR, `themes/${activeTheme}/docs`),
-    'theme'
+  // Scan public docs (user-facing → /docs)
+  const publicDocs = scanDocsDirectory(
+    path.join(themeDocsDir, 'public'),
+    'public'
   )
-  console.log(`   Theme sections: ${themeDocs.length}`)
-
-  // Scan plugin docs (conditionally based on environment and config)
-  const isProd = process.env.NODE_ENV === 'production'
-  const showPluginDocsInProd = shouldShowPluginDocsInProd(activeTheme)
-  const shouldIncludePluginDocs = !isProd || showPluginDocsInProd
+  console.log(`   Public sections: ${publicDocs.length}`)
 
-  let pluginDocs = []
-  if (shouldIncludePluginDocs) {
-    const activePlugins = getActiveThemePlugins(activeTheme)
-    console.log(`   Active plugins: [${activePlugins.join(', ')}]`)
-
-    pluginDocs = scanPluginDocs(activePlugins)
-    console.log(`   Plugin sections: ${pluginDocs.length}`)
-
-    if (pluginDocs.length > 0) {
-      const pluginPages = pluginDocs.reduce((sum, section) => sum + section.pages.length, 0)
-      console.log(`   Plugin pages: ${pluginPages}`)
-    }
-  } else {
-    console.log(`   Plugin docs: EXCLUDED (production + showPluginsDocsInProd: false)`)
-  }
+  // Scan superadmin docs (admin-facing → /superadmin/docs)
+  const superadminDocs = scanDocsDirectory(
+    path.join(themeDocsDir, 'superadmin'),
+    'superadmin'
+  )
+  console.log(`   Superadmin sections: ${superadminDocs.length}`)
 
-  // Merge and create registry
+  // Create registry (public + superadmin, no plugins)
   const registry = {
-    core: coreDocs,
-    theme: themeDocs,
-    plugins: pluginDocs,
-    all: [...coreDocs, ...themeDocs, ...pluginDocs].sort((a, b) => a.order - b.order)
+    public: publicDocs,
+    superadmin: superadminDocs,
+    all: [...publicDocs, ...superadminDocs].sort((a, b) => a.order - b.order)
   }
 
   // Total pages count
-  const totalPages = registry.all.reduce((sum, section) => sum + section.pages.length, 0)
+  const publicPages = publicDocs.reduce((sum, section) => sum + section.pages.length, 0)
+  const superadminPages = superadminDocs.reduce((sum, section) => sum + section.pages.length, 0)
+  const totalPages = publicPages + superadminPages
+  console.log(`   Public pages: ${publicPages}`)
+  console.log(`   Superadmin pages: ${superadminPages}`)
   console.log(`   Total pages: ${totalPages}`)
 
   // Generate TypeScript registry file
@@ -288,60 +211,61 @@ async function buildDocsRegistry() {
  * Auto-generated Documentation Registry
  *
  * Generated at: ${new Date().toISOString()}
- * Core sections: ${coreDocs.length}
- * Theme sections: ${themeDocs.length}
- * Plugin sections: ${pluginDocs.length}
+ * Public sections: ${publicDocs.length}
+ * Superadmin sections: ${superadminDocs.length}
  * Total pages: ${totalPages}
  *
+ * Structure:
+ * - public: User-facing documentation → /docs
+ * - superadmin: Admin documentation → /superadmin/docs
+ *
+ * NOTE: Plugin docs are NOT included - they are for developer reference only (IDE/LLM).
+ *
  * DO NOT EDIT - This file is auto-generated by scripts/build/docs-registry.mjs
  */
 
 import type { DocPageMeta, DocSectionMeta, DocsRegistryStructure } from '@nextsparkjs/core/types/docs'
 
+// Re-export types for external use
+export type { DocPageMeta, DocSectionMeta, DocsRegistryStructure }
+
 export const DOCS_REGISTRY: DocsRegistryStructure = ${JSON.stringify(registry, null, 2)} as const
 
 export type DocsRegistry = typeof DOCS_REGISTRY
 
 /**
- * Get all documentation sections (core + theme + plugins)
+ * Get all documentation sections (public + superadmin)
  */
 export function getAllDocSections(): DocSectionMeta[] {
   return DOCS_REGISTRY.all
 }
 
 /**
- * Get core documentation sections only
- */
-export function getCoreDocSections(): DocSectionMeta[] {
-  return DOCS_REGISTRY.core
-}
-
-/**
- * Get theme documentation sections only
+ * Get public documentation sections only (for /docs)
  */
-export function getThemeDocSections(): DocSectionMeta[] {
-  return DOCS_REGISTRY.theme
+export function getPublicDocSections(): DocSectionMeta[] {
+  return DOCS_REGISTRY.public
 }
 
 /**
- * Get plugin documentation sections only
+ * Get superadmin documentation sections only (for /superadmin/docs)
  */
-export function getPluginDocSections(): DocSectionMeta[] {
-  return DOCS_REGISTRY.plugins
+export function getSuperadminDocSections(): DocSectionMeta[] {
+  return DOCS_REGISTRY.superadmin
 }
 
 /**
- * Get documentation sections for a specific plugin
+ * Find a section by slug
  */
-export function getPluginDocSectionsByName(pluginName: string): DocSectionMeta[] {
-  return DOCS_REGISTRY.plugins.filter(section => section.pluginName === pluginName)
+export function findDocSection(slug: string): DocSectionMeta | undefined {
+  return DOCS_REGISTRY.all.find(section => section.slug === slug)
 }
 
 /**
- * Find a section by slug
+ * Find a section by slug in a specific category
  */
-export function findDocSection(slug: string): DocSectionMeta | undefined {
-  return DOCS_REGISTRY.all.find(section => section.slug === slug)
+export function findDocSectionInCategory(slug: string, category: 'public' | 'superadmin'): DocSectionMeta | undefined {
+  return DOCS_REGISTRY[category].find(section => section.slug === slug)
 }
 
 /**

package/templates/contents/themes/starter/config/app.config.ts

@@ -98,25 +98,28 @@ export const APP_CONFIG_OVERRIDES = {
   // =============================================================================
   // DOCUMENTATION
   // =============================================================================
+  /**
+   * Documentation system configuration
+   *
+   * Structure:
+   * - public: User-facing documentation at /docs
+   * - superadmin: Admin documentation at /superadmin/docs
+   *
+   * NOTE: Plugin docs are NOT in the registry - they are for developer reference only (IDE/LLM).
+   */
   docs: {
     enabled: true,
-    public: true,
+    publicAccess: true,
     searchEnabled: true,
     breadcrumbs: true,
-    theme: {
+    public: {
       enabled: true,
       open: true,
-      label: 'Starter',
+      label: 'Documentation',
     },
-    plugins: {
+    superadmin: {
       enabled: true,
-      open: false,
-      label: 'Plugins',
-    },
-    core: {
-      enabled: true,
-      open: true,
-      label: 'Core',
+      label: 'Admin Docs',
     },
   },
 

package/templates/contents/themes/starter/docs/superadmin/01-setup/01-configuration.md

@@ -0,0 +1,31 @@
+# Admin Configuration
+
+This guide covers the configuration options available to administrators.
+
+## Environment Variables
+
+Configure your application through environment variables:
+
+```bash
+# Database
+DATABASE_URL="postgresql://..."
+
+# Authentication
+BETTER_AUTH_SECRET="your-secret"
+
+# Application
+NEXT_PUBLIC_APP_URL="https://your-domain.com"
+```
+
+## Configuration Files
+
+Customize your application through config files in `config/`:
+
+- `app.config.ts` - Main application settings
+- `permissions.config.ts` - Roles and permissions
+- `billing.config.ts` - Subscription plans
+- `dev.config.ts` - Development settings
+
+## Next Steps
+
+Refer to the main documentation for detailed guides on each configuration area.

package/templates/contents/themes/starter/tests/cypress.config.ts

@@ -2,17 +2,17 @@
  * Cypress Configuration for Starter Theme
  *
  * This config is self-contained for npm projects created with `nextspark init`.
- * Run with: pnpm cy:open
+ * Run with: pnpm cy:open or pnpm cy:run
+ *
+ * Filter by tags: pnpm cy:tags "@smoke" or pnpm cy:run --env grepTags="@smoke"
  */
 
 import { defineConfig } from 'cypress'
 import path from 'path'
 import fs from 'fs'
-import { fileURLToPath } from 'url'
 
-// ESM-compatible __dirname
-const __filename = fileURLToPath(import.meta.url)
-const __dirname = path.dirname(__filename)
+// __dirname is available because ts-node processes this file as CommonJS
+// (Next.js projects don't use "type": "module" in package.json)
 
 // Paths relative to this config file
 const themeRoot = path.resolve(__dirname, '..')

package/templates/scripts/cy-tags.cjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+/**
+ * Cypress Tags Runner
+ *
+ * A wrapper script that converts --tags to --env grepTags for @cypress/grep
+ *
+ * Usage:
+ *   pnpm cy:tags "@smoke"           # Run tests with @smoke tag
+ *   pnpm cy:tags "@P0+@auth"        # Run tests with @P0 AND @auth tags
+ *   pnpm cy:tags "@smoke @auth"     # Run tests with @smoke OR @auth tags
+ *   pnpm cy:tags "-@slow"           # Exclude tests with @slow tag
+ *   pnpm cy:tags "@smoke" --headed  # Run with browser visible
+ */
+
+const { spawnSync } = require('child_process')
+const path = require('path')
+const fs = require('fs')
+
+// Get arguments after script name
+const args = process.argv.slice(2)
+
+// First argument is the tag(s), rest are additional cypress args
+const tags = args[0] || ''
+const extraArgs = args.slice(1)
+
+// Find the active theme's cypress config
+function findCypressConfig() {
+  const contentsDir = path.join(process.cwd(), 'contents', 'themes')
+
+  if (!fs.existsSync(contentsDir)) {
+    console.error('Error: contents/themes directory not found')
+    process.exit(1)
+  }
+
+  const themes = fs.readdirSync(contentsDir).filter((name) => {
+    const themePath = path.join(contentsDir, name)
+    return fs.statSync(themePath).isDirectory()
+  })
+
+  // Check NEXT_PUBLIC_ACTIVE_THEME env var first
+  const activeTheme = process.env.NEXT_PUBLIC_ACTIVE_THEME
+
+  if (activeTheme && themes.includes(activeTheme)) {
+    const configPath = path.join(contentsDir, activeTheme, 'tests', 'cypress.config.ts')
+    if (fs.existsSync(configPath)) {
+      return configPath
+    }
+  }
+
+  // Otherwise use the first theme found
+  for (const theme of themes) {
+    const configPath = path.join(contentsDir, theme, 'tests', 'cypress.config.ts')
+    if (fs.existsSync(configPath)) {
+      return configPath
+    }
+  }
+
+  console.error('Error: No cypress.config.ts found in any theme')
+  process.exit(1)
+}
+
+const configFile = findCypressConfig()
+
+// Build cypress arguments
+const cypressArgs = ['cypress', 'run', '--config-file', configFile]
+
+if (tags) {
+  cypressArgs.push('--env', `grepTags=${tags}`)
+}
+
+// Add any extra arguments
+cypressArgs.push(...extraArgs)
+
+console.log(`Running: npx ${cypressArgs.join(' ')}`)
+
+// Execute cypress
+const result = spawnSync('npx', cypressArgs, {
+  stdio: 'inherit',
+  shell: true,
+  cwd: process.cwd(),
+})
+
+process.exit(result.status || 0)