@khalisoft/nexcl 1.0.0

package/bin/cli.ts

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import prompts from "prompts";
+import createProject from "../utils/createProject";
+
+const program = new Command();
+
+program
+	.name("nexcl")
+	.description("Next.js CLI with built-in /ctrl admin system")
+	.argument("[project-name]")
+	.action(async (name: string) => {
+		const response = await prompts([
+			{
+				type: "text",
+				name: "projectName",
+				message: "Project name:",
+				initial: name || "my-app",
+			},
+			{
+				type: "confirm",
+				name: "addAdmin",
+				message: "Include /ctrl admin panel?",
+				initial: true,
+			},
+		]);
+
+		await createProject(response);
+	});
+
+program.parse();

package/dist/bin/cli.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import prompts from "prompts";
+import createProject from "../utils/createProject";
+const program = new Command();
+program
+    .name("nexcl")
+    .description("Next.js CLI with built-in /ctrl admin system")
+    .argument("[project-name]")
+    .action(async (name) => {
+    const response = await prompts([
+        {
+            type: "text",
+            name: "projectName",
+            message: "Project name:",
+            initial: name || "my-app",
+        },
+        {
+            type: "confirm",
+            name: "addAdmin",
+            message: "Include /ctrl admin panel?",
+            initial: true,
+        },
+    ]);
+    await createProject(response);
+});
+program.parse();

package/dist/utils/createProject.js

@@ -0,0 +1,37 @@
+import { execa } from "execa";
+import ora from "ora";
+import path from "path";
+import injectCtrl from "./injectCtrl";
+export default async function createProject({ projectName, addAdmin, }) {
+    const spinner = ora("Creating Next.js app...").start();
+    try {
+        // ✅ Create Next.js with TypeScript
+        await execa("npx", [
+            "create-next-app@latest",
+            projectName,
+            "--ts",
+            "--app",
+            "--eslint",
+            "--src-dir",
+            "--import-alias=@/*",
+            "--yes",
+        ], { stdio: "inherit" });
+        spinner.succeed("Next.js app created");
+        const target = path.join(process.cwd(), projectName);
+        if (addAdmin) {
+            await injectCtrl(target);
+        }
+        const installSpinner = ora("Installing extra dependencies...").start();
+        await execa("npm", ["install", "axios", "zustand"], {
+            cwd: target,
+            stdio: "inherit",
+        });
+        installSpinner.succeed("Dependencies installed");
+        console.log("\n✅ Done!");
+        console.log(`cd ${projectName} && npm run dev`);
+    }
+    catch (error) {
+        spinner.fail("Failed");
+        console.error(error);
+    }
+}

package/dist/utils/injectCtrl.js

@@ -0,0 +1,77 @@
+import fs from "fs-extra";
+import path from "path";
+export default async function injectCtrl(target) {
+    const ctrlPath = path.join(target, "app/ctrl");
+    await fs.ensureDir(ctrlPath);
+    await fs.ensureDir(path.join(ctrlPath, "pages"));
+    await fs.ensureDir(path.join(ctrlPath, "users"));
+    await fs.ensureDir(path.join(ctrlPath, "settings"));
+    // Layout
+    await fs.writeFile(path.join(ctrlPath, "layout.tsx"), `
+import React from "react";
+
+export default function CtrlLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <div style={{ display: "flex" }}>
+      <aside style={{ width: 250, padding: 20 }}>
+        <h2>Admin</h2>
+        <nav>
+          <a href="/ctrl">Dashboard</a><br />
+          <a href="/ctrl/pages">Pages</a><br />
+          <a href="/ctrl/users">Users</a><br />
+          <a href="/ctrl/settings">Settings</a>
+        </nav>
+      </aside>
+
+      <main style={{ flex: 1, padding: 20 }}>
+        {children}
+      </main>
+    </div>
+  );
+}
+`);
+    // Dashboard
+    await fs.writeFile(path.join(ctrlPath, "page.tsx"), `
+export default function Page() {
+  return <h1>Admin Dashboard</h1>;
+}
+`);
+    // Pages
+    await fs.writeFile(path.join(ctrlPath, "pages/page.tsx"), `
+export default function PagesPage() {
+  return <div>Pages Management</div>;
+}
+`);
+    // Users
+    await fs.writeFile(path.join(ctrlPath, "users/page.tsx"), `
+export default function UsersPage() {
+  return <div>Users Management</div>;
+}
+`);
+    // Settings
+    await fs.writeFile(path.join(ctrlPath, "settings/page.tsx"), `
+export default function SettingsPage() {
+  return <div>Settings</div>;
+}
+`);
+    // Middleware
+    await fs.writeFile(path.join(target, "src/middleware.ts"), `
+import { NextResponse } from "next/server";
+import type { NextRequest } from "next/server";
+
+export function middleware(req: NextRequest) {
+  if (req.nextUrl.pathname.startsWith("/ctrl")) {
+    const isAdmin = true;
+
+    if (!isAdmin) {
+      return NextResponse.redirect(new URL("/", req.url));
+    }
+  }
+}
+`);
+    console.log("✅ /ctrl injected (TypeScript)");
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@khalisoft/nexcl",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Next.js CLI with built-in admin (/ctrl)",
+  "bin": {
+    "nexcl": "./dist/bin/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx bin/cli.ts"
+  },
+  "keywords": [
+    "nextjs",
+    "cli",
+    "scaffold"
+  ],
+  "license": "MIT",
+  "author": "Devkaahl",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "execa": "^9.6.1",
+    "fs-extra": "^11.3.4",
+    "ora": "^9.3.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.5.0",
+    "@types/prompts": "^2.4.9",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,57 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Node",
+    "outDir": "dist",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true
+  },
+  "include": ["bin", "utils"]
+}
+
+// {
+//   // Visit https://aka.ms/tsconfig to read more about this file
+//   "compilerOptions": {
+//     // File Layout
+//     // "rootDir": "./src",
+//     // "outDir": "./dist",
+
+//     // Environment Settings
+//     // See also https://aka.ms/tsconfig/module
+//     "module": "nodenext",
+//     "target": "esnext",
+//     "types": [],
+//     // For nodejs:
+//     // "lib": ["esnext"],
+//     // "types": ["node"],
+//     // and npm install -D @types/node
+
+//     // Other Outputs
+//     "sourceMap": true,
+//     "declaration": true,
+//     "declarationMap": true,
+
+//     // Stricter Typechecking Options
+//     "noUncheckedIndexedAccess": true,
+//     "exactOptionalPropertyTypes": true,
+
+//     // Style Options
+//     // "noImplicitReturns": true,
+//     // "noImplicitOverride": true,
+//     // "noUnusedLocals": true,
+//     // "noUnusedParameters": true,
+//     // "noFallthroughCasesInSwitch": true,
+//     // "noPropertyAccessFromIndexSignature": true,
+
+//     // Recommended Options
+//     "strict": true,
+//     "jsx": "react-jsx",
+//     "verbatimModuleSyntax": true,
+//     "isolatedModules": true,
+//     "noUncheckedSideEffectImports": true,
+//     "moduleDetection": "force",
+//     "skipLibCheck": true,
+//   }
+// }

