create-kuckit-app 0.1.0

package/README.md

@@ -0,0 +1,70 @@
+# create-kuckit-app
+
+Create a new Kuckit application with a single command.
+
+## Quick Start
+
+```bash
+npx create-kuckit-app my-app
+cd my-app
+bun run dev
+```
+
+## Prerequisites
+
+- Node.js 18+
+- [Bun](https://bun.sh) package manager
+- A Kuckit account at [kuckit.dev](https://kuckit.dev)
+
+## Authentication
+
+You need to authenticate before creating a project:
+
+```bash
+npx @kuckit/cli auth login
+```
+
+## Usage
+
+```bash
+npx create-kuckit-app <project-name> [options]
+```
+
+### Options
+
+- `--skip-install` - Skip running package manager install
+- `--template <template>` - Template to use (default: `base`)
+
+## What's Included
+
+The generated project includes:
+
+- **Monorepo structure** with apps and packages
+- **Server** - Express + oRPC API with Better-Auth
+- **Web** - React + TanStack Router frontend
+- **Database** - Drizzle ORM with PostgreSQL
+- **Kuckit SDK** - Module system ready to go
+
+## Project Structure
+
+```
+my-app/
+├── apps/
+│   ├── server/     # Backend API
+│   └── web/        # Frontend app
+├── packages/       # Shared packages & modules
+└── kuckit.config.ts
+```
+
+## Next Steps
+
+After creating your app:
+
+1. Set up your database (see `packages/db/docker-compose.yml`)
+2. Run migrations: `bun run db:push`
+3. Start development: `bun run dev`
+4. Add modules: `npx @kuckit/cli add <module>`
+
+## License
+
+MIT

package/dist/bin.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/bin.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+import { t as createProject } from "./create-project-DTm05G7D.js";
+import { program } from "commander";
+import { join } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+
+//#region src/lib/require-auth.ts
+const CONFIG_PATH = join(homedir(), ".kuckit", "config.json");
+function loadConfig() {
+	try {
+		if (!existsSync(CONFIG_PATH)) return null;
+		const content = readFileSync(CONFIG_PATH, "utf-8");
+		return JSON.parse(content);
+	} catch {
+		return null;
+	}
+}
+function isTokenExpired(config) {
+	if (!config.tokenExpiresAt) return false;
+	return new Date(config.tokenExpiresAt) < /* @__PURE__ */ new Date();
+}
+/**
+* Checks if the user is authenticated with a valid token.
+* Exits the process with an error message if not authenticated.
+*/
+function requireAuth() {
+	const config = loadConfig();
+	if (!config?.cliToken) {
+		console.error("\nError: Not logged in. Run 'kuckit auth login' first.\n");
+		process.exit(1);
+	}
+	if (isTokenExpired(config)) {
+		console.error("\nError: Session expired. Run 'kuckit auth login' to refresh.\n");
+		process.exit(1);
+	}
+}
+
+//#endregion
+//#region src/bin.ts
+program.name("create-kuckit-app").description("Create a new Kuckit application").version("0.1.0").argument("<project-name>", "Name of the project to create").option("--skip-install", "Skip running package manager install", false).option("--template <template>", "Template to use", "base").action(async (projectName, options) => {
+	requireAuth();
+	await createProject(projectName, options);
+});
+program.parse();
+
+//#endregion
+export {  };

package/dist/create-project-DTm05G7D.js

@@ -0,0 +1,85 @@
+import { mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+
+//#region src/create-project.ts
+const __dirname = dirname(fileURLToPath(import.meta.url));
+async function copyDir(src, dest, replacements) {
+	await mkdir(dest, { recursive: true });
+	const entries = await readdir(src, { withFileTypes: true });
+	for (const entry of entries) {
+		const srcPath = join(src, entry.name);
+		const destPath = join(dest, entry.name.replace(/__APP_NAME__/g, replacements["__APP_NAME__"]));
+		if (entry.isDirectory()) await copyDir(srcPath, destPath, replacements);
+		else {
+			let processed = await readFile(srcPath, "utf-8");
+			for (const [placeholder, value] of Object.entries(replacements)) processed = processed.replace(new RegExp(placeholder, "g"), value);
+			await writeFile(destPath, processed);
+		}
+	}
+}
+async function createProject(name, options) {
+	const targetDir = join(process.cwd(), name);
+	console.log(`\nCreating Kuckit app: ${name}`);
+	console.log(`  Directory: ${targetDir}\n`);
+	let templateDir = join(__dirname, "..", "templates", options.template);
+	try {
+		await stat(templateDir);
+	} catch {
+		templateDir = join(__dirname, "templates", options.template);
+	}
+	try {
+		await stat(templateDir);
+	} catch {
+		console.error(`Error: Template "${options.template}" not found.`);
+		console.error(`Looked in: ${templateDir}`);
+		process.exit(1);
+	}
+	const replacements = {
+		__APP_NAME__: name,
+		__APP_NAME_LOWER__: name.toLowerCase(),
+		__APP_NAME_KEBAB__: name.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase()
+	};
+	console.log("  Copying template files...");
+	await copyDir(templateDir, targetDir, replacements);
+	console.log("  Initializing git repository...");
+	try {
+		execSync("git init", {
+			cwd: targetDir,
+			stdio: "ignore"
+		});
+	} catch {
+		console.warn("  Warning: Could not initialize git repository");
+	}
+	if (!options.skipInstall) {
+		console.log("  Installing dependencies...");
+		try {
+			execSync("bun install", {
+				cwd: targetDir,
+				stdio: "inherit"
+			});
+		} catch {
+			console.warn("  Warning: Could not install dependencies. Run \"bun install\" manually.");
+		}
+	}
+	console.log(`
+Success! Created ${name} at ${targetDir}
+
+Inside that directory, you can run:
+
+  bun run dev        Start the development server
+  bun run build      Build for production
+  bun run check-types   Run type checking
+
+We suggest that you begin by typing:
+
+  cd ${name}
+  bun run dev
+
+Happy hacking!
+`);
+}
+
+//#endregion
+export { createProject as t };

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+//#region src/create-project.d.ts
+interface CreateProjectOptions {
+  skipInstall: boolean;
+  template: string;
+}
+declare function createProject(name: string, options: CreateProjectOptions): Promise<void>;
+//#endregion
+export { createProject };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { t as createProject } from "./create-project-DTm05G7D.js";
+
+export { createProject };

package/package.json

@@ -0,0 +1,51 @@
+{
+	"name": "create-kuckit-app",
+	"version": "0.1.0",
+	"description": "Create a new Kuckit application",
+	"type": "module",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/draphonix/kuckit.git",
+		"directory": "packages/create-kuckit-app"
+	},
+	"homepage": "https://kuckit.dev",
+	"bugs": "https://github.com/draphonix/kuckit/issues",
+	"keywords": [
+		"kuckit",
+		"create",
+		"app",
+		"scaffolding",
+		"fullstack",
+		"starter"
+	],
+	"engines": {
+		"node": ">=18"
+	},
+	"publishConfig": {
+		"access": "public"
+	},
+	"bin": {
+		"create-kuckit-app": "dist/bin.js"
+	},
+	"files": [
+		"dist",
+		"templates"
+	],
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		}
+	},
+	"scripts": {
+		"build": "tsdown"
+	},
+	"dependencies": {
+		"commander": "^13.1.0"
+	},
+	"devDependencies": {
+		"@types/node": "^22.13.13",
+		"tsdown": "catalog:"
+	}
+}

