feat(cli): add ultracite, oxlint, fumadocs addons

apps/cli/src/constants.ts

@@ -1,6 +1,6 @@
 import path from "node:path";
 import { fileURLToPath } from "node:url";
-import type { Frontend, ProjectConfig } from "./types";
+import type { Addons, Frontend, ProjectConfig } from "./types";
 import { getUserPkgManager } from "./utils/get-package-manager";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -55,10 +55,11 @@ export const dependencyVersionMap = {
 
 	"@tauri-apps/cli": "^2.4.0",
 
-	"@biomejs/biome": "^2.0.0",
+	"@biomejs/biome": "^2.1.2",
+	oxlint: "^1.8.0",
 
 	husky: "^9.1.7",
-	"lint-staged": "^15.5.0",
+	"lint-staged": "^16.1.2",
 
 	tsx: "^4.19.2",
 	"@types/node": "^22.13.11",
@@ -119,13 +120,16 @@ export const dependencyVersionMap = {
 
 export type AvailableDependencies = keyof typeof dependencyVersionMap;
 
-export const ADDON_COMPATIBILITY = {
+export const ADDON_COMPATIBILITY: Record<Addons, readonly Frontend[]> = {
 	pwa: ["tanstack-router", "react-router", "solid", "next"],
 	tauri: ["tanstack-router", "react-router", "nuxt", "svelte", "solid"],
 	biome: [],
 	husky: [],
 	turborepo: [],
 	starlight: [],
+	ultracite: [],
+	oxlint: [],
+	fumadocs: [],
 	none: [],
 } as const;
 

apps/cli/src/helpers/project-generation/post-installation.ts

@@ -142,6 +142,10 @@ export async function displayPostInstallInstructions(
 		output += `${pc.cyan("•")} Docs: http://localhost:4321\n`;
 	}
 
+	if (addons?.includes("fumadocs")) {
+		output += `${pc.cyan("•")} Fumadocs: http://localhost:4000\n`;
+	}
+
 	if (nativeInstructions) output += `\n${nativeInstructions.trim()}\n`;
 	if (databaseInstructions) output += `\n${databaseInstructions.trim()}\n`;
 	if (tauriInstructions) output += `\n${tauriInstructions.trim()}\n`;

apps/cli/src/helpers/project-generation/template-manager.ts

@@ -790,6 +790,14 @@ export async function handleExtras(
 		}
 	}
 
+	if (context.packageManager === "bun") {
+		const bunfigSrc = path.join(extrasDir, "bunfig.toml");
+		const bunfigDest = path.join(projectDir, "bunfig.toml");
+		if (await fs.pathExists(bunfigSrc)) {
+			await fs.copy(bunfigSrc, bunfigDest);
+		}
+	}
+
 	if (
 		context.packageManager === "pnpm" &&
 		(hasNative || context.frontend.includes("nuxt"))

apps/cli/src/helpers/setup/addons-setup.ts

@@ -1,15 +1,19 @@
 import path from "node:path";
 import { log } from "@clack/prompts";
+import { execa } from "execa";
 import fs from "fs-extra";
 import pc from "picocolors";
-import type { Frontend, ProjectConfig } from "../../types";
+import type { Frontend, PackageManager, ProjectConfig } from "../../types";
 import { addPackageDependency } from "../../utils/add-package-deps";
+import { getPackageExecutionCommand } from "../../utils/package-runner";
+import { setupFumadocs } from "./fumadocs-setup";
 import { setupStarlight } from "./starlight-setup";
 import { setupTauri } from "./tauri-setup";
+import { setupUltracite } from "./ultracite-setup";
 import { addPwaToViteConfig } from "./vite-pwa-setup";
 
 export async function setupAddons(config: ProjectConfig, isAddCommand = false) {
-	const { addons, frontend, projectDir } = config;
+	const { addons, frontend, projectDir, packageManager } = config;
 	const hasReactWebFrontend =
 		frontend.includes("react-router") ||
 		frontend.includes("tanstack-router") ||
@@ -53,15 +57,38 @@ ${pc.cyan("Docs:")} ${pc.underline("https://turborepo.com/docs")}
 	) {
 		await setupTauri(config);
 	}
-	if (addons.includes("biome")) {
-		await setupBiome(projectDir);
+	const hasUltracite = addons.includes("ultracite");
+	const hasBiome = addons.includes("biome");
+	const hasHusky = addons.includes("husky");
+	const hasOxlint = addons.includes("oxlint");
+
+	if (hasUltracite) {
+		await setupUltracite(config, hasHusky);
+	} else {
+		if (hasBiome) {
+			await setupBiome(projectDir);
+		}
+		if (hasHusky) {
+			// Determine which linter to use for lint-staged
+			let linter: "biome" | "oxlint" | undefined;
+			if (hasOxlint) {
+				linter = "oxlint";
+			} else if (hasBiome) {
+				linter = "biome";
+			}
+			await setupHusky(projectDir, linter);
+		}
 	}
-	if (addons.includes("husky")) {
-		await setupHusky(projectDir);
+
+	if (addons.includes("oxlint")) {
+		await setupOxlint(projectDir, packageManager);
 	}
 	if (addons.includes("starlight")) {
 		await setupStarlight(config);
 	}
+	if (addons.includes("fumadocs")) {
+		await setupFumadocs(config);
+	}
 }
 
 function getWebAppDir(projectDir: string, frontends: Frontend[]): string {
@@ -77,7 +104,7 @@ function getWebAppDir(projectDir: string, frontends: Frontend[]): string {
 	return path.join(projectDir, "apps/web");
 }
 
-async function setupBiome(projectDir: string) {
+export async function setupBiome(projectDir: string) {
 	await addPackageDependency({
 		devDependencies: ["@biomejs/biome"],
 		projectDir,
@@ -96,7 +123,10 @@ async function setupBiome(projectDir: string) {
 	}
 }
 
-async function setupHusky(projectDir: string) {
+export async function setupHusky(
+	projectDir: string,
+	linter?: "biome" | "oxlint",
+) {
 	await addPackageDependency({
 		devDependencies: ["husky", "lint-staged"],
 		projectDir,
@@ -111,11 +141,21 @@ async function setupHusky(projectDir: string) {
 			prepare: "husky",
 		};
 
-		packageJson["lint-staged"] = {
-			"*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
-				"biome check --write .",
-			],
-		};
+		if (linter === "oxlint") {
+			packageJson["lint-staged"] = {
+				"**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue,astro,svelte}": "oxlint",
+			};
+		} else if (linter === "biome") {
+			packageJson["lint-staged"] = {
+				"*.{js,ts,cjs,mjs,d.cts,d.mts,jsx,tsx,json,jsonc}": [
+					"biome check --write .",
+				],
+			};
+		} else {
+			packageJson["lint-staged"] = {
+				"**/*.{js,mjs,cjs,jsx,ts,mts,cts,tsx,vue,astro,svelte}": "",
+			};
+		}
 
 		await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
 	}
@@ -157,3 +197,33 @@ async function setupPwa(projectDir: string, frontends: Frontend[]) {
 		await addPwaToViteConfig(viteConfigTs, path.basename(projectDir));
 	}
 }
+
+async function setupOxlint(projectDir: string, packageManager: PackageManager) {
+	await addPackageDependency({
+		devDependencies: ["oxlint"],
+		projectDir,
+	});
+
+	const packageJsonPath = path.join(projectDir, "package.json");
+	if (await fs.pathExists(packageJsonPath)) {
+		const packageJson = await fs.readJson(packageJsonPath);
+
+		packageJson.scripts = {
+			...packageJson.scripts,
+			check: "oxlint",
+		};
+
+		await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+	}
+
+	const oxlintInitCommand = getPackageExecutionCommand(
+		packageManager,
+		"oxlint@latest --init",
+	);
+
+	await execa(oxlintInitCommand, {
+		cwd: projectDir,
+		env: { CI: "true" },
+		shell: true,
+	});
+}

apps/cli/src/helpers/setup/fumadocs-setup.ts

@@ -0,0 +1,96 @@
+import path from "node:path";
+import { cancel, isCancel, log, select } from "@clack/prompts";
+import consola from "consola";
+import { execa } from "execa";
+import fs from "fs-extra";
+import pc from "picocolors";
+import type { ProjectConfig } from "../../types";
+import { getPackageExecutionCommand } from "../../utils/package-runner";
+
+type FumadocsTemplate =
+	| "next-mdx"
+	| "next-content-collections"
+	| "react-router-mdx-remote"
+	| "tanstack-start-mdx-remote";
+
+const TEMPLATES = {
+	"next-mdx": {
+		label: "Next.js: Fumadocs MDX",
+		hint: "Recommended template with MDX support",
+		value: "+next+fuma-docs-mdx",
+	},
+	"next-content-collections": {
+		label: "Next.js: Content Collections",
+		hint: "Template using Next.js content collections",
+		value: "+next+content-collections",
+	},
+	"react-router-mdx-remote": {
+		label: "React Router: MDX Remote",
+		hint: "Template for React Router with MDX remote",
+		value: "react-router",
+	},
+	"tanstack-start-mdx-remote": {
+		label: "Tanstack Start: MDX Remote",
+		hint: "Template for Tanstack Start with MDX remote",
+		value: "tanstack-start",
+	},
+} as const;
+
+export async function setupFumadocs(config: ProjectConfig) {
+	const { packageManager, projectDir } = config;
+
+	try {
+		log.info("Setting up Fumadocs...");
+
+		const template = await select<FumadocsTemplate>({
+			message: "Choose a template",
+			options: Object.entries(TEMPLATES).map(([key, template]) => ({
+				value: key as FumadocsTemplate,
+				label: template.label,
+				hint: template.hint,
+			})),
+			initialValue: "next-mdx",
+		});
+
+		if (isCancel(template)) {
+			cancel(pc.red("Operation cancelled"));
+			process.exit(0);
+		}
+
+		const templateArg = TEMPLATES[template].value;
+
+		const commandWithArgs = `create-fumadocs-app@latest fumadocs --template ${templateArg} --src --no-install --pm bun --no-eslint`;
+
+		const fumadocsInitCommand = getPackageExecutionCommand(
+			packageManager,
+			commandWithArgs,
+		);
+
+		await execa(fumadocsInitCommand, {
+			cwd: path.join(projectDir, "apps"),
+			env: { CI: "true" },
+			shell: true,
+		});
+
+		const fumadocsDir = path.join(projectDir, "apps", "fumadocs");
+		const packageJsonPath = path.join(fumadocsDir, "package.json");
+
+		if (await fs.pathExists(packageJsonPath)) {
+			const packageJson = await fs.readJson(packageJsonPath);
+			packageJson.name = "fumadocs";
+
+			if (packageJson.scripts?.dev) {
+				packageJson.scripts.dev = `${packageJson.scripts.dev} --port=4000`;
+			}
+
+			await fs.writeJson(packageJsonPath, packageJson, { spaces: 2 });
+		}
+
+		log.success("Fumadocs setup successfully!");
+	} catch (error) {
+		log.error(pc.red("Failed to set up Fumadocs"));
+		if (error instanceof Error) {
+			consola.error(pc.red(error.message));
+		}
+	}
+}