create-theokit 0.1.0-alpha.0

package/dist/cli.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import { resolve as resolve2 } from "path";
+
+// src/index.ts
+import { existsSync, cpSync, readFileSync, writeFileSync, renameSync, unlinkSync, readdirSync } from "fs";
+import { resolve, join, dirname } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+function getTemplateDir(templateName = "default") {
+  return resolve(__dirname, "../templates", templateName);
+}
+function isValidProjectName(name) {
+  return /^[a-z0-9][a-z0-9._-]*$/.test(name);
+}
+function scaffold(targetDir, projectName, templateName = "default") {
+  const templateDir = getTemplateDir(templateName);
+  if (!existsSync(templateDir)) {
+    throw new Error(
+      `Template "${templateName}" not found. Available templates: default, dashboard, api-only, postgres`
+    );
+  }
+  if (!isValidProjectName(projectName)) {
+    throw new Error(
+      `Invalid project name "${projectName}". Use lowercase letters, numbers, hyphens, and dots. Must start with a letter or number.`
+    );
+  }
+  if (existsSync(targetDir)) {
+    const contents = readdirSync(targetDir);
+    if (contents.length > 0) {
+      throw new Error(
+        `Directory "${targetDir}" is not empty. Please use an empty directory.`
+      );
+    }
+  }
+  cpSync(templateDir, targetDir, { recursive: true });
+  const gitignoreSrc = join(targetDir, "_gitignore");
+  const gitignoreDest = join(targetDir, ".gitignore");
+  if (existsSync(gitignoreSrc)) {
+    renameSync(gitignoreSrc, gitignoreDest);
+  }
+  const tmplPath = join(targetDir, "package.json.tmpl");
+  if (existsSync(tmplPath)) {
+    const content = readFileSync(tmplPath, "utf-8");
+    const replaced = content.replace(/\{\{name\}\}/g, projectName);
+    writeFileSync(join(targetDir, "package.json"), replaced);
+    unlinkSync(tmplPath);
+  }
+}
+
+// src/pkg-manager.ts
+function detectPkgManager() {
+  const ua = process.env.npm_config_user_agent ?? "";
+  if (ua.startsWith("yarn")) return "yarn";
+  if (ua.startsWith("pnpm")) return "pnpm";
+  if (ua.startsWith("bun")) return "bun";
+  return "npm";
+}
+
+// src/install.ts
+import spawn from "cross-spawn";
+function runInstall(cwd, pkgManager) {
+  const result = spawn.sync(pkgManager, ["install"], {
+    cwd,
+    stdio: "inherit",
+    env: { ...process.env, NODE_ENV: "development" }
+  });
+  if (result.status !== 0) {
+    throw new Error(`Failed to install dependencies with ${pkgManager}`);
+  }
+}
+
+// src/cli.ts
+function main() {
+  const args = process.argv.slice(2);
+  const positionalArgs = args.filter((a) => !a.startsWith("--"));
+  const projectName = positionalArgs[0];
+  if (!projectName) {
+    console.error("Usage: create-theokit <project-name> [--template=name]");
+    console.error("");
+    console.error("Example:");
+    console.error("  npx create-theokit my-app");
+    console.error("  npx create-theokit my-app --template=dashboard");
+    process.exit(1);
+  }
+  const templateFlag = args.find((a) => a.startsWith("--template="));
+  const templateName = templateFlag ? templateFlag.split("=")[1] : "default";
+  const targetDir = resolve2(process.cwd(), projectName);
+  try {
+    console.log(`
+Creating TheoKit project "${projectName}" (template: ${templateName})...
+`);
+    scaffold(targetDir, projectName, templateName);
+    const pkgManager = detectPkgManager();
+    console.log(`Installing dependencies with ${pkgManager}...
+`);
+    runInstall(targetDir, pkgManager);
+    console.log(`
+  \u2713 Project created at ${targetDir}
+`);
+    console.log(`  Next steps:
+`);
+    console.log(`    cd ${projectName}`);
+    console.log(`    ${pkgManager === "npm" ? "npx" : pkgManager} theokit dev
+`);
+  } catch (err) {
+    console.error(`
+  \u2717 ${err.message}
+`);
+    process.exit(1);
+  }
+}
+main();
+export {
+  main
+};
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../src/index.ts","../src/pkg-manager.ts","../src/install.ts"],"sourcesContent":["import { resolve } from 'node:path'\nimport { scaffold } from './index.js'\nimport { detectPkgManager } from './pkg-manager.js'\nimport { runInstall } from './install.js'\n\nexport function main(): void {\n  const args = process.argv.slice(2)\n  const positionalArgs = args.filter((a) => !a.startsWith('--'))\n  const projectName = positionalArgs[0]\n\n  if (!projectName) {\n    console.error('Usage: create-theokit <project-name> [--template=name]')\n    console.error('')\n    console.error('Example:')\n    console.error('  npx create-theokit my-app')\n    console.error('  npx create-theokit my-app --template=dashboard')\n    process.exit(1)\n  }\n\n  // Parse --template flag\n  const templateFlag = args.find((a) => a.startsWith('--template='))\n  const templateName = templateFlag ? templateFlag.split('=')[1] : 'default'\n\n  const targetDir = resolve(process.cwd(), projectName)\n\n  try {\n    console.log(`\\nCreating TheoKit project \"${projectName}\" (template: ${templateName})...\\n`)\n\n    scaffold(targetDir, projectName, templateName)\n\n    const pkgManager = detectPkgManager()\n    console.log(`Installing dependencies with ${pkgManager}...\\n`)\n    runInstall(targetDir, pkgManager)\n\n    console.log(`\\n  ✓ Project created at ${targetDir}\\n`)\n    console.log(`  Next steps:\\n`)\n    console.log(`    cd ${projectName}`)\n    console.log(`    ${pkgManager === 'npm' ? 'npx' : pkgManager} theokit dev\\n`)\n  } catch (err) {\n    console.error(`\\n  ✗ ${(err as Error).message}\\n`)\n    process.exit(1)\n  }\n}\n\n// Auto-execute when run as script\nmain()\n","import { existsSync, cpSync, readFileSync, writeFileSync, renameSync, unlinkSync, readdirSync } from 'node:fs'\nimport { resolve, join, dirname } from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst __dirname = dirname(fileURLToPath(import.meta.url))\n\nfunction getTemplateDir(templateName = 'default'): string {\n  return resolve(__dirname, '../templates', templateName)\n}\n\nfunction isValidProjectName(name: string): boolean {\n  return /^[a-z0-9][a-z0-9._-]*$/.test(name)\n}\n\nexport function scaffold(targetDir: string, projectName: string, templateName = 'default'): void {\n  const templateDir = getTemplateDir(templateName)\n\n  if (!existsSync(templateDir)) {\n    throw new Error(\n      `Template \"${templateName}\" not found. Available templates: default, dashboard, api-only, postgres`,\n    )\n  }\n\n  if (!isValidProjectName(projectName)) {\n    throw new Error(\n      `Invalid project name \"${projectName}\". ` +\n        `Use lowercase letters, numbers, hyphens, and dots. Must start with a letter or number.`,\n    )\n  }\n\n  if (existsSync(targetDir)) {\n    const contents = readdirSync(targetDir)\n    if (contents.length > 0) {\n      throw new Error(\n        `Directory \"${targetDir}\" is not empty. Please use an empty directory.`,\n      )\n    }\n  }\n\n  // Copy template\n  cpSync(templateDir, targetDir, { recursive: true })\n\n  // Rename _gitignore → .gitignore\n  const gitignoreSrc = join(targetDir, '_gitignore')\n  const gitignoreDest = join(targetDir, '.gitignore')\n  if (existsSync(gitignoreSrc)) {\n    renameSync(gitignoreSrc, gitignoreDest)\n  }\n\n  // Process package.json.tmpl → package.json\n  const tmplPath = join(targetDir, 'package.json.tmpl')\n  if (existsSync(tmplPath)) {\n    const content = readFileSync(tmplPath, 'utf-8')\n    const replaced = content.replace(/\\{\\{name\\}\\}/g, projectName)\n    writeFileSync(join(targetDir, 'package.json'), replaced)\n    unlinkSync(tmplPath)\n  }\n}\n","export type PkgManager = 'npm' | 'pnpm' | 'yarn' | 'bun'\n\nexport function detectPkgManager(): PkgManager {\n  const ua = process.env.npm_config_user_agent ?? ''\n  if (ua.startsWith('yarn')) return 'yarn'\n  if (ua.startsWith('pnpm')) return 'pnpm'\n  if (ua.startsWith('bun')) return 'bun'\n  return 'npm'\n}\n","import spawn from 'cross-spawn'\nimport type { PkgManager } from './pkg-manager.js'\n\nexport function runInstall(cwd: string, pkgManager: PkgManager): void {\n  const result = spawn.sync(pkgManager, ['install'], {\n    cwd,\n    stdio: 'inherit',\n    env: { ...process.env, NODE_ENV: 'development' },\n  })\n\n  if (result.status !== 0) {\n    throw new Error(`Failed to install dependencies with ${pkgManager}`)\n  }\n}\n"],"mappings":"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","names":["resolve","resolve"]}

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "create-theokit",
+  "version": "0.1.0-alpha.0",
+  "type": "module",
+  "description": "Scaffold a new TheoKit project",
+  "scripts": {
+    "build": "tsup"
+  },
+  "bin": {
+    "create-theokit": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "dependencies": {
+    "cross-spawn": "^7.0.6"
+  }
+}

package/templates/api-only/_gitignore

@@ -0,0 +1,5 @@
+node_modules
+.theo
+dist
+.env
+.env.local

package/templates/api-only/app/page.tsx

@@ -0,0 +1,3 @@
+export default function Page() {
+  return <h1>Theo API Server</h1>
+}

package/templates/api-only/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>Theo App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/@theo/entry-client"></script>
+  </body>
+</html>

package/templates/api-only/package.json.tmpl

@@ -0,0 +1,19 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "theokit dev"
+  },
+  "dependencies": {
+    "theokit": "workspace:*",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0"
+  }
+}

