@forinda/kickjs-cli 1.2.2 → 1.2.4

package/dist/cli.js

@@ -272,6 +272,7 @@ export default defineConfig({
   },
 })
 `);
+  await writeFileSafe(join(dir, "README.md"), generateReadme(name, template, packageManager));
   if (options.initGit) {
     try {
       execSync("git init", {
@@ -429,6 +430,91 @@ bootstrap({
   }
 }
 __name(getEntryFile, "getEntryFile");
+function generateReadme(name, template, pm) {
+  const templateLabels = {
+    rest: "REST API",
+    graphql: "GraphQL API",
+    ddd: "Domain-Driven Design",
+    cqrs: "CQRS + Event-Driven",
+    minimal: "Minimal"
+  };
+  const packages = [
+    "@forinda/kickjs-core",
+    "@forinda/kickjs-http",
+    "@forinda/kickjs-config"
+  ];
+  if (template !== "minimal") {
+    packages.push("@forinda/kickjs-swagger", "@forinda/kickjs-devtools");
+  }
+  if (template === "graphql") packages.push("@forinda/kickjs-graphql");
+  if (template === "cqrs") {
+    packages.push("@forinda/kickjs-queue", "@forinda/kickjs-ws", "@forinda/kickjs-otel");
+  }
+  return `# ${name}
+
+A **${templateLabels[template] ?? "REST API"}** built with [KickJS](https://forinda.github.io/kick-js/) \u2014 a decorator-driven Node.js framework on Express 5 and TypeScript.
+
+## Getting Started
+
+\`\`\`bash
+${pm} install
+kick dev
+\`\`\`
+
+## Scripts
+
+| Command | Description |
+|---|---|
+| \`kick dev\` | Start dev server with Vite HMR |
+| \`kick build\` | Production build |
+| \`kick start\` | Run production build |
+| \`${pm} run test\` | Run tests with Vitest |
+| \`kick g module <name>\` | Generate a DDD module |
+| \`kick g scaffold <name> <fields...>\` | Generate CRUD from field definitions |
+| \`kick add <package>\` | Add a KickJS package |
+
+## Project Structure
+
+\`\`\`
+src/
+\u251C\u2500\u2500 index.ts           # Application entry point
+\u251C\u2500\u2500 modules/           # Feature modules (controllers, services, repos)
+\u2502   \u2514\u2500\u2500 index.ts       # Module registry
+\u2514\u2500\u2500 ...
+\`\`\`
+
+## Packages
+
+${packages.map((p) => `- \`${p}\``).join("\n")}
+
+## Adding Features
+
+\`\`\`bash
+kick add auth          # Authentication (JWT, API key, OAuth)
+kick add swagger       # OpenAPI documentation
+kick add ws            # WebSocket support
+kick add queue         # Background job processing
+kick add mailer        # Email sending
+kick add cron          # Scheduled tasks
+kick add --list        # Show all available packages
+\`\`\`
+
+## Environment Variables
+
+Copy \`.env.example\` to \`.env\` and configure:
+
+| Variable | Default | Description |
+|---|---|---|
+| \`PORT\` | \`3000\` | Server port |
+| \`NODE_ENV\` | \`development\` | Environment |
+
+## Learn More
+
+- [KickJS Documentation](https://forinda.github.io/kick-js/)
+- [CLI Reference](https://forinda.github.io/kick-js/api/cli.html)
+`;
+}
+__name(generateReadme, "generateReadme");
 
 // src/commands/init.ts
 function ask(question, defaultValue) {