feat: separate linter category and add ESLint support

.claude/CLAUDE.md

@@ -76,7 +76,7 @@ apps/cli/src/
 Single source of truth for all stacks, libraries, and project addons:
 - `META.stacks`: App and server stacks (Next.js, Expo, Hono, TanStack Start) with `type: 'app' | 'server'` field
 - `META.libraries`: Per-app addons (shadcn, better-auth, etc.) with category/support/require/mono/packageJson/envs
-- `META.project`: Project-level categories (database, orm, tooling) with prompt config and options
+- `META.project`: Project-level categories (database, orm, linter, tooling) with prompt config and options
 - `META.repo`: Repository types (single, turborepo)
 - Addons declare `packageJson` for dependencies and `envs` for environment variables
 - Category-level `require` (e.g., orm requires database)
@@ -93,7 +93,7 @@ Single source of truth for all stacks, libraries, and project addons:
 
 ### types/ctx.ts
 - `AppContext`: `{ appName, stackName, libraries }`
-- `ProjectContext`: `{ database?, orm?, tooling[] }`
+- `ProjectContext`: `{ database?, orm?, linter?, tooling[] }`
 - `TemplateContext`: Full context with projectName, repo, apps[], project, git, pm
 - `PackageManager`: `'bun' | 'npm' | 'pnpm' | undefined`
 
@@ -149,7 +149,7 @@ Custom helpers:
 - Logical: `eq`, `ne`, `and`, `or`
 - Repo: `isMono()` - Check if turborepo
 - Libraries: `hasLibrary(name)` - Check if current app has library
-- Project: `has(category, value)` - Check database/orm/tooling/stack
+- Project: `has(category, value)` - Check database/orm/linter/tooling/stack
 - Context: `hasContext(key)` - Check if key exists in context
 - Utils: `appPort(name)` - Get port for app (3000 + index)
 
@@ -181,7 +181,8 @@ Libraries are grouped by category in the interactive prompt (UI, Content, Auth,
 - **ORM**: Prisma, Drizzle (both with Better Auth integration)
 
 ### Dev Tools
-- **Extras**: Biome (linter/formatter), Git, Husky (requires git)
+- **Linter**: Biome, ESLint (single selection)
+- **Extras**: Husky (requires git)
 - **Repo**: Single or Turborepo (auto-determined by app count)
 
 ## Current Status
@@ -230,7 +231,8 @@ templates/
 ├── stack/{framework}/       # Next.js, Expo, Hono, TanStack Start
 ├── libraries/{library}/     # Per-app library templates
 ├── project/orm/{provider}/  # Prisma, Drizzle
-├── project/tooling/{tool}/  # Biome, Husky
+├── project/linter/{linter}/ # Biome, ESLint
+├── project/tooling/{tool}/  # Husky
 └── repo/{type}/             # Single, Turborepo configs
 ```
 
@@ -342,9 +344,10 @@ bunx create-faster myapp \
   --app myapp:nextjs:shadcn,mdx \
   --database postgres \
   --orm drizzle \
+  --linter biome \
+  --tooling husky \
   --git \
-  --pm bun \
-  --extras biome,husky
+  --pm bun
 ```
 
 **Multi-app (Turborepo):**
@@ -355,17 +358,18 @@ bunx create-faster mysaas \
   --app api:hono \
   --database postgres \
   --orm drizzle \
+  --linter eslint \
+  --tooling husky \
   --git \
-  --pm bun \
-  --extras biome,husky
+  --pm bun
 ```
 
 **Mixed mode (partial flags):**
 ```bash
 bunx create-faster myapp \
   --app myapp:nextjs:shadcn \
   --database postgres
-# Will prompt for missing options (ORM, git, pm, extras)
+# Will prompt for missing options (ORM, linter, git, pm, tooling)
 ```
 
 ### Available Flags
@@ -381,14 +385,17 @@ bunx create-faster myapp \
 - `--orm <name>`: ORM provider (requires database)
   - Options: `prisma`, `drizzle`
 
+- `--linter <name>`: Linter
+  - Options: `biome`, `eslint`
+
+- `--tooling <name>`: Add tooling (repeatable)
+  - Options: `husky` (requires git)
+
 - `--git`: Initialize git repository
 
 - `--pm <manager>`: Package manager
   - Options: `bun`, `npm`, `pnpm`
 
-- `--extras <items>`: Comma-separated extras
-  - Options: `biome`, `husky` (husky requires git)
-
 ### Auto-Generated Command
 
 After project creation, a copy-paste ready command is displayed:
@@ -401,9 +408,10 @@ After project creation, a copy-paste ready command is displayed:
 │    --app mobile:expo:nativewind \
 │    --database postgres \
 │    --orm drizzle \
+│    --linter biome \
+│    --tooling husky \
 │    --git \
-│    --pm bun \
-│    --extras biome,husky
+│    --pm bun
 │
 └
 ```

apps/cli/src/__meta__.ts

@@ -382,9 +382,9 @@ export const META: Meta = {
         },
       },
     },
