diff --git a/.changeset/biome-ultracite-preset.md b/.changeset/biome-ultracite-preset.md new file mode 100644 index 000000000..0f6ccdf7c --- /dev/null +++ b/.changeset/biome-ultracite-preset.md @@ -0,0 +1,6 @@ +--- +"@tanstack/create": minor +"@tanstack/cli": minor +--- + +Add an optional Ultracite preset to the Biome toolchain for React and Solid apps. Keep the existing recommended Biome configuration as the default. diff --git a/packages/cli/skills/create-app-scaffold/SKILL.md b/packages/cli/skills/create-app-scaffold/SKILL.md index 0602efcc9..c6a6bae11 100644 --- a/packages/cli/skills/create-app-scaffold/SKILL.md +++ b/packages/cli/skills/create-app-scaffold/SKILL.md @@ -178,3 +178,7 @@ See also: query-docs-library-metadata/SKILL.md ยง Common Mistakes - [Build tool options](references/bundlers.md) - [Deployment provider options](references/deployment-providers.md) - [Toolchain options](references/toolchains.md) + +### Biome presets + +Biome keeps its recommended configuration by default. To select Ultracite while creating an app, use `--yes --toolchain biome --add-on-config '{"biome":{"preset":"ultracite"}}'`. Ultracite requires Node `^22.22.2 || >=24.15.0` in the generated app and uses its core and framework presets. Component filenames accept PascalCase and kebab-case. The selected preset is saved in the project configuration. diff --git a/packages/cli/tests-e2e/biome-preset.spec.ts b/packages/cli/tests-e2e/biome-preset.spec.ts new file mode 100644 index 000000000..9540823ff --- /dev/null +++ b/packages/cli/tests-e2e/biome-preset.spec.ts @@ -0,0 +1,42 @@ +import { execFile } from 'node:child_process' +import { promisify } from 'node:util' +import { readFile } from 'node:fs/promises' +import { join } from 'node:path' +import { expect, test } from '@playwright/test' +import { attachRuntimeGuards, createAppFixture, optimizePageForFastE2E } from './helpers' + +const execFileAsync = promisify(execFile) + +for (const framework of ['react', 'solid'] as const) { + for (const bundler of ['vite', 'rsbuild'] as const) { + test(`@matrix builds, types and lints ${framework} ${bundler} with the Ultracite preset`, async ({ page }) => { + const fixture = await createAppFixture({ + appName: `${framework}-${bundler}-ultracite`, framework, bundler, + packageManager: bundler === 'vite' ? 'npm' : 'pnpm', + toolchain: 'biome', addOnConfig: { biome: { preset: 'ultracite' } }, + runQualityGatesChecks: true, + afterCreate: async (appDir) => { + const pkg = JSON.parse(await readFile(join(appDir, 'package.json'), 'utf8')) + expect(pkg.devDependencies.ultracite).toBe('8.3.1') + expect(pkg.devDependencies['@biomejs/biome']).toBe('2.6.7') + expect(pkg.devDependencies.oxlint).toBeUndefined() + const config = JSON.parse(await readFile(join(appDir, 'biome.json'), 'utf8')) + expect(config.extends).toEqual(['ultracite/biome/core', `ultracite/biome/${framework}`]) + }, + }) + const guards = attachRuntimeGuards(page, fixture.url) + try { + await execFileAsync('npm', ['run', 'lint'], { cwd: fixture.appDir }) + await optimizePageForFastE2E(page) + await page.goto(fixture.url) + await expect(page.getByRole('heading', { name: 'Start simple, ship quickly.' })).toBeVisible() + await expect(page.getByText('Type-Safe Routing', { exact: true })).toBeVisible() + guards.assertClean() + } finally { + guards.dispose() + await fixture.stop() + await fixture.cleanup() + } + }) + } +} diff --git a/packages/cli/tests-e2e/helpers.ts b/packages/cli/tests-e2e/helpers.ts index de699d23d..0708e4d2c 100644 --- a/packages/cli/tests-e2e/helpers.ts +++ b/packages/cli/tests-e2e/helpers.ts @@ -29,6 +29,7 @@ type CreateAppFixtureOptions = { deployment?: string routerOnly?: boolean template?: string + addOnConfig?: Record> addOns?: Array postCreateAddOns?: Array afterCreate?: (appDir: string) => Promise @@ -373,6 +374,7 @@ export async function createAppFixture( template, addOns, afterCreate, + addOnConfig, postCreateAddOns, skipDevServer, runQualityGatesChecks = false, @@ -419,6 +421,10 @@ export async function createAppFixture( createArgs.push('--template', template) } + if (addOnConfig) { + createArgs.push('--add-on-config', JSON.stringify(addOnConfig)) + } + if (addOns?.length) { createArgs.push('--add-ons', addOns.join(',')) } diff --git a/packages/create/src/frameworks/react/project/base/src/components/Footer.tsx.ejs b/packages/create/src/frameworks/react/project/base/src/components/Footer.tsx.ejs index f70e476b6..583871e9f 100644 --- a/packages/create/src/frameworks/react/project/base/src/components/Footer.tsx.ejs +++ b/packages/create/src/frameworks/react/project/base/src/components/Footer.tsx.ejs @@ -3,7 +3,7 @@ export default function Footer() { const year = new Date().getFullYear() return ( -