package/templates/api-only/server/routes/health.ts

@@ -0,0 +1,5 @@
+import { defineRoute } from 'theokit/server'
+
+export const GET = defineRoute({
+  handler: () => ({ ok: true }),
+})

package/templates/api-only/server/routes/users.ts

@@ -0,0 +1,27 @@
+import { defineRoute } from 'theokit/server'
+import { z } from 'zod'
+
+const users = [
+  { id: '1', name: 'Alice', email: 'alice@example.com' },
+  { id: '2', name: 'Bob', email: 'bob@example.com' },
+]
+
+export const GET = defineRoute({
+  query: z.object({ search: z.string().optional() }),
+  handler: ({ query }) => {
+    if (query.search) {
+      return users.filter((u) => u.name.toLowerCase().includes(query.search!.toLowerCase()))
+    }
+    return users
+  },
+})
+
+export const POST = defineRoute({
+  body: z.object({ name: z.string().min(1), email: z.string().email() }),
+  status: 201,
+  handler: ({ body }) => ({
+    id: String(users.length + 1),
+    name: body.name,
+    email: body.email,
+  }),
+})

package/templates/api-only/theo.config.ts

@@ -0,0 +1,3 @@
+import { defineConfig } from 'theokit'
+
+export default defineConfig({})

package/templates/api-only/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "jsx": "react-jsx",
+    "isolatedModules": true,
+    "resolveJsonModule": true
+  },
+  "include": ["app/**/*.ts", "app/**/*.tsx", "server/**/*.ts"]
+}

