create-nyoworks 2.3.0

package/README.md

@@ -0,0 +1,72 @@
+# create-nyoworks
+
+Create a new NYOWORKS project with one command.
+
+## Usage
+
+```bash
+npx create-nyoworks my-project
+```
+
+## Interactive Setup
+
+The CLI will ask you:
+
+1. **Project name** - Your project's display name
+2. **Platforms** - Web, Mobile, Desktop (multi-select)
+3. **Features** - Optional features to enable
+
+## What Gets Created
+
+```
+my-project/
+├── apps/
+│   ├── server/          # Hono + tRPC API
+│   ├── web/             # Next.js 16 (if selected)
+│   ├── mobile/          # Expo SDK 54 (if selected)
+│   └── desktop/         # Tauri 2.0 (if selected)
+├── packages/
+│   ├── api/             # tRPC routers
+│   ├── api-client/      # React hooks
+│   ├── database/        # Drizzle ORM
+│   ├── validators/      # Zod schemas
+│   ├── shared/          # Utilities
+│   ├── ui/              # shadcn/ui
+│   └── assets/          # Images, icons
+├── docs/
+│   └── bible/           # Project documentation
+├── mcp-server/          # AI agent orchestration
+└── nyoworks.config.yaml # Project config
+```
+
+## Automatic Placeholder Replacement
+
+These placeholders are replaced during project creation:
+
+| Placeholder | Example Value |
+|-------------|---------------|
+| `${PROJECT_NAME}` | My Project |
+| `${PROJECT_CODE}` | MYPR |
+| `${PROJECT_SLUG}` | my-project |
+| `${DATABASE_NAME}` | my_project_dev |
+
+## Core vs Optional
+
+**Always Included (Core):**
+- Authentication (JWT + Argon2id)
+- Database (PostgreSQL + Drizzle)
+- API (Hono + tRPC)
+
+**Optional Features:**
+- Analytics, CRM, Payments, Notifications
+- Appointments, Audit, Export, Realtime
+
+## Requirements
+
+- Node.js 20+
+- pnpm 9+
+- Docker (for PostgreSQL)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { createProject } from "./init.js";
+const args = process.argv.slice(2);
+const projectName = args[0];
+createProject(projectName);

package/dist/init.d.ts

@@ -0,0 +1 @@
+export declare function createProject(projectName?: string): Promise<void>;

package/dist/init.js

