@dhayalesh/create-service 0.0.1

package/generators/create-service/files/nestjs-clean/src/main.ts.template

@@ -0,0 +1,27 @@
+import { NestFactory } from '@nestjs/core';
+import { SwaggerModule, DocumentBuilder } from '@nestjs/swagger';
+import { AppModule } from './api/app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+
+  // Set global prefix with versioning, excluding operational endpoints
+  app.setGlobalPrefix('v1/api', {
+    exclude: ['health', '/'],
+  });
+
+  // Swagger Configuration
+  const config = new DocumentBuilder()
+    .setTitle('<%= name %>')
+    .setDescription('The <%= name %> API description')
+    .setVersion('1.0')
+    .build();
+  const document = SwaggerModule.createDocument(app, config);
+
+  SwaggerModule.setup('api/docs', app, document);
+
+  await app.listen(<%= port %>, '0.0.0.0');
+  console.log(`Application is running on: http://localhost:<%= port %>`);
+  console.log(`Swagger documentation: http://localhost:<%= port %>/api/docs`);
+}
+bootstrap();

package/generators/create-service/files/nestjs-clean/tsconfig.json.template

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "es2021",
+    "sourceMap": true,
+    "outDir": "../../dist/packages/<%= name %>",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": false,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "forceConsistentCasingInFileNames": false,
+    "noFallthroughCasesInSwitch": false
+  },
+  "include": ["src/**/*"]
+}

package/generators/create-service/files/nextjs/next.config.js.template

@@ -0,0 +1,8 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  experimental: {
+    appDir: true,
+  },
+}
+
+module.exports = nextConfig

package/generators/create-service/files/nextjs/package.json.template

@@ -0,0 +1,27 @@
+{
+  "name": "<%= name %>",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev -p <%= port %>",
+    "build": "next build",
+    "start": "next start -p <%= port %>",
+    "lint": "next lint"
+  },
+  "dependencies": {
+    "next": "^14.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "tailwindcss": "^3.3.0",
+    "autoprefixer": "^10.4.16",
+    "postcss": "^8.4.31"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "eslint": "^8.0.0",
+    "eslint-config-next": "^14.0.0"
+  }
+}

package/generators/create-service/files/nextjs/project.json.template

@@ -0,0 +1,37 @@
+{
+  "name": "<%= name %>",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "projectType": "application",
+  "sourceRoot": "<%= projectRoot %>/src",
+  "targets": {
+    "build": {
+      "executor": "nx:run-commands",
+      "options": {
+        "cwd": "<%= projectRoot %>",
+        "command": "next build"
+      },
+      "outputs": ["{workspaceRoot}/<%= projectRoot %>/.next"]
+    },
+    "dev": {
+      "executor": "nx:run-commands",
+      "options": {
+        "cwd": "<%= projectRoot %>",
+        "command": "next dev -p <%= port %>"
+      }
+    },
+    "start": {
+      "executor": "nx:run-commands",
+      "options": {
+        "cwd": "<%= projectRoot %>",
+        "command": "next start -p <%= port %>"
+      }
+    },
+    "lint": {
+      "executor": "nx:run-commands",
+      "options": {
+        "cwd": "<%= projectRoot %>",
+        "command": "next lint"
+      }
+    }
+  }
+}

package/generators/create-service/files/nextjs/src/app/globals.css.template

