create-featurebased-architecture-backend 1.0.0

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "create-featurebased-architecture-backend",
+  "version": "1.0.0",
+  "description": "CLI to scaffold feature-based architecture projects with Bun, Hono, React",
+  "type": "module",
+  "bin": {
+    "create-featurebased-architecture-backend": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir ./dist --target node",
+    "dev": "bun run ./src/index.ts",
+    "prepublishOnly": "bun run build"
+  },
+  "keywords": [
+    "cli",
+    "scaffold",
+    "feature-based",
+    "architecture",
+    "hono",
+    "bun",
+    "typescript",
+    "react",
+    "boilerplate"
+  ],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^20.10.0"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.7.0",
+    "picocolors": "^1.0.0"
+  }
+}

package/templates/blank-hono/.env.example

@@ -0,0 +1,4 @@
+# Environment Variables
+DATABASE_URL=postgresql://user:password@your-neon-host.neon.tech/dbname?sslmode=require
+PORT=3000
+NODE_ENV=development

package/templates/blank-hono/README.md

@@ -0,0 +1,53 @@
+# {{PROJECT_NAME}}
+
+A feature-based architecture backend built with Bun and Hono.
+
+## Project Structure
+
+```
+src/
+├── config/           # Configuration (env, database)
+├── features/         # Feature modules
+│   └── [feature]/
+│       ├── routes.ts
+│       ├── controller.ts
+│       ├── service.ts
+│       ├── repository.ts
+│       └── types.ts
+├── routes/           # Route aggregation
+├── shared/           # Shared utilities and types
+│   ├── types/
+│   └── utils/
+└── index.ts          # Application entry
+```
+
+## Getting Started
+
+```bash
+# Install dependencies
+bun install
+
+# Copy environment file
+cp .env.example .env
+
+# Run development server
+bun run dev
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `DATABASE_URL` | NeonDB PostgreSQL connection string |
+| `PORT` | Server port (default: 3000) |
+| `NODE_ENV` | Environment (development/production) |
+
+## Database Setup (NeonDB)
+
+Create your tables in NeonDB console or using a migration tool.
+
+## Adding a New Feature
+
+1. Create a folder in `src/features/[feature-name]`
+2. Add the required files (routes, controller, service, repository, types)
+3. Register the routes in `src/routes/index.ts`

package/templates/blank-hono/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "bun run --watch src/index.ts",
+    "start": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir ./dist --target bun"
+  },
+  "dependencies": {
+    "hono": "^4.11.3",
+    "@neondatabase/serverless": "^0.9.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.0.0"
+  }
+}

package/templates/blank-hono/src/config/database.ts

@@ -0,0 +1,4 @@
+import { neon } from "@neondatabase/serverless";
+import { env } from "./env";
+
+export const sql = neon(env.DATABASE_URL);

package/templates/blank-hono/src/config/env.ts

@@ -0,0 +1,5 @@
+export const env = {
+  DATABASE_URL: process.env.DATABASE_URL || "",
+  PORT: Number(process.env.PORT) || 3000,
+  NODE_ENV: process.env.NODE_ENV || "development",
+} as const;

package/templates/blank-hono/src/config/index.ts

@@ -0,0 +1,2 @@
+export * from "./env";
+export * from "./database";

package/templates/blank-hono/src/features/.gitkeep.ts

@@ -0,0 +1,21 @@
+/*
+  Feature-Based Architecture
+
+  Each feature folder should contain:
+  - routes.ts     - Route definitions
+  - controller.ts - Request handlers
+  - service.ts    - Business logic
+  - repository.ts - Database operations
+  - types.ts      - Feature-specific types
+  - schema.ts     - Validation schemas (optional)
+
+  Example structure:
+  features/
+    users/
+      routes.ts
+      controller.ts
+      service.ts
+      repository.ts
+      types.ts
+*/
+export {};

package/templates/blank-hono/src/index.ts

@@ -0,0 +1,22 @@
+import { Hono } from "hono";
+import { cors } from "hono/cors";
+import { logger } from "hono/logger";
+import { env } from "./config/env";
+import { appRouter } from "./routes";
+
+const app = new Hono();
+
+// Middleware
+app.use("*", logger());
+app.use("*", cors());
+
+// Routes
+app.route("/api", appRouter);
+
+// Health check
+app.get("/health", (c) => c.json({ status: "ok", timestamp: new Date().toISOString() }));
+
+export default {
+  port: env.PORT,
+  fetch: app.fetch,
+};

package/templates/blank-hono/src/routes/index.ts

@@ -0,0 +1,8 @@
+import { Hono } from "hono";
+
+export const appRouter = new Hono();
+
+// Register feature routes here
+// Example: appRouter.route("/users", usersRouter);
+
+appRouter.get("/", (c) => c.json({ message: "API is running" }));

package/templates/blank-hono/src/shared/index.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./utils";

package/templates/blank-hono/src/shared/types/index.ts

@@ -0,0 +1,16 @@
+// Shared types across features
+export interface ApiResponse<T> {
+  success: boolean;
+  data?: T;
+  error?: string;
+  message?: string;
+}
+
+export interface PaginatedResponse<T> extends ApiResponse<T[]> {
+  pagination: {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+  };
+}

package/templates/blank-hono/src/shared/utils/index.ts

@@ -0,0 +1 @@
+export * from "./response";

package/templates/blank-hono/src/shared/utils/response.ts

@@ -0,0 +1,10 @@
+import type { Context } from "hono";
+import type { ApiResponse } from "../types";
+
+export function successResponse<T>(c: Context, data: T, message?: string, status = 200) {
+  return c.json<ApiResponse<T>>({ success: true, data, message }, status);
+}
+
+export function errorResponse(c: Context, error: string, status = 400) {
+  return c.json<ApiResponse<never>>({ success: false, error }, status);
+}

package/templates/blank-hono/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"],
+      "@/features/*": ["src/features/*"],
+      "@/shared/*": ["src/shared/*"],
+      "@/config/*": ["src/config/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/blank-ts/README.md

@@ -0,0 +1,30 @@
+# {{PROJECT_NAME}}
+
+A feature-based TypeScript project built with Bun.
+
+## Project Structure
+
+```
+src/
+├── features/         # Feature modules
+│   └── [feature]/
+│       ├── index.ts
+│       ├── types.ts
+│       └── utils.ts
+├── shared/           # Shared utilities
+│   └── utils/
+└── index.ts          # Application entry
+```
+
+## Getting Started
+
+```bash
+# Install dependencies
+bun install
+
+# Run development
+bun run dev
+
+# Build
+bun run build
+```

package/templates/blank-ts/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "bun run --watch src/index.ts",
+    "start": "bun run src/index.ts",
+    "build": "bun build src/index.ts --outdir ./dist --target bun"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.0.0"
+  }
+}

package/templates/blank-ts/src/features/.gitkeep.ts

@@ -0,0 +1,16 @@
+/*
+  Feature-Based Architecture
+
+  Each feature folder should contain:
+  - index.ts      - Feature entry point
+  - types.ts      - Feature-specific types
+  - utils.ts      - Feature utilities (optional)
+
+  Example structure:
+  features/
+    my-feature/
+      index.ts
+      types.ts
+      utils.ts
+*/
+export {};

package/templates/blank-ts/src/index.ts

@@ -0,0 +1,7 @@
+import { greet } from "./shared/utils";
+
+function main(): void {
+  console.log(greet("World"));
+}
+
+main();

package/templates/blank-ts/src/shared/utils/index.ts

@@ -0,0 +1,3 @@
+export function greet(name: string): string {
+  return `Hello, ${name}!`;
+}

package/templates/blank-ts/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"],
+      "@/features/*": ["src/features/*"],
+      "@/shared/*": ["src/shared/*"]
+    }
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/react/README.md

@@ -0,0 +1,34 @@
+# {{PROJECT_NAME}}
+
+A feature-based React application built with Vite and Bun.
+
+## Project Structure
+
+```
+src/
+├── features/         # Feature modules
+│   └── [feature]/
+│       ├── components/
+│       ├── hooks/
+│       ├── services/
+│       ├── types.ts
+│       └── index.ts
+├── shared/           # Shared components and utilities
+│   └── components/
+├── App.tsx
+├── main.tsx
+└── index.css
+```
+
+## Getting Started
+
+```bash
+# Install dependencies
+bun install
+
+# Run development server
+bun run dev
+
+# Build for production
+bun run build
+```

package/templates/react/index.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{PROJECT_NAME}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/react/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "bunx --bun vite",
+    "build": "bunx --bun vite build",
+    "preview": "bunx --bun vite preview"
+  },
+  "dependencies": {
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "react-router-dom": "^6.20.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@vitejs/plugin-react": "^4.2.0",
+    "typescript": "^5.0.0",
+    "vite": "^5.0.0"
+  }
+}

package/templates/react/src/App.tsx

@@ -0,0 +1,10 @@
+import { Routes, Route } from "react-router-dom";
+import { HomePage } from "./features/home";
+
+export function App() {
+  return (
+    <Routes>
+      <Route path="/" element={<HomePage />} />
+    </Routes>
+  );
+}

package/templates/react/src/features/home/components/HomePage.tsx

@@ -0,0 +1,8 @@
+export function HomePage() {
+  return (
+    <div style={{ padding: "2rem", textAlign: "center" }}>
+      <h1>Welcome</h1>
+      <p>Feature-based React architecture</p>
+    </div>
+  );
+}

package/templates/react/src/features/home/index.ts

@@ -0,0 +1 @@
+export * from "./components/HomePage";

package/templates/react/src/index.css

@@ -0,0 +1,10 @@
+* {
+  margin: 0;
+  padding: 0;
+  box-sizing: border-box;
+}
+
+body {
+  font-family: system-ui, -apple-system, sans-serif;
+  line-height: 1.5;
+}

package/templates/react/src/main.tsx

@@ -0,0 +1,13 @@
+import React from "react";
+import ReactDOM from "react-dom/client";
+import { BrowserRouter } from "react-router-dom";
+import { App } from "./App";
+import "./index.css";
+
+ReactDOM.createRoot(document.getElementById("root")!).render(
+  <React.StrictMode>
+    <BrowserRouter>
+      <App />
+    </BrowserRouter>
+  </React.StrictMode>
+);

package/templates/react/src/shared/components/Button.tsx

@@ -0,0 +1,29 @@
+import type { ReactNode } from "react";
+
+interface ButtonProps {
+  children: ReactNode;
+  onClick?: () => void;
+  variant?: "primary" | "secondary";
+}
+
+export function Button({ children, onClick, variant = "primary" }: ButtonProps) {
+  const styles = {
+    primary: { background: "#0070f3", color: "white" },
+    secondary: { background: "#eaeaea", color: "#333" },
+  };
+
+  return (
+    <button
+      onClick={onClick}
+      style={{
+        ...styles[variant],
+        padding: "0.5rem 1rem",
+        border: "none",
+        borderRadius: "4px",
+        cursor: "pointer",
+      }}
+    >
+      {children}
+    </button>
+  );
+}

package/templates/react/src/shared/components/index.ts

@@ -0,0 +1 @@
+export * from "./Button";

package/templates/react/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "useDefineForClassFields": true,
+    "lib": ["ES2020", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "skipLibCheck": true,
+    "moduleResolution": "bundler",
+    "allowImportingTsExtensions": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["src/*"],
+      "@/features/*": ["src/features/*"],
+      "@/shared/*": ["src/shared/*"]
+    }
+  },
+  "include": ["src"],
+  "references": [{ "path": "./tsconfig.node.json" }]
+}

package/templates/react/tsconfig.node.json

@@ -0,0 +1,11 @@
+{
+  "compilerOptions": {
+    "composite": true,
+    "skipLibCheck": true,
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "allowSyntheticDefaultImports": true,
+    "strict": true
+  },
+  "include": ["vite.config.ts"]
+}

package/templates/react/vite.config.ts

@@ -0,0 +1,12 @@
+import { defineConfig } from "vite";
+import react from "@vitejs/plugin-react";
+import path from "path";
+
+export default defineConfig({
+  plugins: [react()],
+  resolve: {
+    alias: {
+      "@": path.resolve(__dirname, "./src"),
+    },
+  },
+});

package/templates/user-management-backend/.env.example

@@ -0,0 +1,4 @@
+# Environment Variables
+DATABASE_URL=postgresql://user:password@your-neon-host.neon.tech/dbname?sslmode=require
+PORT=3000
+NODE_ENV=development