package/templates/base/apps/server/package.json

@@ -0,0 +1,23 @@
+{
+	"name": "__APP_NAME_KEBAB__-server",
+	"type": "module",
+	"scripts": {
+		"build": "tsdown",
+		"check-types": "tsc -b",
+		"dev": "bun run --hot src/server.ts"
+	},
+	"dependencies": {
+		"@kuckit/sdk": "^0.1.0",
+		"@kuckit/users-module": "^0.1.0",
+		"express": "^5.1.0",
+		"cors": "^2.8.5",
+		"dotenv": "^17.2.2",
+		"awilix": "^12.0.5"
+	},
+	"devDependencies": {
+		"@types/express": "^5.0.1",
+		"@types/cors": "^2.8.17",
+		"typescript": "^5.8.2",
+		"tsdown": "^0.15.5"
+	}
+}

package/templates/base/apps/server/src/config/modules.ts

@@ -0,0 +1,14 @@
+import type { ModuleSpec } from '@kuckit/sdk'
+import { kuckitModule as usersModule } from '@kuckit/users-module'
+
+export const getModuleSpecs = (): ModuleSpec[] => {
+	const modules: ModuleSpec[] = [
+		{ module: usersModule },
+
+		// KUCKIT_MODULES_START
+		// Modules installed via 'kuckit add' will be added here
+		// KUCKIT_MODULES_END
+	]
+
+	return modules
+}

package/templates/base/apps/server/src/server.ts

@@ -0,0 +1,39 @@
+import 'dotenv/config'
+import express from 'express'
+import cors from 'cors'
+import { createKuckitContainer, loadKuckitModules } from '@kuckit/sdk'
+import { getModuleSpecs } from './config/modules.js'
+
+const app = express()
+const port = process.env.PORT ?? 3000
+
+app.use(cors())
+app.use(express.json())
+
+async function bootstrap() {
+	// Create DI container
+	const container = createKuckitContainer({
+		env: process.env.NODE_ENV ?? 'development',
+	})
+
+	// Load modules
+	await loadKuckitModules({
+		container,
+		env: process.env.NODE_ENV ?? 'development',
+		modules: getModuleSpecs(),
+		onComplete: () => {
+			console.log('All modules loaded')
+		},
+	})
+
+	// Health check
+	app.get('/health', (_req, res) => {
+		res.json({ status: 'ok' })
+	})
+
+	app.listen(port, () => {
+		console.log(`Server running at http://localhost:${port}`)
+	})
+}
+
+bootstrap().catch(console.error)