@@ -0,0 +1,61 @@
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+        * {
+          margin: 0;
+          padding: 0;
+          box-sizing: border-box;
+          font-family: "Segoe UI", Tahoma, Geneva, Verdana, sans-serif;
+        }
+    
+        body {
+          height: 100vh;
+          background: linear-gradient(135deg, #dbd9ff, #6366f1);
+          display: flex;
+          align-items: center;
+          justify-content: center;
+          color: #ffffff;
+        }
+    
+        .container {
+          text-align: center;
+          max-width: 600px;
+          padding: 40px;
+          background: rgba(255, 255, 255, 0.1);
+          border-radius: 16px;
+          backdrop-filter: blur(10px);
+          box-shadow: 0 10px 40px rgba(0, 0, 0, 0.2);
+        }
+    
+        h1 {
+          font-size: 2.5rem;
+          margin-bottom: 15px;
+        }
+    
+        p {
+          font-size: 1.1rem;
+          margin-bottom: 30px;
+          opacity: 0.9;
+        }
+    
+        .btn {
+          display: inline-block;
+          padding: 14px 32px;
+          background: #ffffff;
+          font-weight: bold;
+          border-radius: 30px;
+          text-decoration: none;
+          transition: all 0.3s ease;
+        }
+    
+        .btn:hover {
+          transform: translateY(-2px);
+          background: #e0e7ff;
+        }
+    
+        footer {
+          margin-top: 25px;
+          font-size: 0.85rem;
+          opacity: 0.7;
+        }

package/generators/create-service/files/nextjs/src/app/layout.tsx.template

@@ -0,0 +1,21 @@
+import './globals.css'
+import { Inter } from 'next/font/google'
+
+const inter = Inter({ subsets: ['latin'] })
+
+export const metadata = {
+  title: '<%= name %>',
+  description: 'Generated by KTern',
+}
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <html lang="en">
+      <body className={inter.className}>{children}</body>
+    </html>
+  )
+}

package/generators/create-service/files/nextjs/src/app/page.tsx.template

@@ -0,0 +1,16 @@
+export default function Home() {
+  return (
+    <div className="container">
+      <h1>Welcome to Your App</h1>
+      <p>
+        Build, explore, and grow with a simple and powerful platform.
+      </p>
+
+      <a href="#" className="btn">Get Started</a>
+
+      <footer>
+        KTern
+      </footer>
+    </div>
+  )
+}

package/generators/create-service/files/nextjs/tailwind.config.js.template

@@ -0,0 +1,18 @@
+/** @type {import('tailwindcss').Config} */
+module.exports = {
+  content: [
+    './src/pages/**/*.{js,ts,jsx,tsx,mdx}',
+    './src/components/**/*.{js,ts,jsx,tsx,mdx}',
+    './src/app/**/*.{js,ts,jsx,tsx,mdx}',
+  ],
+  theme: {
+    extend: {
+      backgroundImage: {
+        'gradient-radial': 'radial-gradient(var(--tw-gradient-stops))',
+        'gradient-conic':
+          'conic-gradient(from 180deg at 50% 50%, var(--tw-gradient-stops))',
+      },
+    },
+  },
+  plugins: [],
+}

package/generators/create-service/files/nextjs/tsconfig.json.template

@@ -0,0 +1,28 @@
+{
+  "compilerOptions": {
+    "target": "es5",
+    "lib": ["dom", "dom.iterable", "es6"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/generators/create-service/files/node/package.json.template

@@ -0,0 +1,12 @@
+{
+  "name": "<%= name %>",
+  "version": "0.0.1",
+  "private": true,
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^18.11.9",
+    "typescript": "~5.5.2"
+  }
+}

package/generators/create-service/files/node/project.json.template

@@ -0,0 +1,24 @@
+{
+  "name": "<%= name %>",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "<%= projectRoot %>/src",
+  "projectType": "application",
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/<%= name %>",
+        "main": "<%= projectRoot %>/src/main.ts",
+        "tsConfig": "<%= projectRoot %>/tsconfig.json",
+         "assets": []
+      }
+    },
+    "serve": {
+      "executor": "@nx/js:node",
+      "options": {
+        "buildTarget": "<%= name %>:build"
+      }
+    }
+  }
+}

package/generators/create-service/files/node/src/main.ts.template

@@ -0,0 +1 @@
+console.log('Hello from <%= name %>!');

package/generators/create-service/files/node/tsconfig.json.template

@@ -0,0 +1,9 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "target": "es2020",
+    "sourceMap": true,
+    "outDir": "dist"
+  },
+  "include": ["src/**/*"]
+}

package/generators/create-service/files/rust/Cargo.toml.template

@@ -0,0 +1,7 @@
+[package]
+name = "<%= name %>"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
+actix-web = "4.12.0"

package/generators/create-service/files/rust/Dockerfile.template

@@ -0,0 +1,4 @@
+FROM rust:1.75 as builder
+WORKDIR /usr/src/app
+COPY . .
+RUN cargo install --path .

package/generators/create-service/files/rust/project.json.template