package/templates/dashboard/_gitignore

@@ -0,0 +1,5 @@
+node_modules
+.theo
+dist
+.env
+.env.local

package/templates/dashboard/app/about/page.tsx

@@ -0,0 +1,3 @@
+export default function AboutPage() {
+  return <h1>About</h1>
+}

package/templates/dashboard/app/dashboard/layout.tsx

@@ -0,0 +1,10 @@
+import { Outlet } from 'react-router'
+
+export default function DashboardLayout() {
+  return (
+    <div>
+      <h2>Dashboard Area</h2>
+      <Outlet />
+    </div>
+  )
+}

package/templates/dashboard/app/dashboard/page.tsx

@@ -0,0 +1,3 @@
+export default function DashboardPage() {
+  return <h1>Dashboard</h1>
+}

package/templates/dashboard/app/layout.tsx

@@ -0,0 +1,14 @@
+import { Outlet } from 'react-router'
+
+export default function RootLayout() {
+  return (
+    <div>
+      <nav>
+        <a href="/">Home</a> | <a href="/about">About</a> | <a href="/dashboard">Dashboard</a>
+      </nav>
+      <main>
+        <Outlet />
+      </main>
+    </div>
+  )
+}

package/templates/dashboard/app/page.tsx

@@ -0,0 +1,8 @@
+export default function HomePage() {
+  return (
+    <div>
+      <h1>Welcome to Theo</h1>
+      <p>Your fullstack TypeScript framework.</p>
+    </div>
+  )
+}