package/templates/base/apps/server/tsconfig.json

@@ -0,0 +1,8 @@
+{
+	"extends": "../../tsconfig.base.json",
+	"compilerOptions": {
+		"outDir": "dist",
+		"rootDir": "src"
+	},
+	"include": ["src"]
+}

package/templates/base/apps/web/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>__APP_NAME__</title>
+	</head>
+	<body>
+		<div id="root"></div>
+		<script type="module" src="/src/main.tsx"></script>
+	</body>
+</html>

package/templates/base/apps/web/package.json

@@ -0,0 +1,22 @@
+{
+	"name": "__APP_NAME_KEBAB__-web",
+	"type": "module",
+	"scripts": {
+		"dev": "vite --port=3001",
+		"build": "vite build",
+		"check-types": "tsc --noEmit"
+	},
+	"dependencies": {
+		"@kuckit/sdk-react": "^0.1.0",
+		"@tanstack/react-query": "^5.85.5",
+		"react": "^19.1.0",
+		"react-dom": "^19.1.0"
+	},
+	"devDependencies": {
+		"@types/react": "~19.1.10",
+		"@types/react-dom": "^19.0.4",
+		"@vitejs/plugin-react": "^4.3.4",
+		"typescript": "^5.8.2",
+		"vite": "^6.2.2"
+	}
+}

package/templates/base/apps/web/src/App.tsx

@@ -0,0 +1,16 @@
+export function App() {
+	return (
+		<div style={{ fontFamily: 'system-ui', padding: '2rem' }}>
+			<h1>Welcome to __APP_NAME__</h1>
+			<p>Your Kuckit application is ready!</p>
+			<ul>
+				<li>
+					Server: <a href="http://localhost:3000/health">http://localhost:3000/health</a>
+				</li>
+				<li>
+					Web: <a href="http://localhost:3001">http://localhost:3001</a>
+				</li>
+			</ul>
+		</div>
+	)
+}

package/templates/base/apps/web/src/main.tsx

@@ -0,0 +1,14 @@
+import { StrictMode } from 'react'
+import { createRoot } from 'react-dom/client'
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
+import { App } from './App.js'
+
+const queryClient = new QueryClient()
+
+createRoot(document.getElementById('root')!).render(
+	<StrictMode>
+		<QueryClientProvider client={queryClient}>
+			<App />
+		</QueryClientProvider>
+	</StrictMode>
+)

package/templates/base/apps/web/src/modules.client.ts

@@ -0,0 +1,16 @@
+import type { ClientModuleSpec } from '@kuckit/sdk-react'
+
+/**
+ * Client modules configuration
+ *
+ * Modules installed via 'kuckit add' will be added here automatically.
+ */
+export const getClientModuleSpecs = (): ClientModuleSpec[] => {
+	const modules: ClientModuleSpec[] = [
+		// KUCKIT_MODULES_START
+		// Client modules will be added here
+		// KUCKIT_MODULES_END
+	]
+
+	return modules
+}

package/templates/base/apps/web/tsconfig.json

@@ -0,0 +1,9 @@
+{
+	"extends": "../../tsconfig.base.json",
+	"compilerOptions": {
+		"lib": ["DOM", "DOM.Iterable", "ESNext"],
+		"jsx": "react-jsx",
+		"noEmit": true
+	},
+	"include": ["src"]
+}

package/templates/base/apps/web/vite.config.ts

@@ -0,0 +1,6 @@
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+
+export default defineConfig({
+	plugins: [react()],
+})

package/templates/base/package.json

@@ -0,0 +1,19 @@
+{
+	"name": "__APP_NAME_KEBAB__",
+	"private": true,
+	"type": "module",
+	"workspaces": [
+		"apps/*",
+		"packages/*"
+	],
+	"scripts": {
+		"dev": "turbo dev",
+		"build": "turbo build",
+		"check-types": "turbo check-types"
+	},
+	"devDependencies": {
+		"turbo": "^2.5.4",
+		"typescript": "^5.8.2"
+	},
+	"packageManager": "bun@1.2.21"
+}

package/templates/base/tsconfig.base.json

@@ -0,0 +1,19 @@
+{
+	"compilerOptions": {
+		"target": "ESNext",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"esModuleInterop": true,
+		"skipLibCheck": true,
+		"strict": true,
+		"declaration": true,
+		"declarationMap": true,
+		"sourceMap": true,
+		"resolveJsonModule": true,
+		"isolatedModules": true,
+		"noUnusedLocals": true,
+		"noUnusedParameters": true,
+		"noFallthroughCasesInSwitch": true,
+		"verbatimModuleSyntax": true
+	}
+}

package/templates/base/turbo.json

@@ -0,0 +1,16 @@
+{
+	"$schema": "https://turbo.build/schema.json",
+	"tasks": {
+		"build": {
+			"dependsOn": ["^build"],
+			"outputs": ["dist/**"]
+		},
+		"dev": {
+			"cache": false,
+			"persistent": true
+		},
+		"check-types": {
+			"dependsOn": ["^build"]
+		}
+	}
+}