@@ -0,0 +1,21 @@
+{
+  "name": "<%= name %>",
+  "targets": {
+    "build": {
+      "executor": "nx:run-commands",
+      "options": {
+        "cwd": "<%= projectRoot %>",
+        "command": "cargo build",
+        "bin": "<%= name %>"
+      }
+    },
+    "serve": {
+      "executor": "nx:run-commands",
+      "options": {
+        "cwd": "<%= projectRoot %>",
+        "command": "cargo run",
+        "bin": "<%= name %>"
+      }
+    }
+  }
+}

package/generators/create-service/files/rust/src/lib.rs.template

@@ -0,0 +1,4 @@
+mod infrastructure;
+mod api;
+mod domain;
+mod application;

package/generators/create-service/files/rust/src/main.rs.template

@@ -0,0 +1,17 @@
+use actix_web::{get, App, HttpResponse, HttpServer, Responder};
+
+#[get("/health")]
+async fn health_check() -> impl Responder {
+    HttpResponse::Ok().body("OK")
+}
+
+#[actix_web::main]
+async fn main() -> std::io::Result<()> {
+    HttpServer::new(|| {
+        App::new()
+            .service(health_check)
+    })
+    .bind(("127.0.0.1", 8080))?
+    .run()
+    .await
+}

package/generators/create-service/files/rust-simple/Cargo.toml.template

@@ -0,0 +1,7 @@
+[package]
+name = "<%= name %>"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
+actix-web = "4.12.0"

package/generators/create-service/files/rust-simple/project.json.template

@@ -0,0 +1,19 @@
+{
+  "name": "<%= name %>",
+  "targets": {
+    "build": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "cargo build",
+        "bin": "<%= name %>"
+      }
+    },
+    "serve": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "cargo run",
+        "bin": "<%= name %>"
+      }
+    }
+  }
+}

package/generators/create-service/files/rust-simple/src/main.rs.template

@@ -0,0 +1,17 @@
+use actix_web::{get, App, HttpResponse, HttpServer, Responder};
+
+#[get("/health")]
+async fn health_check() -> impl Responder {
+    HttpResponse::Ok().body("OK")
+}
+
+#[actix_web::main]
+async fn main() -> std::io::Result<()> {
+    HttpServer::new(|| {
+        App::new()
+            .service(health_check)
+    })
+    .bind(("127.0.0.1", 8080))?
+    .run()
+    .await
+}

package/generators/create-service/generator.d.ts

@@ -0,0 +1,12 @@
+import type { Tree } from '@nx/devkit';
+interface CreateServiceOptions {
+    name: string;
+    language: string;
+    folderStructure: string;
+    port?: number;
+    location?: string;
+}
+export default function (tree: Tree, options: CreateServiceOptions): Promise<GeneratorCallback>;
+import type { GeneratorCallback } from '@nx/devkit';
+export {};
+//# sourceMappingURL=generator.d.ts.map

package/generators/create-service/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../../packages/create-service/src/generators/create-service/generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAIvC,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,yBAA+B,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,8BA+GvE;AAED,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC"}

