domain-driver 0.0.1

package/.idea/copilot.data.migration.ask2agent.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Ask2AgentMigrationStateService">
+    <option name="migrationStatus" value="COMPLETED" />
+  </component>
+</project>

package/.idea/domain-driver.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,5 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+  </profile>
+</component>

package/.idea/jsLibraryMappings.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="JavaScriptLibraryMappings">
+    <includedPredefinedLibrary name="Node.js Core" />
+  </component>
+</project>

package/.idea/material_theme_project_new.xml

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="MaterialThemeProjectNewConfig">
+    <option name="metadata">
+      <MTProjectMetadataState>
+        <option name="userId" value="3f40c18c:19cdf0955d0:-7e51" />
+      </MTProjectMetadataState>
+    </option>
+  </component>
+</project>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/domain-driver.iml" filepath="$PROJECT_DIR$/.idea/domain-driver.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/swift-toolchain.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="SwiftToolchain">
+    <option name="toolchain" value="system-/usr/bin/swift" />
+  </component>
+</project>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

package/README.md

@@ -0,0 +1,116 @@
+# domain-driver 🚀
+
+A CLI scaffolding tool for domain-driven development in Next.js. Generate feature folder structures instantly — like Laravel's `php artisan make` but for Next.js.
+
+---
+
+## Installation
+
+```bash
+npm install -g domain-driver
+```
+
+Or use without installing:
+
+```bash
+npx domain-driver make:feature <name>
+```
+
+---
+
+## Usage
+
+```bash
+domain-driver make:feature <feature-name>
+```
+
+### Examples
+
+```bash
+domain-driver make:feature api-key
+domain-driver make:feature user-profile
+domain-driver make:feature payment
+```
+
+---
+
+## What it generates
+
+Running `domain-driver make:feature api-key` creates the following structure inside your Next.js `app/` directory:
+
+```
+app/
+└── api-key/
+    ├── components/
+    │   ├── server/        # React Server Components
+    │   └── client/        # Client components ('use client')
+    ├── containers/        # Smart components — wire hooks → UI
+    ├── hooks/             # Feature-specific hooks (useApiKey, etc.)
+    ├── services/          # Business logic and transformations
+    ├── repositories/      # Data access layer (fetch/axios calls)
+    ├── schemas/           # Zod schemas for forms and API validation
+    └── page.tsx           # Next.js page entry point
+```
+
+Each folder includes a `.gitkeep` file so empty directories are tracked in Git.
+
+---
+
+## Philosophy
+
+This tool follows a strict **domain-driven** folder structure where everything related to a feature lives together. No more hunting across `/components`, `/hooks`, and `/services` top-level folders.
+
+The layer responsibilities are:
+
+- **repositories** — data fetching only, no business logic
+- **services** — business logic, calls repositories
+- **hooks** — React state and side effects, calls services
+- **containers** — wire hooks into UI, no direct data fetching
+- **components** — pure presentational UI, no data dependencies
+- **schemas** — Zod validation for both forms and API responses
+
+---
+
+## Requirements
+
+- Node.js 18+
+- A Next.js project with an `app/` directory (App Router)
+
+---
+
+## Local Development
+
+```bash
+# Clone the repo
+git clone https://github.com/yourname/domain-driver
+cd domain-driver
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Link globally for local testing
+npm link
+
+# Test it
+domain-driver make:feature test-feature
+```
+
+---
+
+## Roadmap
+
+- [ ] `make:component` — scaffold a single component
+- [ ] `make:hook` — scaffold a custom hook
+- [ ] `make:service` — scaffold a service
+- [ ] Framework detection — auto-adapt structure for Laravel, Go, etc.
+- [ ] Interactive mode — prompt for feature name if not provided
+- [ ] Config file — customize folder structure per project
+
+---
+
+## License
+
+MIT

package/dist/commands/feature.js

@@ -0,0 +1,71 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.makeFeature = makeFeature;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const FEATURE_DIRS = [
+    'components/server',
+    'components/client',
+    'containers',
+    'hooks',
+    'services',
+    'repositories',
+    'schemas',
+];
+function renderTemplate(name) {
+    const componentName = name
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join('');
+    return `export default function ${componentName}Page() {
+  return (
+    <div>
+      <h1>${componentName}</h1>
+    </div>
+  );
+}
+`;
+}
+async function makeFeature(name) {
+    const base = path.join(process.cwd(), 'app', name);
+    for (const dir of FEATURE_DIRS) {
+        fs.mkdirSync(path.join(base, dir), { recursive: true });
+        fs.writeFileSync(path.join(base, dir, '.gitkeep'), '');
+    }
+    const page = renderTemplate(name);
+    fs.writeFileSync(path.join(base, 'page.tsx'), page);
+    console.log(`✅ Feature "${name}" scaffolded at ${base}`);
+}

package/dist/index.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const feature_1 = require("./commands/feature");
+const [, , command, name] = process.argv;
+if (!command || !name) {
+    console.error('Usage: domain-driver make:feature <name>');
+    process.exit(1);
+}
+if (command === 'make:feature') {
+    (0, feature_1.makeFeature)(name);
+}
+else {
+    console.error(`Unknown command: ${command}`);
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "domain-driver",
+  "version": "0.0.1",
+  "description": "",
+  "main": "index.js",
+  "bin": {
+    "domain-driver": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "npx tsc",
+    "dev": "ts-node src/index.ts",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^25.4.0"
+  },
+  "dependencies": {
+    "typescript": "^5.9.3"
+  }
+}

package/src/commands/feature.ts

@@ -0,0 +1,42 @@
+import * as fs from 'fs';
+import * as path from 'path';
+
+const FEATURE_DIRS = [
+    'components/server',
+    'components/client',
+    'containers',
+    'hooks',
+    'services',
+    'repositories',
+    'schemas',
+];
+
+function renderTemplate(name: string): string {
+    const componentName = name
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join('');
+
+    return `export default function ${componentName}Page() {
+  return (
+    <div>
+      <h1>${componentName}</h1>
+    </div>
+  );
+}
+`;
+}
+
+export async function makeFeature(name: string) {
+    const base = path.join(process.cwd(), 'app', name);
+
+    for (const dir of FEATURE_DIRS) {
+        fs.mkdirSync(path.join(base, dir), { recursive: true });
+        fs.writeFileSync(path.join(base, dir, '.gitkeep'), '');
+    }
+
+    const page = renderTemplate(name);
+    fs.writeFileSync(path.join(base, 'page.tsx'), page);
+
+    console.log(`✅ Feature "${name}" scaffolded at ${base}`);
+}

package/src/index.ts

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+import { makeFeature } from './commands/feature';
+
+const [,, command, name] = process.argv;
+
+if (!command || !name) {
+    console.error('Usage: domain-driver make:feature <name>');
+    process.exit(1);
+}
+
+if (command === 'make:feature') {
+    makeFeature(name);
+} else {
+    console.error(`Unknown command: ${command}`);
+    process.exit(1);
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}