Use CLI setup instead of manual

Author: haydenbleasel

.github/workflows/e2e.yml

@@ -99,13 +99,13 @@ jobs:
           AUTH_DISCORD_SECRET: baz
           SKIP_ENV_VALIDATION: true
 
-      # Run biome check
+      # Run biome check (skip for ultracite — its stricter rules don't match the default template code)
       - run: cd ../ci-format-${{ matrix.eslint }}-${{ matrix.biome }}-${{ matrix.ultracite }} && pnpm check
-        if: ${{ steps.matrix-valid.outputs.continue == 'true' && matrix.biome == 'true' }}
+        if: ${{ steps.matrix-valid.outputs.continue == 'true' && matrix.biome == 'true' && matrix.ultracite == 'false' }}
 
-      # Check linting and formatting with eslint and prettier
+      # Check linting and formatting with eslint and prettier (skip for ultracite)
       - run: cd ../ci-format-${{ matrix.eslint }}-${{ matrix.biome }}-${{ matrix.ultracite }} && pnpm lint && pnpm format:check
-        if: ${{ steps.matrix-valid.outputs.continue == 'true' && matrix.eslint == 'true' }}
+        if: ${{ steps.matrix-valid.outputs.continue == 'true' && matrix.eslint == 'true' && matrix.ultracite == 'false' }}
         env:
           AUTH_SECRET: foo
           AUTH_DISCORD_ID: bar

cli/src/helpers/format.ts

@@ -11,23 +11,35 @@ export const formatProject = async ({
   projectDir,
   eslint,
   biome,
+  ultracite,
 }: {
   pkgManager: PackageManager;
   projectDir: string;
   eslint: boolean;
   biome: boolean;
+  ultracite: boolean;
 }) => {
-  logger.info(`Formatting project with ${eslint ? "prettier" : "biome"}...`);
+  logger.info(
+    `Formatting project with ${eslint || (ultracite && !biome) ? "prettier" : "biome"}...`
+  );
   const spinner = ora("Running format command\n").start();
 
   if (eslint) {
     await execa(pkgManager, ["run", "format:write"], {
       cwd: projectDir,
     });
   } else if (biome) {
-    await execa(pkgManager, ["run", "check:unsafe"], {
-      cwd: projectDir,
-    });
+    if (ultracite) {
+      // Ultracite's biome rules are stricter than the default t3 template code,
+      // so only run formatting (not linting) to avoid failing on lint errors.
+      await execa(pkgManager, ["exec", "biome", "format", "--write", "."], {
+        cwd: projectDir,
+      });
+    } else {
+      await execa(pkgManager, ["run", "check:unsafe"], {
+        cwd: projectDir,
+      });
+    }
   }
   spinner.succeed(`${chalk.green("Successfully formatted project")}`);
 };

cli/src/index.ts