@@ -0,0 +1,227 @@
+import prompts from "prompts";
+import pc from "picocolors";
+import fs from "fs-extra";
+import path from "path";
+import { execa } from "execa";
+import { replacePlaceholders } from "./replace.js";
+const REPO = "naimozcan/nyoworks-framework";
+const BRANCH = "main";
+const AVAILABLE_FEATURES = [
+    { title: "Analytics", value: "analytics", description: "User behavior tracking" },
+    { title: "CRM", value: "crm", description: "Customer relationship management" },
+    { title: "Payments", value: "payments", description: "Stripe integration" },
+    { title: "Notifications", value: "notifications", description: "Email, SMS, Push" },
+    { title: "Appointments", value: "appointments", description: "Booking system" },
+    { title: "Audit", value: "audit", description: "Activity logging" },
+    { title: "Export", value: "export", description: "PDF/CSV export" },
+    { title: "Realtime", value: "realtime", description: "WebSocket support" },
+];
+const AVAILABLE_PLATFORMS = [
+    { title: "Web", value: "web", description: "Next.js 16" },
+    { title: "Mobile", value: "mobile", description: "Expo SDK 54" },
+    { title: "Desktop", value: "desktop", description: "Tauri 2.0" },
+];
+function generateCode(name) {
+    return name
+        .toUpperCase()
+        .replace(/[^A-Z0-9]/g, "")
+        .slice(0, 4);
+}
+function generateSlug(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "");
+}
+function generateDatabaseName(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "_")
+        .replace(/^_|_$/g, "") + "_dev";
+}
+async function downloadFromGitHub(repo, subPath, targetDir, branch = "main") {
+    const url = `https://codeload.github.com/${repo}/tar.gz/${branch}`;
+    const tempDir = path.join(targetDir, ".download-temp");
+    await fs.ensureDir(tempDir);
+    try {
+        await execa("curl", ["-sL", url, "-o", `${tempDir}/repo.tar.gz`]);
+        await execa("tar", ["-xzf", `${tempDir}/repo.tar.gz`, "-C", tempDir]);
+        const extractedDir = path.join(tempDir, `nyoworks-framework-${branch}`);
+        const sourcePath = subPath ? path.join(extractedDir, subPath) : extractedDir;
+        if (await fs.pathExists(sourcePath)) {
+            await fs.copy(sourcePath, targetDir, { overwrite: true });
+        }
+    }
+    finally {
+        await fs.remove(tempDir);
+    }
+}
+export async function createProject(projectName) {
+    console.log();
+    console.log(pc.cyan(pc.bold("  NYOWORKS Framework")));
+    console.log(pc.dim("  Create a new project"));
+    console.log();
+    const response = await prompts([
+        {
+            type: projectName ? null : "text",
+            name: "name",
+            message: "Project name:",
+            initial: projectName || "my-project",
+            validate: (value) => (value.length > 0 ? true : "Project name is required"),
+        },
+        {
+            type: "multiselect",
+            name: "platforms",
+            message: "Select platforms:",
+            choices: AVAILABLE_PLATFORMS,
+            min: 1,
+            hint: "- Space to select. Return to submit",
+            instructions: false,
+        },
+        {
+            type: "multiselect",
+            name: "features",
+            message: "Select features:",
+            choices: AVAILABLE_FEATURES,
+            hint: "- Space to select. Return to submit",
+            instructions: false,
+        },
+    ]);
+    if (!response.name && !projectName) {
+        console.log(pc.red("Aborted."));
+        process.exit(1);
+    }
+    const name = response.name || projectName;
+    const code = generateCode(name);
+    const slug = generateSlug(name);
+    const databaseName = generateDatabaseName(name);
+    const platforms = response.platforms || ["web"];
+    const features = response.features || [];
+    const targetDir = path.resolve(process.cwd(), slug);
+    if (fs.existsSync(targetDir)) {
+        console.log(pc.red(`Directory ${slug} already exists.`));
+        process.exit(1);
+    }
+    await fs.ensureDir(targetDir);
+    console.log();
+    console.log(pc.cyan("Downloading from GitHub..."));
+    const coreItems = [
+        { path: "packages/api", desc: "tRPC routers" },
+        { path: "packages/api-client", desc: "API client" },
+        { path: "packages/database", desc: "Database" },
+        { path: "packages/validators", desc: "Validators" },
+        { path: "packages/shared", desc: "Shared utils" },
+        { path: "packages/ui", desc: "UI components" },
+        { path: "packages/assets", desc: "Assets" },
+        { path: "apps/server", desc: "API server" },
+        { path: "docs", desc: "Documentation" },
+        { path: "mcp-server", desc: "MCP server" },
+        { path: ".claude", desc: "Agent commands" },
+    ];
+    const rootFiles = [
+        "package.json",
+        "pnpm-workspace.yaml",
+        "turbo.json",
+        "tsconfig.json",
+        ".env.example",
+        ".gitignore",
+        "nyoworks.config.yaml",
+    ];
+    for (const item of coreItems) {
+        process.stdout.write(pc.dim(`  Downloading ${item.desc}...`));
+        await downloadFromGitHub(REPO, item.path, path.join(targetDir, item.path), BRANCH);
+        console.log(pc.green(" ✓"));
+    }
+    for (const platform of platforms) {
+        process.stdout.write(pc.dim(`  Downloading apps/${platform}...`));
+        await downloadFromGitHub(REPO, `apps/${platform}`, path.join(targetDir, `apps/${platform}`), BRANCH);
+        console.log(pc.green(" ✓"));
+    }
+    process.stdout.write(pc.dim("  Downloading root files..."));
+    await downloadFromGitHub(REPO, "", targetDir, BRANCH);
+    const allPlatforms = ["web", "mobile", "desktop"];
+    for (const platform of allPlatforms) {
+        if (!platforms.includes(platform)) {
+            const platformDir = path.join(targetDir, "apps", platform);
+            if (await fs.pathExists(platformDir)) {
+                await fs.remove(platformDir);
+            }
+        }
+    }
+    const createNyoworksDir = path.join(targetDir, "packages", "create-nyoworks");
+    if (await fs.pathExists(createNyoworksDir)) {
+        await fs.remove(createNyoworksDir);
+    }
+    console.log(pc.green(" ✓"));
+    const placeholders = {
+        "${PROJECT_NAME}": name,
+        "${PROJECT_CODE}": code,
+        "${PROJECT_SLUG}": slug,
+        "${DATABASE_NAME}": databaseName,
+    };
+    process.stdout.write(pc.dim("  Replacing placeholders..."));
+    await replacePlaceholders(targetDir, placeholders);
+    console.log(pc.green(" ✓"));
+    for (const feature of features) {
+        const featureDoc = path.join(targetDir, "docs", "bible", "features", `${feature}.md`);
+        const content = `# Feature: ${feature.charAt(0).toUpperCase() + feature.slice(1)}
+
+## Overview
+
+> Describe what this feature does
+
+## Requirements
+
+- [ ] Requirement 1
+- [ ] Requirement 2
+
+## API Endpoints
+
+| Method | Path | Description |
+|--------|------|-------------|
+| GET | /api/${feature} | List items |
+| POST | /api/${feature} | Create item |
+
+## Data Model
+
+See \`docs/bible/data/schema.md\`
+
+## UI Components
+
+- [ ] Component 1
+- [ ] Component 2
+
+## Decisions
+
+| ID | Decision | Rationale |
+|----|----------|-----------|
+| T-xxx | [Decision] | [Why] |
+`;
+        await fs.outputFile(featureDoc, content);
+        console.log(pc.dim(`  Created docs/bible/features/${feature}.md`));
+    }
+    const configPath = path.join(targetDir, "nyoworks.config.yaml");
+    if (await fs.pathExists(configPath)) {
+        let config = await fs.readFile(configPath, "utf8");
+        if (features.length > 0) {
+            config = config.replace(/enabled: \[\]/, `enabled:\n${features.map((f) => `    - ${f}`).join("\n")}`);
+        }
+        config = config.replace(/targets:\n    - web/, `targets:\n${platforms.map((p) => `    - ${p}`).join("\n")}`);
+        await fs.writeFile(configPath, config);
+    }
+    console.log();
+    console.log(pc.green(pc.bold("Project created successfully!")));
+    console.log();
+    console.log("  Next steps:");
+    console.log();
+    console.log(pc.cyan(`    cd ${slug}`));
+    console.log(pc.cyan("    pnpm install"));
+    console.log(pc.cyan("    pnpm dev"));
+    console.log();
+    console.log(pc.dim("  Configuration:"));
+    console.log(pc.dim(`    Name: ${name}`));
+    console.log(pc.dim(`    Code: ${code}`));
+    console.log(pc.dim(`    Platforms: ${platforms.join(", ")}`));
+    console.log(pc.dim(`    Features: ${features.join(", ") || "none"}`));
+    console.log();
+}