package/generators/create-service/generator.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = default_1;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const path = tslib_1.__importStar(require("path"));
+async function default_1(tree, options) {
+    // 🔥 Normalize name ONCE
+    const normalized = (0, devkit_1.names)(options.name);
+    const serviceName = normalized.fileName; // kebab-case guaranteed
+    // Default to 'apps' if not specified for backward compatibility, or strictly enforce.
+    // Given user request, we assume it's prompted.
+    const location = options.location || 'apps/api';
+    const projectRoot = `${location}/${serviceName}`;
+    if (tree.exists(projectRoot)) {
+        throw new Error(`❌ Service "${serviceName}" already exists at ${projectRoot}.
+  Choose a different name or delete the existing service.`);
+    }
+    if (options.language === 'rust') {
+        if (options.folderStructure === 'clean core') {
+            (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'files/rust'), projectRoot, {
+                ...options,
+                name: serviceName,
+                projectRoot: projectRoot,
+                tmpl: "",
+            });
+        }
+        else {
+            (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'files/rust-simple'), projectRoot, {
+                ...options,
+                name: serviceName,
+                projectRoot: projectRoot,
+                tmpl: "",
+            });
+        }
+    }
+    else if (options.language === 'nestjs') {
+        const templatePath = options.folderStructure === 'clean core'
+            ? 'files/nestjs-clean'
+            : 'files/nestjs';
+        (0, devkit_1.generateFiles)(tree, path.join(__dirname, templatePath), projectRoot, {
+            ...options,
+            name: serviceName,
+            port: options.port || 3000,
+            projectRoot: projectRoot,
+            tmpl: "",
+        });
+    }
+    else if (options.language === 'nextjs') {
+        (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'files/nextjs'), projectRoot, {
+            ...options,
+            name: serviceName,
+            port: options.port || 3000,
+            projectRoot: projectRoot,
+            tmpl: "",
+        });
+    }
+    else if (options.language === 'go') {
+        if (options.folderStructure === 'clean core') {
+            (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'files/go'), projectRoot, {
+                ...options,
+                name: serviceName,
+                projectRoot: projectRoot,
+                tmpl: "",
+            });
+        }
+        else {
+            (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'files/go-simple'), projectRoot, { ...options, name: serviceName, projectRoot: projectRoot, tmpl: "" });
+        }
+    }
+    else {
+        // Node (JS/TS)
+        (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'files/node'), projectRoot, {
+            ...options,
+            name: serviceName,
+            projectRoot: projectRoot,
+            tmpl: "",
+        });
+        // Handle JS/TS entry files
+        if (options.language === 'js') {
+            tree.delete(path.join(projectRoot, 'src/main.ts'));
+            // Create main.js for JavaScript projects
+            const mainJsContent = `console.log('Hello from ${serviceName} service!')'`;
+            tree.write(path.join(projectRoot, 'src/main.js'), mainJsContent);
+        }
+        else {
+            tree.delete(path.join(projectRoot, 'src/main.js'));
+        }
+    }
+    // Update workspace file - DISABLED due to JSON parsing issues
+    // const workspaceFile = 'ktern.code-workspace';
+    // if (tree.exists(workspaceFile)) {
+    //   const workspaceContent = tree.read(workspaceFile, 'utf-8');
+    //   if (workspaceContent) {
+    //     const workspace = JSON.parse(workspaceContent);
+    //     workspace.folders.push({
+    //       name: `ktern ${serviceName}`,
+    //       path: projectRoot
+    //     });
+    //     tree.write(workspaceFile, JSON.stringify(workspace, null, 2));
+    //   }
+    // }
+    await (0, devkit_1.formatFiles)(tree);
+    return printNextSteps(serviceName, options.language, projectRoot);
+}
+function printNextSteps(serviceName, language, projectRoot) {
+    return () => {
+        console.log(`
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+✅ Service "${serviceName}" created successfully
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  
+Next steps:
+  cd ${projectRoot}
+`);
+        if (language === 'rust') {
+            console.log(`
+  cargo build
+  cargo run
+`);
+        }
+        if (language === 'go') {
+            console.log(`
+  go mod tidy
+  go run main.go
+`);
+        }
+        if (['node', 'ts', 'js', 'nestjs', 'nextjs'].includes(language)) {
+            console.log(`
+  pnpm install
+  pnpm nx ${language === 'nextjs' ? 'dev' : 'serve'} ${serviceName}
+`);
+        }
+    };
+}

package/generators/create-service/schema.json

@@ -0,0 +1,62 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "create-service",
+  "title": "Create Service",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Service name",
+      "$default": {
+        "$source": "argv",
+        "index": 0
+      },
+      "x-prompt": "What is the service name?"
+    },
+    "language": {
+      "type": "string",
+      "description": "Language",
+      "enum": [
+        "ts",
+        "js",
+        "rust",
+        "nestjs",
+        "nextjs",
+        "go"
+      ],
+      "x-prompt": "Which language do you want to use?"
+    },
+    "folderStructure": {
+      "type": "string",
+      "description": "Folder Structure",
+      "enum": [
+        "normal",
+        "clean core"
+      ],
+      "x-prompt": "Which folder structure do you want to use?"
+    },
+    "location": {
+      "type": "string",
+      "description": "Service location",
+      "enum": [
+        "packages/apps/web",
+        "packages/apps/api",
+        "domains",
+        "infrastructure",
+        "platform"
+      ],
+      "x-prompt": "Where should this service be located?"
+    },
+    "port": {
+      "type": "number",
+      "description": "Port to run the service on",
+      "default": 3000,
+      "x-prompt": "What port should the service run on?"
+    }
+  },
+  "required": [
+    "name",
+    "language",
+    "folderStructure"
+  ]
+}