package/utils/createProject.ts

@@ -0,0 +1,57 @@
+import { execa } from "execa";
+import ora from "ora";
+import path from "path";
+import injectCtrl from "./injectCtrl";
+
+interface Options {
+	projectName: string;
+	addAdmin: boolean;
+}
+
+export default async function createProject({
+	projectName,
+	addAdmin,
+}: Options) {
+	const spinner = ora("Creating Next.js app...").start();
+
+	try {
+		// ✅ Create Next.js with TypeScript
+		await execa(
+			"npx",
+			[
+				"create-next-app@latest",
+				projectName,
+				"--ts",
+				"--app",
+				"--eslint",
+				"--src-dir",
+				"--import-alias=@/*",
+				"--yes",
+			],
+			{ stdio: "inherit" },
+		);
+
+		spinner.succeed("Next.js app created");
+
+		const target = path.join(process.cwd(), projectName);
+
+		if (addAdmin) {
+			await injectCtrl(target);
+		}
+
+		const installSpinner = ora("Installing extra dependencies...").start();
+
+		await execa("npm", ["install", "axios", "zustand"], {
+			cwd: target,
+			stdio: "inherit",
+		});
+
+		installSpinner.succeed("Dependencies installed");
+
+		console.log("\n✅ Done!");
+		console.log(`cd ${projectName} && npm run dev`);
+	} catch (error) {
+		spinner.fail("Failed");
+		console.error(error);
+	}
+}

package/utils/injectCtrl.ts

@@ -0,0 +1,103 @@
+import fs from "fs-extra";
+import path from "path";
+
+export default async function injectCtrl(target: string) {
+	const ctrlPath = path.join(target, "app/ctrl");
+
+	await fs.ensureDir(ctrlPath);
+	await fs.ensureDir(path.join(ctrlPath, "pages"));
+	await fs.ensureDir(path.join(ctrlPath, "users"));
+	await fs.ensureDir(path.join(ctrlPath, "settings"));
+
+	// Layout
+	await fs.writeFile(
+		path.join(ctrlPath, "layout.tsx"),
+		`
+import React from "react";
+
+export default function CtrlLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <div style={{ display: "flex" }}>
+      <aside style={{ width: 250, padding: 20 }}>
+        <h2>Admin</h2>
+        <nav>
+          <a href="/ctrl">Dashboard</a><br />
+          <a href="/ctrl/pages">Pages</a><br />
+          <a href="/ctrl/users">Users</a><br />
+          <a href="/ctrl/settings">Settings</a>
+        </nav>
+      </aside>
+
+      <main style={{ flex: 1, padding: 20 }}>
+        {children}
+      </main>
+    </div>
+  );
+}
+`,
+	);
+
+	// Dashboard
+	await fs.writeFile(
+		path.join(ctrlPath, "page.tsx"),
+		`
+export default function Page() {
+  return <h1>Admin Dashboard</h1>;
+}
+`,
+	);
+
+	// Pages
+	await fs.writeFile(
+		path.join(ctrlPath, "pages/page.tsx"),
+		`
+export default function PagesPage() {
+  return <div>Pages Management</div>;
+}
+`,
+	);
+	// Users
+	await fs.writeFile(
+		path.join(ctrlPath, "users/page.tsx"),
+		`
+export default function UsersPage() {
+  return <div>Users Management</div>;
+}
+`,
+	);
+
+	// Settings
+	await fs.writeFile(
+		path.join(ctrlPath, "settings/page.tsx"),
+		`
+export default function SettingsPage() {
+  return <div>Settings</div>;
+}
+`,
+	);
+
+	// Middleware
+	await fs.writeFile(
+		path.join(target, "src/middleware.ts"),
+		`
+import { NextResponse } from "next/server";
+import type { NextRequest } from "next/server";
+
+export function middleware(req: NextRequest) {
+  if (req.nextUrl.pathname.startsWith("/ctrl")) {
+    const isAdmin = true;
+
+    if (!isAdmin) {
+      return NextResponse.redirect(new URL("/", req.url));
+    }
+  }
+}
+`,
+	);
+
+	console.log("✅ /ctrl injected (TypeScript)");
+}