package/dist/replace.d.ts

@@ -0,0 +1 @@
+export declare function replacePlaceholders(dir: string, placeholders: Record<string, string>): Promise<void>;

package/dist/replace.js

@@ -0,0 +1,31 @@
+import fs from "fs-extra";
+import path from "path";
+const EXTENSIONS = [".md", ".json", ".yaml", ".yml", ".ts", ".tsx", ".js", ".jsx", ".env", ".example"];
+const IGNORE_DIRS = ["node_modules", ".git", "dist", ".next", ".turbo"];
+export async function replacePlaceholders(dir, placeholders) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (!IGNORE_DIRS.includes(entry.name)) {
+                await replacePlaceholders(fullPath, placeholders);
+            }
+        }
+        else if (entry.isFile()) {
+            const ext = path.extname(entry.name);
+            if (EXTENSIONS.includes(ext) || entry.name.startsWith(".env")) {
+                let content = await fs.readFile(fullPath, "utf8");
+                let modified = false;
+                for (const [placeholder, value] of Object.entries(placeholders)) {
+                    if (content.includes(placeholder)) {
+                        content = content.split(placeholder).join(value);
+                        modified = true;
+                    }
+                }
+                if (modified) {
+                    await fs.writeFile(fullPath, content);
+                }
+            }
+        }
+    }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "create-nyoworks",
+  "version": "2.3.0",
+  "description": "Create a new NYOWORKS project",
+  "type": "module",
+  "bin": {
+    "create-nyoworks": "./dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "create",
+    "nyoworks",
+    "boilerplate",
+    "monorepo",
+    "typescript",
+    "nextjs",
+    "hono",
+    "trpc"
+  ],
+  "author": "NYOWORKS",
+  "license": "MIT",
+  "dependencies": {
+    "prompts": "^2.4.2",
+    "picocolors": "^1.1.1",
+    "fs-extra": "^11.2.0",
+    "execa": "^9.5.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^22.0.0",
+    "@types/prompts": "^2.4.9",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}