create-nextspark-app 0.1.0-beta.1

package/README.md

@@ -0,0 +1,63 @@
+# create-nextspark-app
+
+Create a new NextSpark SaaS project with a single command.
+
+## Usage
+
+```bash
+npx create-nextspark-app my-app
+```
+
+This will:
+1. Create a new directory `my-app`
+2. Install `@nextsparkjs/core`
+3. Run the interactive setup wizard
+4. Generate your project with all configurations
+
+## Options
+
+```bash
+# Interactive setup (default)
+npx create-nextspark-app my-app
+
+# Use a preset to skip some prompts
+npx create-nextspark-app my-app --preset saas
+npx create-nextspark-app my-app --preset blog
+npx create-nextspark-app my-app --preset crm
+
+# Skip all prompts (use defaults)
+npx create-nextspark-app my-app -y
+```
+
+## What's Included
+
+- **Next.js 15** with App Router and Turbopack
+- **TypeScript** strict configuration
+- **Tailwind CSS v4** with CSS-based theming
+- **Authentication** ready with Better Auth
+- **Database** setup with PostgreSQL + Drizzle
+- **UI Components** 50+ components based on shadcn/ui
+- **Entity System** with automatic CRUD and APIs
+- **Page Builder** with blocks
+- **Testing** with Jest + Cypress
+- **i18n** with next-intl
+
+## After Creation
+
+```bash
+cd my-app
+pnpm dev
+```
+
+## Requirements
+
+- Node.js 18+
+- pnpm (recommended)
+
+## Documentation
+
+Visit [nextspark.dev/docs](https://nextspark.dev/docs) for full documentation.
+
+## License
+
+MIT

package/bin/index.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js'

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+import chalk2 from "chalk";
+
+// src/create.ts
+import path from "path";
+import fs from "fs-extra";
+import chalk from "chalk";
+import ora from "ora";
+import { execSync } from "child_process";
+async function createProject(options) {
+  const { projectName, projectPath, preset } = options;
+  if (await fs.pathExists(projectPath)) {
+    const files = await fs.readdir(projectPath);
+    if (files.length > 0) {
+      throw new Error(`Directory "${projectName}" already exists and is not empty`);
+    }
+  }
+  console.log();
+  console.log(chalk.bold(`  Creating ${chalk.cyan(projectName)}...`));
+  console.log();
+  const dirSpinner = ora("  Creating project directory...").start();
+  await fs.ensureDir(projectPath);
+  dirSpinner.succeed("  Project directory created");
+  const pkgSpinner = ora("  Initializing package.json...").start();
+  const packageJson = {
+    name: projectName,
+    version: "0.1.0",
+    private: true
+  };
+  await fs.writeJson(path.join(projectPath, "package.json"), packageJson, { spaces: 2 });
+  pkgSpinner.succeed("  package.json created");
+  const coreSpinner = ora("  Installing @nextsparkjs/core...").start();
+  try {
+    execSync("pnpm add @nextsparkjs/core", {
+      cwd: projectPath,
+      stdio: "pipe"
+    });
+    coreSpinner.succeed("  @nextsparkjs/core installed");
+  } catch (error) {
+    coreSpinner.fail("  Failed to install @nextsparkjs/core");
+    throw error;
+  }
+  console.log();
+  console.log(chalk.blue("  Starting NextSpark wizard..."));
+  console.log();
+  const presetArg = preset ? ` --preset=${preset}` : "";
+  execSync(`npx nextspark init${presetArg}`, {
+    cwd: projectPath,
+    stdio: "inherit"
+    // Interactive mode
+  });
+  console.log();
+  console.log(chalk.bold.green("  Success!"));
+  console.log();
+  console.log("  Next steps:");
+  console.log();
+  console.log(chalk.cyan(`    cd ${projectName}`));
+  console.log(chalk.cyan("    pnpm dev"));
+  console.log();
+}
+
+// src/utils/prompts.ts
+import path2 from "path";
+import prompts from "prompts";
+async function getProjectOptions(projectName, skipPrompts) {
+  if (skipPrompts && projectName) {
+    return {
+      projectName,
+      projectPath: path2.resolve(process.cwd(), projectName)
+    };
+  }
+  if (!projectName) {
+    const response = await prompts(
+      {
+        type: "text",
+        name: "projectName",
+        message: "What is your project named?",
+        initial: "my-nextspark-app",
+        validate: (value) => {
+          if (!value) return "Project name is required";
+          if (!/^[a-z0-9-]+$/.test(value)) {
+            return "Project name can only contain lowercase letters, numbers, and hyphens";
+          }
+          return true;
+        }
+      },
+      {
+        onCancel: () => {
+          throw new Error("PROMPT_CANCELLED");
+        }
+      }
+    );
+    projectName = response.projectName;
+  }
+  if (!skipPrompts) {
+    const confirmResponse = await prompts(
+      {
+        type: "confirm",
+        name: "confirm",
+        message: `Create project "${projectName}" in current directory?`,
+        initial: true
+      },
+      {
+        onCancel: () => {
+          throw new Error("PROMPT_CANCELLED");
+        }
+      }
+    );
+    if (!confirmResponse.confirm) {
+      throw new Error("PROMPT_CANCELLED");
+    }
+  }
+  return {
+    projectName,
+    projectPath: path2.resolve(process.cwd(), projectName)
+  };
+}
+
+// src/index.ts
+var program = new Command();
+program.name("create-nextspark-app").description("Create a new NextSpark SaaS project").version("0.1.0-beta.1").argument("[project-name]", "Name of the project").option("--preset <preset>", "Use a preset (saas, blog, crm)").option("-y, --yes", "Skip prompts and use defaults", false).action(async (projectName, options) => {
+  console.log();
+  console.log(chalk2.bold.cyan("  NextSpark"));
+  console.log(chalk2.dim("  Create a new SaaS project"));
+  console.log();
+  try {
+    const projectOptions = await getProjectOptions(projectName, options.yes);
+    await createProject({
+      ...projectOptions,
+      preset: options.preset
+    });
+  } catch (error) {
+    if (error instanceof Error) {
+      if (error.message === "PROMPT_CANCELLED") {
+        console.log(chalk2.yellow("\n  Setup cancelled.\n"));
+        process.exit(0);
+      }
+      console.error(chalk2.red(`  Error: ${error.message}`));
+    } else {
+      console.error(chalk2.red("  An unexpected error occurred"));
+    }
+    process.exit(1);
+  }
+});
+program.parse();

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "create-nextspark-app",
+  "version": "0.1.0-beta.1",
+  "description": "Create a new NextSpark SaaS project",
+  "type": "module",
+  "bin": {
+    "create-nextspark-app": "./bin/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --outDir dist",
+    "dev": "tsup src/index.ts --format esm --watch --outDir dist"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "chalk": "^5.3.0",
+    "ora": "^8.0.0",
+    "fs-extra": "^11.0.0",
+    "prompts": "^2.4.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0",
+    "@types/fs-extra": "^11.0.0",
+    "@types/prompts": "^2.4.0"
+  },
+  "keywords": [
+    "nextspark",
+    "create-app",
+    "nextjs",
+    "saas",
+    "cli",
+    "boilerplate",
+    "starter"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NextSpark-js/nextspark.git",
+    "directory": "packages/create-nextspark-app"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}