create-rotor 0.2.0 → 0.2.2

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

@@ -1285,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))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-rotor",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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/.mcp.json

@@ -0,0 +1,8 @@
+{
+  "mcpServers": {
+    "next-devtools": {
+      "command": "npx",
+      "args": ["-y", "next-devtools-mcp@latest"]
+    }
+  }
+}

package/template/README.md

@@ -10,3 +10,12 @@ bun dev
 ```
 
 Open [http://localhost:3000](http://localhost:3000).
+
+## MCP Support
+
+This project includes [next-devtools-mcp](https://github.com/vercel/next-devtools-mcp) for AI coding agents (see `.mcp.json`). Start `bun dev` and your agent can access errors, routes, and app state automatically.
+
+Other recommended MCP tools:
+
+- [Context7](https://github.com/upstash/context7) — Up-to-date library docs: `npx ctx7 setup`
+- [Playwright MCP](https://github.com/microsoft/playwright-mcp) — Browser testing and verification

package/template/app/globals.css

@@ -1,4 +1,4 @@
-@import 'tailwindcss';
+@import "tailwindcss";
 
 @theme inline {
   --font-sans: var(--font-geist-sans);

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[]) {