-    tooling: {
-      prompt: 'Add any extras?',
-      selection: 'multi',
+    linter: {
+      prompt: 'Choose a linter?',
+      selection: 'single',
       options: {
         biome: {
           label: 'Biome',
@@ -397,9 +397,44 @@ export const META: Meta = {
             scripts: {
               format: 'biome format --write .',
               lint: 'biome lint',
+              check: 'biome check --fix .',
+            },
+          },
+        },
+        eslint: {
+          label: 'ESLint',
+          hint: 'Most popular JavaScript linter',
+          mono: { scope: 'pkg', name: 'eslint-config' },
+          packageJson: {
+            devDependencies: {
+              eslint: '^9',
+              '@eslint/js': '^9',
+              'typescript-eslint': '^8',
+              globals: '^16',
+              'eslint-plugin-react': '^7',
+              'eslint-plugin-react-hooks': '^5',
+              '@next/eslint-plugin-next': '^15',
+            },
+            exports: {
+              './base': './base.js',
+              './next': './next.js',
+              './react': './react.js',
+              './react-native': './react-native.js',
+              './server': './server.js',
+            },
+          },
+          appPackageJson: {
+            scripts: {
+              lint: 'eslint .',
             },
           },
         },
+      },
+    },
+    tooling: {
+      prompt: 'Add any extras?',
+      selection: 'multi',
+      options: {
         husky: {
           label: 'Husky',
           hint: 'Git hooks',

apps/cli/src/cli.ts

@@ -77,6 +77,7 @@ ${S_GRAY_BAR}  ${color.italic(color.gray('Multiple apps = Turborepo monorepo'))}
     const parts: string[] = [];
     if (ctx.project.database) parts.push(`database: ${ctx.project.database}`);
     if (ctx.project.orm) parts.push(`orm: ${ctx.project.orm}`);
+    if (ctx.project.linter) parts.push(`linter: ${ctx.project.linter}`);
     if (ctx.project.tooling.length > 0) parts.push(`tooling: ${ctx.project.tooling.join(', ')}`);
     if (parts.length > 0) {
       log.info(`${color.green('✓')} Using project config: ${parts.join(', ')}`);
@@ -97,6 +98,9 @@ ${S_GRAY_BAR}  ${color.italic(color.gray('Multiple apps = Turborepo monorepo'))}
         case 'orm':
           ctx.project.orm = result as string | undefined;
           break;
+        case 'linter':
+          ctx.project.linter = result as string | undefined;
+          break;
         case 'tooling':
           ctx.project.tooling = (result as string[]) ?? [];
           break;

apps/cli/src/flags.ts

@@ -13,6 +13,7 @@ interface ParsedFlags {
   app?: string[];
   database?: string;
   orm?: string;
+  linter?: string;
   tooling?: string[];
   git?: boolean;
   pm?: string;
@@ -24,6 +25,7 @@ export function parseFlags(): Partial<TemplateContext> {
 
   const ormNames = Object.keys(META.project.orm.options).join(', ');
   const dbNames = Object.keys(META.project.database.options).join(', ');
+  const linterNames = Object.keys(META.project.linter.options).join(', ');
   const toolingNames = Object.keys(META.project.tooling.options).join(', ');
   const libraryNames = Object.keys(META.libraries).join(', ');
 
@@ -38,6 +40,7 @@ export function parseFlags(): Partial<TemplateContext> {
     .option('--app <name:stack:libraries>', 'Add app (repeatable)', collect, [])
     .option('--database <name>', `Database provider (${dbNames})`)
     .option('--orm <name>', `ORM provider (${ormNames})`)
+    .option('--linter <name>', `Linter (${linterNames})`)
     .option('--tooling <name>', 'Add tooling (repeatable)', collect, [])
     .option('--git', 'Initialize git repository')
     .option('--no-git', 'Skip git initialization')
@@ -59,6 +62,7 @@ ${color.bold('Examples:')}
   ${color.gray('Available libraries:')} ${libraryNames}
   ${color.gray('Available ORMs:')} ${ormNames}
   ${color.gray('Available databases:')} ${dbNames}
+  ${color.gray('Available linters:')} ${linterNames}
   ${color.gray('Available tooling:')} ${toolingNames}
 `,
     )
@@ -84,7 +88,7 @@ ${color.bold('Examples:')}
     partial.apps = flags.app.map((appFlag) => parseAppFlag(appFlag));
   }
 
-  const hasProjectFlags = flags.database || flags.orm || (flags.tooling && flags.tooling.length > 0);
+  const hasProjectFlags = flags.database || flags.orm || flags.linter || (flags.tooling && flags.tooling.length > 0);
   if (hasProjectFlags) {
     partial.project = { tooling: [] };
   }
@@ -108,6 +112,17 @@ ${color.bold('Examples:')}
     partial.project!.orm = flags.orm;
   }
 
+  if (flags.linter) {
+    if (!META.project.linter.options[flags.linter]) {
+      printError(
+        `Invalid linter '${flags.linter}'`,
+        `Available linters: ${Object.keys(META.project.linter.options).join(', ')}`,
+      );
+      process.exit(1);
+    }
+    partial.project!.linter = flags.linter;
+  }
+
   if (flags.tooling && flags.tooling.length > 0) {
     for (const toolingName of flags.tooling) {
       if (!META.project.tooling.options[toolingName]) {

apps/cli/src/lib/handlebars.ts

@@ -24,6 +24,8 @@ export function registerHandlebarsHelpers(): void {
         return this.project?.database === value;
       case 'orm':
         return this.project?.orm === value;
+      case 'linter':
+        return this.project?.linter === value;
       case 'tooling':
         return Array.isArray(this.project?.tooling) && this.project.tooling.includes(value);
       case 'stack':

apps/cli/src/lib/package-json-generator.ts

@@ -165,6 +165,25 @@ export function generateAppPackageJson(app: AppContext, ctx: TemplateContext, ap
     }
   }
 
+  // Process linter addon
+  if (ctx.project.linter) {
+    const linterAddon = META.project.linter.options[ctx.project.linter];
+    if (linterAddon) {
+      const packageName = getProjectAddonPackageName(linterAddon);
+      if (packageName && isTurborepo) {
+        merged.devDependencies = {
+          ...merged.devDependencies,
+          [`@repo/${packageName}`]: '*',
+        };
+        if (linterAddon.appPackageJson) {
+          merged = mergePackageJsonConfigs(merged, linterAddon.appPackageJson);
+        }
+      } else if (!isTurborepo) {
+        merged = mergePackageJsonConfigs(merged, linterAddon.packageJson, linterAddon.appPackageJson);
+      }
+    }
+  }
+
   if (isTurborepo) {
     merged.devDependencies = {
       ...merged.devDependencies,
@@ -255,6 +274,19 @@ export function generateRootPackageJson(ctx: TemplateContext): GeneratedPackageJ
     }
   }
 
+  // Add root-scoped linter to root package.json (biome)
+  if (ctx.project.linter) {
+    const linterAddon = META.project.linter.options[ctx.project.linter];
+    if (linterAddon?.mono?.scope === 'root' && linterAddon.packageJson) {
+      if (linterAddon.packageJson.devDependencies) {
+        devDependencies = { ...devDependencies, ...linterAddon.packageJson.devDependencies };
+      }
+      if (linterAddon.packageJson.scripts) {
+        Object.assign(scripts, linterAddon.packageJson.scripts);
+      }
+    }
+  }
+
   const pkg: PackageJson = {
     name: ctx.projectName,
     version: '0.0.0',
@@ -293,6 +325,15 @@ export function generateAllPackageJsons(ctx: TemplateContext): GeneratedPackageJ
       }
     }
 
+    // Collect linter package (eslint-config)
+    if (ctx.project.linter) {
+      const linterAddon = META.project.linter.options[ctx.project.linter];
+      if (linterAddon?.mono?.scope === 'pkg') {
+        const pkgName = linterAddon.mono.name;
+        extractedPackages.set(pkgName, linterAddon.packageJson ?? {});
+      }
+    }
+
     // Collect ORM package with database deps merged
     if (ctx.project.orm) {
       const ormAddon = META.project.orm.options[ctx.project.orm];

apps/cli/src/lib/template-resolver.ts

@@ -51,7 +51,7 @@
     return frontmatter.path ?? relativePath;
   }
 
   const scope = frontmatter.mono?.scope ?? addon.mono?.scope ?? 'root';
   const filePath = frontmatter.mono?.path ?? relativePath;
 
   switch (scope) {
@@ -144,6 +144,9 @@
   for (const file of files) {
     const source = join(addonDir, file);
 
+    const { stackName: fileSuffix } = parseStackSuffix(file, VALID_STACKS);
+    if (fileSuffix) continue;
+
     const { frontmatter, only } = readFrontmatter(source);
     if (shouldSkipTemplate(only, ctx)) continue;
 
@@ -155,6 +158,39 @@
   return templates;
 }
 
+function resolveStackSpecificAddonTemplates(
+  category: ProjectCategoryName,
+  addonName: string,
+  appName: string,
+  stackName: StackName,
+  ctx: TemplateContext,
+): TemplateFile[] {
+  const addon = META.project[category]?.options[addonName];
+  if (!addon) return [];
+
+  const addonDir = join(TEMPLATES_DIR, 'project', category, addonName);
+  const files = scanDirectory(addonDir);
+  const templates: TemplateFile[] = [];
+
+  for (const file of files) {
+    const source = join(addonDir, file);
+
+    const { stackName: fileSuffix, cleanFilename } = parseStackSuffix(file, VALID_STACKS);
+    if (!fileSuffix) continue;
+    if (fileSuffix !== stackName) continue;
+
+    const { only } = readFrontmatter(source);
+    if (shouldSkipTemplate(only, ctx)) continue;
+
+    const transformedPath = transformFilename(cleanFilename);
+    const isTurborepo = ctx.repo === 'turborepo';
+    const destination = isTurborepo ? `apps/${appName}/${transformedPath}` : transformedPath;
+    templates.push({ source, destination });
+  }
+
+  return templates;
+}
+
 function resolveTemplatesForRepo(ctx: TemplateContext): TemplateFile[] {
   const repoDir = join(TEMPLATES_DIR, 'repo', ctx.repo);
   const files = scanDirectory(repoDir);
@@ -188,6 +224,14 @@
   if (ctx.project.orm) {
     templates.push(...resolveTemplatesForProjectAddon('orm', ctx.project.orm, ctx));
   }
+  if (ctx.project.linter) {
+    templates.push(...resolveTemplatesForProjectAddon('linter', ctx.project.linter, ctx));
+    for (const app of ctx.apps) {
+      templates.push(
+        ...resolveStackSpecificAddonTemplates('linter', ctx.project.linter, app.appName, app.stackName, ctx),
+      );
+    }
+  }
   for (const tooling of ctx.project.tooling) {
     templates.push(...resolveTemplatesForProjectAddon('tooling', tooling, ctx));
   }