@nextsparkjs/core 0.1.0-beta.1

package/README.md

@@ -0,0 +1,42 @@
+# @nextsparkjs/core
+
+The complete SaaS framework for Next.js. Build production-ready SaaS applications with authentication, payments, teams, and more.
+
+## Installation
+
+```bash
+npm install @nextsparkjs/core
+# or
+pnpm add @nextsparkjs/core
+```
+
+## Quick Start
+
+```bash
+# Create a new NextSpark project
+npx @nextsparkjs/create-app my-app
+cd my-app
+pnpm install
+pnpm dev
+```
+
+## Features
+
+- **Authentication** - Email/password, Google OAuth, magic links with Better Auth
+- **Payments** - Stripe integration with subscriptions and usage billing
+- **Teams** - Multi-tenant team management with roles and permissions
+- **Database** - PostgreSQL with migrations and type-safe queries
+- **UI Components** - 50+ components based on shadcn/ui
+- **Entities** - Dynamic CRUD with automatic API generation
+- **Themes** - Multiple theme support with easy customization
+- **Plugins** - Extensible plugin system
+- **i18n** - Full internationalization with next-intl
+- **Testing** - Jest + Cypress setup included
+
+## Documentation
+
+Visit [nextspark.dev/docs](https://nextspark.dev/docs) for full documentation.
+
+## License
+
+MIT

package/bin/dist/init.js

@@ -0,0 +1,317 @@
+#!/usr/bin/env node
+
+// init.ts
+import { existsSync, mkdirSync, writeFileSync, readFileSync, cpSync, readdirSync, rmSync } from "fs";
+import { resolve, dirname, join } from "path";
+import { fileURLToPath } from "url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var TEMPLATES_DIR = resolve(__dirname, "../../templates");
+var colors = {
+  reset: "\x1B[0m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  red: "\x1B[31m",
+  cyan: "\x1B[36m"
+};
+function log(message, color = "reset") {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+function copyDirectory(src, dest, description, force = false) {
+  if (!existsSync(src)) {
+    log(`   \u26A0\uFE0F  ${description} not found in package`, "yellow");
+    return false;
+  }
+  if (existsSync(dest)) {
+    if (force) {
+      rmSync(dest, { recursive: true, force: true });
+      log(`   \u{1F504} Replacing ${description} with NextSpark version`, "yellow");
+    } else {
+      log(`   \u23ED\uFE0F  ${description} already exists, skipping`, "yellow");
+      return false;
+    }
+  }
+  cpSync(src, dest, { recursive: true });
+  log(`   \u2705 Copied ${description}`, "green");
+  return true;
+}
+function copyFile(src, dest, description, force = false) {
+  if (!existsSync(src)) {
+    log(`   \u26A0\uFE0F  ${description} not found in package`, "yellow");
+    return false;
+  }
+  if (existsSync(dest)) {
+    if (force) {
+      log(`   \u{1F504} Replacing ${description}`, "yellow");
+    } else {
+      log(`   \u23ED\uFE0F  ${description} already exists, skipping`, "yellow");
+      return false;
+    }
+  }
+  const destDir = dirname(dest);
+  if (!existsSync(destDir)) {
+    mkdirSync(destDir, { recursive: true });
+  }
+  cpSync(src, dest);
+  log(`   \u2705 Copied ${description}`, "green");
+  return true;
+}
+async function init() {
+  log("\n\u{1F680} Initializing NextSpark project...\n", "blue");
+  if (!existsSync("package.json")) {
+    log("\u274C No package.json found. Please run this command in a Node.js project.", "red");
+    process.exit(1);
+  }
+  const packageJson = JSON.parse(readFileSync("package.json", "utf-8"));
+  const hasCore = packageJson.dependencies?.["@nextsparkjs/core"] || packageJson.devDependencies?.["@nextsparkjs/core"];
+  if (!hasCore) {
+    log("\u26A0\uFE0F  Warning: @nextsparkjs/core not found in dependencies.", "yellow");
+    log("   Run: npm install @nextsparkjs/core\n", "yellow");
+  }
+  if (!existsSync(TEMPLATES_DIR)) {
+    log("\u274C Templates directory not found in the package.", "red");
+    log("   This might be a packaging issue. Please reinstall @nextsparkjs/core.", "red");
+    process.exit(1);
+  }
+  log("\u{1F4C1} Setting up project structure...", "blue");
+  copyDirectory(
+    join(TEMPLATES_DIR, "app"),
+    resolve(process.cwd(), "app"),
+    "app/",
+    true
+    // Force overwrite
+  );
+  copyDirectory(
+    join(TEMPLATES_DIR, "contents"),
+    resolve(process.cwd(), "contents"),
+    "contents/"
+  );
+  copyDirectory(
+    join(TEMPLATES_DIR, "public"),
+    resolve(process.cwd(), "public"),
+    "public/",
+    true
+    // Force overwrite
+  );
+  log("\n\u{1F4C4} Setting up configuration files...", "blue");
+  copyFile(
+    join(TEMPLATES_DIR, "next.config.mjs"),
+    resolve(process.cwd(), "next.config.mjs"),
+    "next.config.mjs",
+    true
+    // Force overwrite
+  );
+  copyFile(
+    join(TEMPLATES_DIR, "tsconfig.json"),
+    resolve(process.cwd(), "tsconfig.json"),
+    "tsconfig.json",
+    true
+    // Force overwrite
+  );
+  copyFile(
+    join(TEMPLATES_DIR, "postcss.config.mjs"),
+    resolve(process.cwd(), "postcss.config.mjs"),
+    "postcss.config.mjs",
+    true
+    // Force overwrite
+  );
+  copyFile(
+    join(TEMPLATES_DIR, "i18n.ts"),
+    resolve(process.cwd(), "i18n.ts"),
+    "i18n.ts",
+    true
+    // Force overwrite
+  );
+  copyFile(
+    join(TEMPLATES_DIR, "npmrc"),
+    resolve(process.cwd(), ".npmrc"),
+    ".npmrc"
+  );
+  copyFile(
+    join(TEMPLATES_DIR, "tsconfig.cypress.json"),
+    resolve(process.cwd(), "tsconfig.cypress.json"),
+    "tsconfig.cypress.json"
+  );
+  copyFile(
+    join(TEMPLATES_DIR, "cypress.d.ts"),
+    resolve(process.cwd(), "cypress.d.ts"),
+    "cypress.d.ts"
+  );
+  log("\n\u{1F4E6} Updating package.json...", "blue");
+  const updatedPackageJson = { ...packageJson };
+  updatedPackageJson.scripts = updatedPackageJson.scripts || {};
+  const scriptsToAdd = {
+    "dev": "next dev --turbopack",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "build:registries": "node node_modules/@nextsparkjs/core/scripts/build/registry.mjs",
+    "db:migrate": "node node_modules/@nextsparkjs/core/scripts/db/run-migrations.mjs",
+    "test:theme": "jest --config contents/themes/default/tests/jest/jest.config.ts",
+    "cy:open": "cypress open --config-file contents/themes/default/tests/cypress.config.ts",
+    "cy:run": "cypress run --config-file contents/themes/default/tests/cypress.config.ts",
+    // Allure commands (results auto-generated when allure-cypress is installed)
+    "allure:generate": "allure generate contents/themes/default/tests/cypress/allure-results --clean -o contents/themes/default/tests/cypress/allure-report",
+    "allure:open": "allure open contents/themes/default/tests/cypress/allure-report"
+  };
+  let scriptsAdded = 0;
+  for (const [name, command] of Object.entries(scriptsToAdd)) {
+    if (!updatedPackageJson.scripts[name]) {
+      updatedPackageJson.scripts[name] = command;
+      scriptsAdded++;
+    }
+  }
+  if (scriptsAdded > 0) {
+    writeFileSync("package.json", JSON.stringify(updatedPackageJson, null, 2) + "\n");
+    log(`   \u2705 Added ${scriptsAdded} scripts to package.json`, "green");
+  } else {
+    log("   \u23ED\uFE0F  All scripts already exist", "yellow");
+  }
+  log("\n\u{1F50C} Scanning plugin dependencies...", "blue");
+  const pluginsDir = resolve(process.cwd(), "contents", "plugins");
+  let pluginDepsAdded = 0;
+  if (existsSync(pluginsDir)) {
+    const pluginFolders = readdirSync(pluginsDir, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+    const currentPackageJson = JSON.parse(readFileSync("package.json", "utf-8"));
+    currentPackageJson.dependencies = currentPackageJson.dependencies || {};
+    for (const pluginName of pluginFolders) {
+      const pluginPackageJsonPath = join(pluginsDir, pluginName, "package.json");
+      if (existsSync(pluginPackageJsonPath)) {
+        try {
+          const pluginPackageJson = JSON.parse(readFileSync(pluginPackageJsonPath, "utf-8"));
+          const pluginDeps = pluginPackageJson.dependencies || {};
+          for (const [depName, depVersion] of Object.entries(pluginDeps)) {
+            if (!currentPackageJson.dependencies[depName]) {
+              currentPackageJson.dependencies[depName] = depVersion;
+              pluginDepsAdded++;
+              log(`   \u2795 ${depName}@${depVersion} (from ${pluginName})`, "cyan");
+            }
+          }
+        } catch (error) {
+          log(`   \u26A0\uFE0F  Could not parse ${pluginName}/package.json`, "yellow");
+        }
+      }
+    }
+    if (pluginDepsAdded > 0) {
+      writeFileSync("package.json", JSON.stringify(currentPackageJson, null, 2) + "\n");
+      log(`   \u2705 Added ${pluginDepsAdded} plugin dependencies`, "green");
+    } else {
+      log("   \u23ED\uFE0F  No new plugin dependencies to add", "yellow");
+    }
+  }
+  log("\n\u{1F4E6} Adding core dependencies...", "blue");
+  const coreDevDependencies = {
+    // Tailwind CSS v4 PostCSS plugin (required by postcss.config.mjs)
+    "@tailwindcss/postcss": "^4"
+  };
+  const pkgJsonForCore = JSON.parse(readFileSync("package.json", "utf-8"));
+  pkgJsonForCore.devDependencies = pkgJsonForCore.devDependencies || {};
+  let coreDepsAdded = 0;
+  for (const [depName, depVersion] of Object.entries(coreDevDependencies)) {
+    if (!pkgJsonForCore.devDependencies[depName]) {
+      pkgJsonForCore.devDependencies[depName] = depVersion;
+      coreDepsAdded++;
+      log(`   \u2795 ${depName}@${depVersion}`, "cyan");
+    }
+  }
+  if (coreDepsAdded > 0) {
+    writeFileSync("package.json", JSON.stringify(pkgJsonForCore, null, 2) + "\n");
+    log(`   \u2705 Added ${coreDepsAdded} core dependencies`, "green");
+  } else {
+    log("   \u23ED\uFE0F  All core dependencies already exist", "yellow");
+  }
+  log("\n\u{1F9EA} Adding test dependencies...", "blue");
+  const testDevDependencies = {
+    // Jest dependencies
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "@types/jest": "^29.5.14",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "jest-environment-jsdom": "^29.7.0",
+    // Cypress dependencies
+    "cypress": "^15.0.0",
+    "@testing-library/cypress": "^10.0.2",
+    "@cypress/webpack-preprocessor": "^6.0.2",
+    "@cypress/grep": "^4.1.0",
+    "ts-loader": "^9.5.1",
+    "webpack": "^5.97.0",
+    // Allure reporting (for Cypress)
+    "allure-cypress": "^3.0.0",
+    "allure-commandline": "^2.27.0"
+  };
+  const pkgJsonForTests = JSON.parse(readFileSync("package.json", "utf-8"));
+  pkgJsonForTests.devDependencies = pkgJsonForTests.devDependencies || {};
+  let testDepsAdded = 0;
+  for (const [depName, depVersion] of Object.entries(testDevDependencies)) {
+    if (!pkgJsonForTests.devDependencies[depName]) {
+      pkgJsonForTests.devDependencies[depName] = depVersion;
+      testDepsAdded++;
+      log(`   \u2795 ${depName}@${depVersion}`, "cyan");
+    }
+  }
+  if (testDepsAdded > 0) {
+    writeFileSync("package.json", JSON.stringify(pkgJsonForTests, null, 2) + "\n");
+    log(`   \u2705 Added ${testDepsAdded} test dependencies`, "green");
+  } else {
+    log("   \u23ED\uFE0F  All test dependencies already exist", "yellow");
+  }
+  const gitignorePath = resolve(process.cwd(), ".gitignore");
+  const gitignoreEntries = `
+# NextSpark
+.nextspark/
+
+# Cypress (theme-based)
+contents/themes/*/tests/cypress/videos
+contents/themes/*/tests/cypress/screenshots
+contents/themes/*/tests/cypress/allure-results
+contents/themes/*/tests/cypress/allure-report
+
+# Jest (theme-based)
+contents/themes/*/tests/jest/coverage
+
+# Environment
+.env
+.env.local
+`;
+  if (existsSync(gitignorePath)) {
+    const currentGitignore = readFileSync(gitignorePath, "utf-8");
+    if (!currentGitignore.includes(".nextspark/")) {
+      writeFileSync(gitignorePath, currentGitignore + gitignoreEntries);
+      log("\n\u{1F4DD} Updated .gitignore", "green");
+    }
+  }
+  log("\n" + "\u2550".repeat(50), "cyan");
+  log("\u2728 NextSpark initialized successfully!", "green");
+  log("\u2550".repeat(50) + "\n", "cyan");
+  log("\u{1F4CB} Next steps:\n", "blue");
+  log("  1. Reinstall dependencies (applies hoisting + installs test deps):", "reset");
+  log("     rm -rf node_modules && pnpm install", "cyan");
+  log("");
+  log("  2. Create your .env file:", "reset");
+  log("     Copy from your reference or create with required variables:", "reset");
+  log("     - DATABASE_URL", "yellow");
+  log("     - BETTER_AUTH_SECRET", "yellow");
+  log("     - NEXT_PUBLIC_ACTIVE_THEME=default", "yellow");
+  log("");
+  log("  3. Generate registries:", "reset");
+  log("     pnpm build:registries", "cyan");
+  log("");
+  log("  4. Run database migrations:", "reset");
+  log("     pnpm db:migrate", "cyan");
+  log("");
+  log("  5. Start development server:", "reset");
+  log("     pnpm dev", "cyan");
+  log("");
+  log("  6. (Optional) Run theme tests:", "reset");
+  log("     pnpm test:theme           # Jest unit tests", "cyan");
+  log("     pnpm cy:open              # Cypress E2E tests", "cyan");
+  log("");
+}
+init().catch((error) => {
+  log(`
+\u274C Error: ${error.message}`, "red");
+  process.exit(1);
+});

package/dist/bin/dist/init.js

@@ -0,0 +1,317 @@
+#!/usr/bin/env node
+
+// init.ts
+import { existsSync, mkdirSync, writeFileSync, readFileSync, cpSync, readdirSync, rmSync } from "fs";
+import { resolve, dirname, join } from "path";
+import { fileURLToPath } from "url";
+var __filename = fileURLToPath(import.meta.url);
+var __dirname = dirname(__filename);
+var TEMPLATES_DIR = resolve(__dirname, "../../templates");
+var colors = {
+  reset: "\x1B[0m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  red: "\x1B[31m",
+  cyan: "\x1B[36m"
+};
+function log(message, color = "reset") {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+function copyDirectory(src, dest, description, force = false) {
+  if (!existsSync(src)) {
+    log(`   \u26A0\uFE0F  ${description} not found in package`, "yellow");
+    return false;
+  }
+  if (existsSync(dest)) {
+    if (force) {
+      rmSync(dest, { recursive: true, force: true });
+      log(`   \u{1F504} Replacing ${description} with NextSpark version`, "yellow");
+    } else {
+      log(`   \u23ED\uFE0F  ${description} already exists, skipping`, "yellow");
+      return false;
+    }
+  }
+  cpSync(src, dest, { recursive: true });
+  log(`   \u2705 Copied ${description}`, "green");
+  return true;
+}
+function copyFile(src, dest, description, force = false) {
+  if (!existsSync(src)) {
+    log(`   \u26A0\uFE0F  ${description} not found in package`, "yellow");
+    return false;
+  }
+  if (existsSync(dest)) {
+    if (force) {
+      log(`   \u{1F504} Replacing ${description}`, "yellow");
+    } else {
+      log(`   \u23ED\uFE0F  ${description} already exists, skipping`, "yellow");
+      return false;
+    }
+  }
+  const destDir = dirname(dest);
+  if (!existsSync(destDir)) {
+    mkdirSync(destDir, { recursive: true });
+  }
+  cpSync(src, dest);
+  log(`   \u2705 Copied ${description}`, "green");
+  return true;
+}
+async function init() {
+  log("\n\u{1F680} Initializing NextSpark project...\n", "blue");
+  if (!existsSync("package.json")) {
+    log("\u274C No package.json found. Please run this command in a Node.js project.", "red");
+    process.exit(1);
+  }
+  const packageJson = JSON.parse(readFileSync("package.json", "utf-8"));
+  const hasCore = packageJson.dependencies?.["@nextsparkjs/core"] || packageJson.devDependencies?.["@nextsparkjs/core"];
+  if (!hasCore) {
+    log("\u26A0\uFE0F  Warning: @nextsparkjs/core not found in dependencies.", "yellow");
+    log("   Run: npm install @nextsparkjs/core\n", "yellow");
+  }
+  if (!existsSync(TEMPLATES_DIR)) {
+    log("\u274C Templates directory not found in the package.", "red");
+    log("   This might be a packaging issue. Please reinstall @nextsparkjs/core.", "red");
+    process.exit(1);
+  }
+  log("\u{1F4C1} Setting up project structure...", "blue");
+  copyDirectory(
+    join(TEMPLATES_DIR, "app"),
+    resolve(process.cwd(), "app"),
+    "app/",
+    true
+    // Force overwrite
+  );
+  copyDirectory(
+    join(TEMPLATES_DIR, "contents"),
+    resolve(process.cwd(), "contents"),
+    "contents/"
+  );
+  copyDirectory(
+    join(TEMPLATES_DIR, "public"),
+    resolve(process.cwd(), "public"),
+    "public/",
+    true
+    // Force overwrite
+  );
+  log("\n\u{1F4C4} Setting up configuration files...", "blue");
+  copyFile(
+    join(TEMPLATES_DIR, "next.config.mjs"),
+    resolve(process.cwd(), "next.config.mjs"),
+    "next.config.mjs",
+    true
+    // Force overwrite
+  );
+  copyFile(
+    join(TEMPLATES_DIR, "tsconfig.json"),
+    resolve(process.cwd(), "tsconfig.json"),
+    "tsconfig.json",
+    true
+    // Force overwrite
+  );
+  copyFile(
+    join(TEMPLATES_DIR, "postcss.config.mjs"),
+    resolve(process.cwd(), "postcss.config.mjs"),
+    "postcss.config.mjs",
+    true
+    // Force overwrite
+  );
+  copyFile(
+    join(TEMPLATES_DIR, "i18n.ts"),
+    resolve(process.cwd(), "i18n.ts"),
+    "i18n.ts",
+    true
+    // Force overwrite
+  );
+  copyFile(
+    join(TEMPLATES_DIR, "npmrc"),
+    resolve(process.cwd(), ".npmrc"),
+    ".npmrc"
+  );
+  copyFile(
+    join(TEMPLATES_DIR, "tsconfig.cypress.json"),
+    resolve(process.cwd(), "tsconfig.cypress.json"),
+    "tsconfig.cypress.json"
+  );
+  copyFile(
+    join(TEMPLATES_DIR, "cypress.d.ts"),
+    resolve(process.cwd(), "cypress.d.ts"),
+    "cypress.d.ts"
+  );
+  log("\n\u{1F4E6} Updating package.json...", "blue");
+  const updatedPackageJson = { ...packageJson };
+  updatedPackageJson.scripts = updatedPackageJson.scripts || {};
+  const scriptsToAdd = {
+    "dev": "next dev --turbopack",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "build:registries": "node node_modules/@nextsparkjs/core/scripts/build/registry.mjs",
+    "db:migrate": "node node_modules/@nextsparkjs/core/scripts/db/run-migrations.mjs",
+    "test:theme": "jest --config contents/themes/default/tests/jest/jest.config.ts",
+    "cy:open": "cypress open --config-file contents/themes/default/tests/cypress.config.ts",
+    "cy:run": "cypress run --config-file contents/themes/default/tests/cypress.config.ts",
+    // Allure commands (results auto-generated when allure-cypress is installed)
+    "allure:generate": "allure generate contents/themes/default/tests/cypress/allure-results --clean -o contents/themes/default/tests/cypress/allure-report",
+    "allure:open": "allure open contents/themes/default/tests/cypress/allure-report"
+  };
+  let scriptsAdded = 0;
+  for (const [name, command] of Object.entries(scriptsToAdd)) {
+    if (!updatedPackageJson.scripts[name]) {
+      updatedPackageJson.scripts[name] = command;
+      scriptsAdded++;
+    }
+  }
+  if (scriptsAdded > 0) {
+    writeFileSync("package.json", JSON.stringify(updatedPackageJson, null, 2) + "\n");
+    log(`   \u2705 Added ${scriptsAdded} scripts to package.json`, "green");
+  } else {
+    log("   \u23ED\uFE0F  All scripts already exist", "yellow");
+  }
+  log("\n\u{1F50C} Scanning plugin dependencies...", "blue");
+  const pluginsDir = resolve(process.cwd(), "contents", "plugins");
+  let pluginDepsAdded = 0;
+  if (existsSync(pluginsDir)) {
+    const pluginFolders = readdirSync(pluginsDir, { withFileTypes: true }).filter((dirent) => dirent.isDirectory()).map((dirent) => dirent.name);
+    const currentPackageJson = JSON.parse(readFileSync("package.json", "utf-8"));
+    currentPackageJson.dependencies = currentPackageJson.dependencies || {};
+    for (const pluginName of pluginFolders) {
+      const pluginPackageJsonPath = join(pluginsDir, pluginName, "package.json");
+      if (existsSync(pluginPackageJsonPath)) {
+        try {
+          const pluginPackageJson = JSON.parse(readFileSync(pluginPackageJsonPath, "utf-8"));
+          const pluginDeps = pluginPackageJson.dependencies || {};
+          for (const [depName, depVersion] of Object.entries(pluginDeps)) {
+            if (!currentPackageJson.dependencies[depName]) {
+              currentPackageJson.dependencies[depName] = depVersion;
+              pluginDepsAdded++;
+              log(`   \u2795 ${depName}@${depVersion} (from ${pluginName})`, "cyan");
+            }
+          }
+        } catch (error) {
+          log(`   \u26A0\uFE0F  Could not parse ${pluginName}/package.json`, "yellow");
+        }
+      }
+    }
+    if (pluginDepsAdded > 0) {
+      writeFileSync("package.json", JSON.stringify(currentPackageJson, null, 2) + "\n");
+      log(`   \u2705 Added ${pluginDepsAdded} plugin dependencies`, "green");
+    } else {
+      log("   \u23ED\uFE0F  No new plugin dependencies to add", "yellow");
+    }
+  }
+  log("\n\u{1F4E6} Adding core dependencies...", "blue");
+  const coreDevDependencies = {
+    // Tailwind CSS v4 PostCSS plugin (required by postcss.config.mjs)
+    "@tailwindcss/postcss": "^4"
+  };
+  const pkgJsonForCore = JSON.parse(readFileSync("package.json", "utf-8"));
+  pkgJsonForCore.devDependencies = pkgJsonForCore.devDependencies || {};
+  let coreDepsAdded = 0;
+  for (const [depName, depVersion] of Object.entries(coreDevDependencies)) {
+    if (!pkgJsonForCore.devDependencies[depName]) {
+      pkgJsonForCore.devDependencies[depName] = depVersion;
+      coreDepsAdded++;
+      log(`   \u2795 ${depName}@${depVersion}`, "cyan");
+    }
+  }
+  if (coreDepsAdded > 0) {
+    writeFileSync("package.json", JSON.stringify(pkgJsonForCore, null, 2) + "\n");
+    log(`   \u2705 Added ${coreDepsAdded} core dependencies`, "green");
+  } else {
+    log("   \u23ED\uFE0F  All core dependencies already exist", "yellow");
+  }
+  log("\n\u{1F9EA} Adding test dependencies...", "blue");
+  const testDevDependencies = {
+    // Jest dependencies
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "@types/jest": "^29.5.14",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "jest-environment-jsdom": "^29.7.0",
+    // Cypress dependencies
+    "cypress": "^15.0.0",
+    "@testing-library/cypress": "^10.0.2",
+    "@cypress/webpack-preprocessor": "^6.0.2",
+    "@cypress/grep": "^4.1.0",
+    "ts-loader": "^9.5.1",
+    "webpack": "^5.97.0",
+    // Allure reporting (for Cypress)
+    "allure-cypress": "^3.0.0",
+    "allure-commandline": "^2.27.0"
+  };
+  const pkgJsonForTests = JSON.parse(readFileSync("package.json", "utf-8"));
+  pkgJsonForTests.devDependencies = pkgJsonForTests.devDependencies || {};
+  let testDepsAdded = 0;
+  for (const [depName, depVersion] of Object.entries(testDevDependencies)) {
+    if (!pkgJsonForTests.devDependencies[depName]) {
+      pkgJsonForTests.devDependencies[depName] = depVersion;
+      testDepsAdded++;
+      log(`   \u2795 ${depName}@${depVersion}`, "cyan");
+    }
+  }
+  if (testDepsAdded > 0) {
+    writeFileSync("package.json", JSON.stringify(pkgJsonForTests, null, 2) + "\n");
+    log(`   \u2705 Added ${testDepsAdded} test dependencies`, "green");
+  } else {
+    log("   \u23ED\uFE0F  All test dependencies already exist", "yellow");
+  }
+  const gitignorePath = resolve(process.cwd(), ".gitignore");
+  const gitignoreEntries = `
+# NextSpark
+.nextspark/
+
+# Cypress (theme-based)
+contents/themes/*/tests/cypress/videos
+contents/themes/*/tests/cypress/screenshots
+contents/themes/*/tests/cypress/allure-results
+contents/themes/*/tests/cypress/allure-report
+
+# Jest (theme-based)
+contents/themes/*/tests/jest/coverage
+
+# Environment
+.env
+.env.local
+`;
+  if (existsSync(gitignorePath)) {
+    const currentGitignore = readFileSync(gitignorePath, "utf-8");
+    if (!currentGitignore.includes(".nextspark/")) {
+      writeFileSync(gitignorePath, currentGitignore + gitignoreEntries);
+      log("\n\u{1F4DD} Updated .gitignore", "green");
+    }
+  }
+  log("\n" + "\u2550".repeat(50), "cyan");
+  log("\u2728 NextSpark initialized successfully!", "green");
+  log("\u2550".repeat(50) + "\n", "cyan");
+  log("\u{1F4CB} Next steps:\n", "blue");
+  log("  1. Reinstall dependencies (applies hoisting + installs test deps):", "reset");
+  log("     rm -rf node_modules && pnpm install", "cyan");
+  log("");
+  log("  2. Create your .env file:", "reset");
+  log("     Copy from your reference or create with required variables:", "reset");
+  log("     - DATABASE_URL", "yellow");
+  log("     - BETTER_AUTH_SECRET", "yellow");
+  log("     - NEXT_PUBLIC_ACTIVE_THEME=default", "yellow");
+  log("");
+  log("  3. Generate registries:", "reset");
+  log("     pnpm build:registries", "cyan");
+  log("");
+  log("  4. Run database migrations:", "reset");
+  log("     pnpm db:migrate", "cyan");
+  log("");
+  log("  5. Start development server:", "reset");
+  log("     pnpm dev", "cyan");
+  log("");
+  log("  6. (Optional) Run theme tests:", "reset");
+  log("     pnpm test:theme           # Jest unit tests", "cyan");
+  log("     pnpm cy:open              # Cypress E2E tests", "cyan");
+  log("");
+}
+init().catch((error) => {
+  log(`
+\u274C Error: ${error.message}`, "red");
+  process.exit(1);
+});