package/templates/dashboard/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>Theo App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/@theo/entry-client"></script>
+  </body>
+</html>

package/templates/dashboard/package.json.tmpl

@@ -0,0 +1,19 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "theokit dev"
+  },
+  "dependencies": {
+    "theokit": "workspace:*",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0"
+  }
+}

package/templates/dashboard/server/routes/health.ts

@@ -0,0 +1,5 @@
+import { defineRoute } from 'theokit/server'
+
+export const GET = defineRoute({
+  handler: () => ({ ok: true }),
+})

package/templates/dashboard/theo.config.ts

@@ -0,0 +1,3 @@
+import { defineConfig } from 'theokit'
+
+export default defineConfig({})

package/templates/dashboard/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "jsx": "react-jsx",
+    "isolatedModules": true,
+    "resolveJsonModule": true
+  },
+  "include": ["app/**/*.ts", "app/**/*.tsx", "server/**/*.ts"]
+}

package/templates/default/_gitignore

@@ -0,0 +1,5 @@
+node_modules
+.theo
+dist
+.env
+.env.local

package/templates/default/app/layout.tsx

@@ -0,0 +1,3 @@
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return children
+}

package/templates/default/app/page.tsx

@@ -0,0 +1,3 @@
+export default function Page() {
+  return <h1>Hello Theo</h1>
+}

package/templates/default/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>Theo App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/@theo/entry-client"></script>
+  </body>
+</html>

package/templates/default/package.json.tmpl

@@ -0,0 +1,19 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "theokit dev"
+  },
+  "dependencies": {
+    "theokit": "workspace:*",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0"
+  }
+}

package/templates/default/server/routes/health.ts

@@ -0,0 +1,5 @@
+import { defineRoute } from 'theokit/server'
+
+export const GET = defineRoute({
+  handler: () => ({ ok: true }),
+})

package/templates/default/theo.config.ts

@@ -0,0 +1,3 @@
+import { defineConfig } from 'theokit'
+
+export default defineConfig({})

package/templates/default/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "jsx": "react-jsx",
+    "isolatedModules": true,
+    "resolveJsonModule": true
+  },
+  "include": ["app/**/*.ts", "app/**/*.tsx", "server/**/*.ts"]
+}

package/templates/postgres/.env.example

@@ -0,0 +1,5 @@
+# Database connection string
+DATABASE_URL=postgresql://user:password@localhost:5432/mydb
+
+# Session secret (min 32 characters)
+# SESSION_SECRET=change-me-to-a-random-string-at-least-32-chars

package/templates/postgres/_gitignore