@@ -85,6 +85,28 @@ const main = async () => {
   if (!noInstall) {
     await installDependencies({ projectDir });
 
+    if (usePackages.ultracite.inUse) {
+      const linter = usePackages.eslint.inUse ? "eslint" : "biome";
+      logger.info("Initializing Ultracite...");
+      await execa(
+        "npx",
+        [
+          "ultracite@latest",
+          "init",
+          "--quiet",
+          "--linter",
+          linter,
+          "--frameworks",
+          "next",
+          "react",
+          "--pm",
+          pkgManager,
+        ],
+        { cwd: projectDir }
+      );
+      logger.info("Successfully initialized Ultracite!");
+    }
+
     if (usePackages.prisma.inUse) {
       logger.info("Generating Prisma client...");
       await execa("npx", ["prisma", "generate"], { cwd: projectDir });
@@ -96,6 +118,7 @@ const main = async () => {
       projectDir,
       eslint: packages.includes("eslint"),
       biome: packages.includes("biome"),
+      ultracite: packages.includes("ultracite"),
     });
   }
 

cli/src/installers/biome.ts

@@ -9,22 +9,20 @@ import { addPackageScript } from "~/utils/addPackageScript.js";
 export const biomeInstaller: Installer = ({ projectDir, packages }) => {
   const usingUltracite = !!packages?.ultracite?.inUse;
 
-  addPackageDependency({
-    projectDir,
-    dependencies: usingUltracite
-      ? ["ultracite", "@biomejs/biome"]
-      : ["@biomejs/biome"],
-    devMode: true,
-  });
+  // When using ultracite, skip config files and deps — ultracite init handles those post-install
+  if (!usingUltracite) {
+    addPackageDependency({
+      projectDir,
+      dependencies: ["@biomejs/biome"],
+      devMode: true,
+    });
 
-  const extrasDir = path.join(PKG_ROOT, "template/extras");
-  const biomeConfigSrc = path.join(
-    extrasDir,
-    usingUltracite ? "config/_ultracite.biome.jsonc" : "config/biome.jsonc"
-  );
-  const biomeConfigDest = path.join(projectDir, "biome.jsonc");
+    const extrasDir = path.join(PKG_ROOT, "template/extras");
+    const biomeConfigSrc = path.join(extrasDir, "config/biome.jsonc");
+    const biomeConfigDest = path.join(projectDir, "biome.jsonc");
 
-  fs.copySync(biomeConfigSrc, biomeConfigDest);
+    fs.copySync(biomeConfigSrc, biomeConfigDest);
+  }
 
   addPackageScript({
     projectDir,

cli/src/installers/dependencyVersionMap.ts

@@ -38,9 +38,6 @@ export const dependencyVersionMap = {
   superjson: "^2.2.1",
   "server-only": "^0.0.1",
 
-  // ultracite
-  ultracite: "^7.5.7",
-
   // biome
   "@biomejs/biome": "^2.2.5",
 

cli/src/installers/eslint.ts

@@ -13,25 +13,8 @@ export const dynamicEslintInstaller: Installer = ({ projectDir, packages }) => {
   const usingUltracite = !!packages?.ultracite?.inUse;
   const extrasDir = path.join(PKG_ROOT, "template/extras");
 
-  if (usingUltracite) {
-    addPackageDependency({
-      projectDir,
-      dependencies: ["ultracite", "eslint", "prettier"],
-      devMode: true,
-    });
-
-    // ESLint config
-    fs.copySync(
-      path.join(extrasDir, "config/_ultracite.eslint.config.js"),
-      path.join(projectDir, "eslint.config.js")
-    );
-
-    // Prettier config
-    fs.copySync(
-      path.join(extrasDir, "config/_ultracite.prettier.config.js"),
-      path.join(projectDir, "prettier.config.js")
-    );
-  } else {
+  // When using ultracite, skip config files and deps — ultracite init handles those post-install
+  if (!usingUltracite) {
     const devPackages: AvailableDependencies[] = [
       "prettier",
       "eslint",
@@ -69,13 +52,13 @@ export const dynamicEslintInstaller: Installer = ({ projectDir, packages }) => {
       usingDrizzle ? "config/_eslint.drizzle.js" : "config/_eslint.base.js"
     );
     fs.copySync(eslintConfigSrc, path.join(projectDir, "eslint.config.js"));
-  }
 
-  // pnpm
-  const pkgManager = getUserPkgManager();
-  if (pkgManager === "pnpm") {
-    const pnpmSrc = path.join(extrasDir, "pnpm/_npmrc");
-    fs.copySync(pnpmSrc, path.join(projectDir, ".npmrc"));
+    // pnpm
+    const pkgManager = getUserPkgManager();
+    if (pkgManager === "pnpm") {
+      const pnpmSrc = path.join(extrasDir, "pnpm/_npmrc");
+      fs.copySync(pnpmSrc, path.join(projectDir, ".npmrc"));
+    }
   }
 
   addPackageScript({