create-rotor 0.1.3 → 0.2.1

package/README.md

@@ -0,0 +1,60 @@
+# create-rotor
+
+Scaffold Next.js projects with Bun, Tailwind CSS, Biome, and more.
+
+## Quick Start
+
+```bash
+bunx create-rotor my-app
+```
+
+Or with npx:
+
+```bash
+npx create-rotor my-app
+```
+
+The CLI will guide you through selecting optional features, installing dependencies, and initializing a git repository.
+
+## What's Included
+
+Every generated project comes with:
+
+- [Next.js](https://nextjs.org) with Turbopack
+- [Tailwind CSS](https://tailwindcss.com) v4
+- [Biome](https://biomejs.dev) for linting, formatting, and import sorting
+- [Geist](https://vercel.com/font) font family
+- [Husky](https://typicode.github.io/husky) + [lint-staged](https://github.com/lint-staged/lint-staged) for pre-commit checks
+- TypeScript
+
+## Optional Features
+
+| Feature | Description |
+|---|---|
+| **shadcn/ui** | UI component library built on Base UI |
+| **SWR** | Data fetching and caching |
+| **Drizzle + Supabase** | Database ORM with PostgreSQL |
+| **Vercel AI SDK** | AI integration with OpenAI |
+
+## Biome Configuration
+
+Generated projects include a strict Biome setup beyond the recommended defaults:
+
+- **Code quality** — `noUnusedImports`, `noExplicitAny`, `noNonNullAssertion`, `noBarrelFile`
+- **Style** — `useImportType`, `useConsistentArrayType`, `useForOf`, `useFilenamingConvention` (kebab-case)
+- **Tailwind** — `useSortedClasses` with `cn`/`clsx`/`cva` support
+- **Assist** — Auto import sorting via `organizeImports`
+
+## Options
+
+```
+Usage: create-rotor [project-name]
+
+Options:
+  -v, --version  Show version
+  -h, --help     Show help
+```
+
+## License
+
+MIT

package/dist/index.js

@@ -91,7 +91,7 @@ var require_src = __commonJS((exports, module) => {
 
 // src/index.ts
 import { execSync } from "node:child_process";
-import { cpSync, existsSync as existsSync2, renameSync, rmSync as rmSync2 } from "node:fs";
+import { cpSync, existsSync as existsSync2, readFileSync as readFileSync2, renameSync, rmSync as rmSync2 } from "node:fs";
 import { join as join2, resolve } from "node:path";
 
 // node_modules/@clack/core/dist/index.mjs
@@ -1206,7 +1206,6 @@ var MODULES = {
     envMarker: "ai"
   }
 };
-var VERSION = "0.1.3";
 
 // src/helpers.ts
 import { existsSync, readFileSync, rmSync, writeFileSync } from "node:fs";
@@ -1286,12 +1285,7 @@ function removeModuleFiles(projectDir, selectedModules) {
   }
 }
 function replaceProjectName(projectDir, projectName) {
-  const filesToReplace = [
-    "package.json",
-    "app/layout.tsx",
-    "app/page.tsx",
-    "README.md"
-  ];
+  const filesToReplace = ["package.json", "app/layout.tsx", "README.md"];
   for (const file of filesToReplace) {
     const filePath = join(projectDir, file);
     if (!existsSync(filePath))
@@ -1333,6 +1327,10 @@ function trimCssShadcn(cssPath) {
 function getTemplatePath() {
   return resolve(import.meta.dirname, "..", "template");
 }
+function getVersion() {
+  const pkgPath = resolve(import.meta.dirname, "..", "package.json");
+  return JSON.parse(readFileSync2(pkgPath, "utf-8")).version;
+}
 function validateProjectName(name) {
   if (!name)
     return "Project name is required";
@@ -1344,12 +1342,12 @@ function validateProjectName(name) {
 async function main() {
   const args = process.argv.slice(2);
   if (args.includes("--version") || args.includes("-v")) {
-    console.log(VERSION);
+    console.log(getVersion());
     process.exit(0);
   }
   if (args.includes("--help") || args.includes("-h")) {
     console.log(`
-  create-rotor v${VERSION}
+  create-rotor v${getVersion()}
 
   Usage: create-rotor [project-name]
 
@@ -1409,6 +1407,14 @@ async function main() {
     Nt("Cancelled.");
     process.exit(0);
   }
+  const installDeps = await Rt({
+    message: "Install dependencies?",
+    initialValue: true
+  });
+  if (Ct(installDeps)) {
+    Nt("Cancelled.");
+    process.exit(0);
+  }
   const s = be();
   s.start("Creating project...");
   const templatePath = getTemplatePath();
@@ -1422,16 +1428,34 @@ async function main() {
   if (!selectedModules.includes("shadcn")) {
     trimCssShadcn(join2(targetDir, "app", "globals.css"));
   }
+  s.stop("Project created!");
+  if (installDeps) {
+    const installSpinner = be();
+    installSpinner.start("Installing dependencies...");
+    try {
+      execSync("bun install", { cwd: targetDir, stdio: "ignore" });
+      installSpinner.stop("Dependencies installed!");
+    } catch {
+      installSpinner.stop('Failed to install dependencies. Run "bun install" manually.');
+    }
+  }
   if (initGit) {
     execSync("git init", { cwd: targetDir, stdio: "ignore" });
     execSync("git add -A", { cwd: targetDir, stdio: "ignore" });
     execSync('git commit -m "init"', { cwd: targetDir, stdio: "ignore" });
   }
-  s.stop("Project created!");
+  const steps = [`cd ${projectName}`];
+  if (!installDeps) {
+    steps.push("bun install");
+  }
+  const envPath = join2(targetDir, ".env.example");
+  if (readFileSync2(envPath, "utf-8").trim().length > 0) {
+    steps.push("cp .env.example .env  # configure environment variables");
+  }
+  steps.push("bun dev");
   Gt(`Done! Next steps:
 
-  cd ${projectName}
-  bun install
-  bun dev`);
+  ${steps.join(`
+  `)}`);
 }
 main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-rotor",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "description": "Scaffold Next.js projects with Bun, Tailwind, Biome, and more",
   "type": "module",
   "bin": "dist/index.js",
@@ -18,6 +18,10 @@
     "@types/node": "25.5.0",
     "typescript": "5.9.3"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yikZero/rotor"
+  },
   "keywords": ["create", "nextjs", "bun", "tailwind", "scaffold", "template"],
   "license": "MIT"
 }

package/template/app/globals.css

@@ -1,4 +1,9 @@
-@import 'tailwindcss';
+@import "tailwindcss";
+
+@theme inline {
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+}
 
 /* [shadcn] */
 @theme inline {

package/template/app/layout.tsx

@@ -1,6 +1,17 @@
 import type { Metadata } from 'next';
+import { Geist, Geist_Mono } from 'next/font/google';
 import './globals.css';
 
+const geistSans = Geist({
+  variable: '--font-geist-sans',
+  subsets: ['latin'],
+});
+
+const geistMono = Geist_Mono({
+  variable: '--font-geist-mono',
+  subsets: ['latin'],
+});
+
 export const metadata: Metadata = {
   title: '{{PROJECT_NAME}}',
   description: '',
@@ -13,7 +24,11 @@ export default function RootLayout({
 }>) {
   return (
     <html lang="en">
-      <body>{children}</body>
+      <body
+        className={`${geistSans.variable} ${geistMono.variable} antialiased`}
+      >
+        {children}
+      </body>
     </html>
   );
 }

package/template/app/page.tsx

@@ -1,7 +1,7 @@
 export default function Home() {
   return (
     <main className="flex min-h-screen flex-col items-center justify-center p-24">
-      <h1 className="text-4xl font-bold">{{PROJECT_NAME}}</h1>
+      <h1 className="font-bold text-4xl">Hello World</h1>
     </main>
   );
 }

package/template/biome.json

@@ -4,6 +4,12 @@
     "indentStyle": "space",
     "indentWidth": 2
   },
+  "css": {
+    "parser": {
+      "cssModules": true,
+      "tailwindDirectives": true
+    }
+  },
   "javascript": {
     "formatter": {
       "quoteStyle": "single",
@@ -12,7 +18,47 @@
   },
   "linter": {
     "rules": {
-      "recommended": true
+      "recommended": true,
+      "correctness": {
+        "noUnusedImports": "error",
+        "noUnusedFunctionParameters": "error"
+      },
+      "style": {
+        "useImportType": "error",
+        "useExportType": "error",
+        "useConsistentArrayType": "error",
+        "useForOf": "error",
+        "useNodejsImportProtocol": "error",
+        "noNonNullAssertion": "error",
+        "useFilenamingConvention": {
+          "level": "error",
+          "options": {
+            "filenameCases": ["kebab-case"]
+          }
+        }
+      },
+      "performance": {
+        "noBarrelFile": "error"
+      },
+      "suspicious": {
+        "noConsole": "warn",
+        "noExplicitAny": "error"
+      },
+      "nursery": {
+        "useSortedClasses": {
+          "level": "error",
+          "options": {
+            "functions": ["cn", "clsx", "cva"]
+          }
+        }
+      }
+    }
+  },
+  "assist": {
+    "actions": {
+      "source": {
+        "organizeImports": "on"
+      }
     }
   },
   "files": {

package/template/drizzle.config.ts

@@ -5,6 +5,6 @@ export default defineConfig({
   schema: './lib/schema.ts',
   dialect: 'postgresql',
   dbCredentials: {
-    url: process.env.DATABASE_URL!,
+    url: process.env.DATABASE_URL ?? '',
   },
 });

package/template/lib/db.ts

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

package/template/lib/utils.ts

@@ -1,4 +1,4 @@
-import { clsx, type ClassValue } from 'clsx';
+import { type ClassValue, clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 
 export function cn(...inputs: ClassValue[]) {