@@ -0,0 +1,5 @@
+node_modules
+.theo
+dist
+.env
+.env.local

package/templates/postgres/app/layout.tsx

@@ -0,0 +1,14 @@
+import { Outlet } from 'react-router'
+
+export default function RootLayout() {
+  return (
+    <div>
+      <nav>
+        <a href="/">Home</a>
+      </nav>
+      <main>
+        <Outlet />
+      </main>
+    </div>
+  )
+}

package/templates/postgres/app/page.tsx

@@ -0,0 +1,8 @@
+export default function Page() {
+  return (
+    <div>
+      <h1>Theo + Postgres</h1>
+      <p>Full-stack TypeScript with Drizzle ORM</p>
+    </div>
+  )
+}

package/templates/postgres/db/index.ts

@@ -0,0 +1,7 @@
+import { drizzle } from 'drizzle-orm/postgres-js'
+import postgres from 'postgres'
+import * as schema from './schema.js'
+
+const client = postgres(process.env.DATABASE_URL!)
+
+export const db = drizzle(client, { schema })

package/templates/postgres/db/schema.ts

@@ -0,0 +1,8 @@
+import { pgTable, text, timestamp, uuid } from 'drizzle-orm/pg-core'
+
+export const users = pgTable('users', {
+  id: uuid('id').primaryKey().defaultRandom(),
+  name: text('name').notNull(),
+  email: text('email').notNull().unique(),
+  createdAt: timestamp('created_at').defaultNow().notNull(),
+})

package/templates/postgres/drizzle.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'drizzle-kit'
+
+export default defineConfig({
+  out: './drizzle',
+  dialect: 'postgresql',
+  schema: './db/schema.ts',
+  dbCredentials: {
+    url: process.env.DATABASE_URL!,
+  },
+})

package/templates/postgres/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>Theo App</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/@theo/entry-client"></script>
+  </body>
+</html>

package/templates/postgres/package.json.tmpl

@@ -0,0 +1,29 @@
+{
+  "name": "{{name}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "theokit dev",
+    "build": "theokit build",
+    "start": "theokit start",
+    "db:push": "drizzle-kit push",
+    "db:generate": "drizzle-kit generate",
+    "db:migrate": "drizzle-kit migrate",
+    "db:studio": "drizzle-kit studio"
+  },
+  "dependencies": {
+    "theokit": "workspace:*",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "drizzle-orm": "^0.45.0",
+    "postgres": "^3.4.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "drizzle-kit": "^0.31.0"
+  }
+}

package/templates/postgres/server/context.ts

@@ -0,0 +1,5 @@
+import { db } from '../db/index.js'
+
+export function createContext() {
+  return { db }
+}

package/templates/postgres/server/routes/health.ts

@@ -0,0 +1,5 @@
+import { defineRoute } from 'theokit/server'
+
+export const GET = defineRoute({
+  handler: () => ({ ok: true }),
+})

package/templates/postgres/server/routes/users.ts

@@ -0,0 +1,22 @@
+import { defineRoute } from 'theokit/server'
+import { z } from 'zod'
+import { users } from '../../db/schema.js'
+
+export const GET = defineRoute({
+  handler: async ({ ctx }) => {
+    const allUsers = await (ctx as any).db.select().from(users)
+    return { users: allUsers }
+  },
+})
+
+export const POST = defineRoute({
+  body: z.object({
+    name: z.string().min(1),
+    email: z.string().email(),
+  }),
+  status: 201,
+  handler: async ({ body, ctx }) => {
+    const [user] = await (ctx as any).db.insert(users).values(body).returning()
+    return user
+  },
+})

package/templates/postgres/theo.config.ts

@@ -0,0 +1,3 @@
+import { defineConfig } from 'theokit'
+
+export default defineConfig({})

package/templates/postgres/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "jsx": "react-jsx",
+    "isolatedModules": true,
+    "resolveJsonModule": true
+  },
+  "include": ["app/**/*.ts", "app/**/*.tsx", "server/**/*.ts"]
+}