Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .changeset/biome-ultracite-preset.md
Original file line number Diff line number Diff line change
@@ -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.
4 changes: 4 additions & 0 deletions packages/cli/skills/create-app-scaffold/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
42 changes: 42 additions & 0 deletions packages/cli/tests-e2e/biome-preset.spec.ts
Original file line number Diff line number Diff line change
@@ -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()
}
})
}
}
6 changes: 6 additions & 0 deletions packages/cli/tests-e2e/helpers.ts
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ type CreateAppFixtureOptions = {
deployment?: string
routerOnly?: boolean
template?: string
addOnConfig?: Record<string, Record<string, unknown>>
addOns?: Array<string>
postCreateAddOns?: Array<string>
afterCreate?: (appDir: string) => Promise<void>
Expand Down Expand Up @@ -373,6 +374,7 @@ export async function createAppFixture(
template,
addOns,
afterCreate,
addOnConfig,
postCreateAddOns,
skipDevServer,
runQualityGatesChecks = false,
Expand Down Expand Up @@ -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(','))
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ export default function Footer() {
const year = new Date().getFullYear()

return (
<footer className="mt-20 border-t border-[var(--line)] px-4 pb-14 pt-10 text-[var(--sea-ink-soft)]">
<footer className="mt-20 border-t border-[var(--line)] px-4 pt-10 pb-14 text-[var(--sea-ink-soft)]">
<div className="page-wrap flex flex-col items-center justify-between gap-4 text-center sm:flex-row sm:text-left">
<p className="m-0 text-sm">&copy; {year} Your name here. All rights reserved.</p>
<p className="island-kicker m-0">Built with TanStack Start</p>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,23 @@ export default function ThemeToggle() {
const [mounted, setMounted] = useState(false)
useEffect(() => setMounted(true), [])
const mode = mounted ? theme : undefined
const nextMode = mode === 'light' ? 'dark' : mode === 'dark' ? 'system' : 'light'
let nextMode: 'light' | 'dark' | 'system' = 'light'
if (mode === 'light') {
nextMode = 'dark'
}
if (mode === 'dark') {
nextMode = 'system'
}
let modeLabel = 'Theme'
if (mode === 'system') {
modeLabel = 'Auto'
}
if (mode === 'dark') {
modeLabel = 'Dark'
}
if (mode === 'light') {
modeLabel = 'Light'
}
const label = mode ? `Theme mode: ${mode}. Click to switch mode.` : 'Switch theme'
return (
<button
Expand All @@ -18,7 +34,7 @@ export default function ThemeToggle() {
title={label}
className="rounded-full border border-[var(--chip-line)] bg-[var(--chip-bg)] px-3 py-1.5 text-sm font-semibold text-[var(--sea-ink)] shadow-[0_8px_22px_rgba(30,90,72,0.08)] transition hover:-translate-y-0.5"
>
{mode === 'system' ? 'Auto' : mode === 'dark' ? 'Dark' : mode === 'light' ? 'Light' : 'Theme'}
{modeLabel}
</button>
)
}
Expand All @@ -42,7 +58,10 @@ function getInitialMode(): ThemeMode {

function applyThemeMode(mode: ThemeMode) {
const prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches
const resolved = mode === 'auto' ? (prefersDark ? 'dark' : 'light') : mode
let resolved = prefersDark ? 'dark' : 'light'
if (mode !== 'auto') {
resolved = mode
}

document.documentElement.classList.remove('light', 'dark')
document.documentElement.classList.add(resolved)
Expand Down Expand Up @@ -80,13 +99,26 @@ export default function ThemeToggle() {
}, [mode])

function toggleMode() {
const nextMode: ThemeMode =
mode === 'light' ? 'dark' : mode === 'dark' ? 'auto' : 'light'
let nextMode: ThemeMode = 'light'
if (mode === 'light') {
nextMode = 'dark'
}
if (mode === 'dark') {
nextMode = 'auto'
}
setMode(nextMode)
applyThemeMode(nextMode)
window.localStorage.setItem('theme', nextMode)
}

let modeLabel = 'Light'
if (mode === 'auto') {
modeLabel = 'Auto'
}
if (mode === 'dark') {
modeLabel = 'Dark'
}

const label =
mode === 'auto'
? 'Theme mode: auto (system). Click to switch to light mode.'
Expand All @@ -100,7 +132,7 @@ export default function ThemeToggle() {
title={label}
className="rounded-full border border-[var(--chip-line)] bg-[var(--chip-bg)] px-3 py-1.5 text-sm font-semibold text-[var(--sea-ink)] shadow-[0_8px_22px_rgba(30,90,72,0.08)] transition hover:-translate-y-0.5"
>
{mode === 'auto' ? 'Auto' : mode === 'dark' ? 'Dark' : 'Light'}
{modeLabel}
</button>
)
}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -204,7 +204,7 @@ function RootDocument({ children }: { children: React.ReactNode }) {
<ScriptOnce>{THEME_INIT_SCRIPT}</ScriptOnce>
<HeadContent />
</head>
<body className="font-sans antialiased [overflow-wrap:anywhere] selection:bg-[rgba(79,184,178,0.24)]">
<body className="font-sans [overflow-wrap:anywhere] antialiased selection:bg-[rgba(79,184,178,0.24)]">
<% for(const integration of integrations.filter(i => i.type === 'provider')) { %><<%= integration.jsName %>>
<% } %><Header />
{children}
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -35,10 +35,10 @@ export const Route = createFileRoute("/")({ component: App });

function App() {
return (
<main className="page-wrap px-4 pb-8 pt-14">
<main className="page-wrap px-4 pt-14 pb-8">
<section className="island-shell rise-in relative overflow-hidden rounded-[2rem] px-6 py-10 sm:px-10 sm:py-14">
<div className="pointer-events-none absolute -left-20 -top-24 h-56 w-56 rounded-full bg-[radial-gradient(circle,rgba(79,184,178,0.32),transparent_66%)]" />
<div className="pointer-events-none absolute -bottom-20 -right-20 h-56 w-56 rounded-full bg-[radial-gradient(circle,rgba(47,106,74,0.18),transparent_66%)]" />
<div className="pointer-events-none absolute -top-24 -left-20 h-56 w-56 rounded-full bg-[radial-gradient(circle,rgba(79,184,178,0.32),transparent_66%)]" />
<div className="pointer-events-none absolute -right-20 -bottom-20 h-56 w-56 rounded-full bg-[radial-gradient(circle,rgba(47,106,74,0.18),transparent_66%)]" />
<p className="island-kicker mb-3">TanStack Start Base Template</p>
<h1 className="display-title mb-5 max-w-3xl text-4xl leading-[1.02] font-bold tracking-tight text-[var(--sea-ink)] sm:text-6xl">
Start simple, ship quickly.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,12 @@
{
"$schema": "https://biomejs.dev/schemas/2.4.5/schema.json",
"$schema": "https://biomejs.dev/schemas/<%= addOnOption?.biome?.preset === 'ultracite' ? '2.6.7' : '2.4.5' %>/schema.json",
<% if (addOnOption?.biome?.preset === 'ultracite') { %>"extends": ["ultracite/biome/core", "ultracite/biome/react"],
"overrides": [{
"includes": ["**/src/components/**"],
"linter": { "rules": { "style": { "useFilenamingConvention": {
"level": "error", "options": { "filenameCases": ["PascalCase", "kebab-case"] }
} } } }
}],<% } %>
"vcs": {
"enabled": false,
"clientKind": "git",
Expand Down
20 changes: 19 additions & 1 deletion packages/create/src/frameworks/react/toolchains/biome/info.json
Original file line number Diff line number Diff line change
Expand Up @@ -8,5 +8,23 @@
"color": "#60A5FA",
"priority": 2,
"modes": ["code-router", "file-router"],
"link": "https://biomejs.dev"
"link": "https://biomejs.dev",
"options": {
"preset": {
"type": "select",
"label": "Biome preset",
"description": "Ultracite requires Node ^22.22.2 or >=24.15.0 for development tools.",
"default": "recommended",
"options": [
{
"value": "recommended",
"label": "Recommended"
},
{
"value": "ultracite",
"label": "Ultracite (Node ^22.22.2 or >=24.15.0)"
}
]
}
}
}
10 changes: 0 additions & 10 deletions packages/create/src/frameworks/react/toolchains/biome/package.json

This file was deleted.

Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"scripts": {
"format": "biome format",
"lint": "biome lint",
"check": "biome check"
},
"devDependencies": {
<% if (addOnOption?.biome?.preset === 'ultracite') { %>"ultracite": "8.3.1",<% } %>
"@biomejs/biome": "<%= addOnOption?.biome?.preset === 'ultracite' ? '2.6.7' : '2.4.5' %>"
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ export default defineConfig({
<% } -%>
plugins: [
pluginBabel({
include: /\.(?:jsx|tsx)$/,
include: /\.(?:jsx|tsx)$/u,
}),
pluginSolid(),
<% if (tailwind) { %>pluginTailwindcss(),<% } %>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -30,10 +30,11 @@ export default function Header() {
</Link>
</h2>

<div class="ml-auto flex items-center gap-2">
<% if (userHeaders.length === 0) { %><div class="ml-auto flex items-center gap-2" />
<% } else { %><div class="ml-auto flex items-center gap-2">
<% for (const integration of userHeaders) { %><<%= integration.jsName %> />
<% } %>
</div>
</div><% } %>

<div class="order-3 flex w-full flex-wrap items-center gap-x-4 gap-y-1 pb-1 text-sm font-semibold sm:order-2 sm:w-auto sm:flex-nowrap sm:pb-0">
<Link to="/" class="nav-link" activeProps={{ class: 'nav-link is-active' }}>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -29,16 +29,17 @@ function Home() {
)
}
<% } else { %>
import { For } from 'solid-js'
import { createFileRoute } from '@tanstack/solid-router'

export const Route = createFileRoute('/')({ component: App })

function App() {
return (
<main class="page-wrap px-4 pb-8 pt-14">
<main class="page-wrap px-4 pt-14 pb-8">
<section class="island-shell rise-in relative overflow-hidden rounded-[2rem] px-6 py-10 sm:px-10 sm:py-14">
<div class="pointer-events-none absolute -left-20 -top-24 h-56 w-56 rounded-full bg-[radial-gradient(circle,rgba(79,184,178,0.32),transparent_66%)]" />
<div class="pointer-events-none absolute -bottom-20 -right-20 h-56 w-56 rounded-full bg-[radial-gradient(circle,rgba(47,106,74,0.18),transparent_66%)]" />
<div class="pointer-events-none absolute -top-24 -left-20 h-56 w-56 rounded-full bg-[radial-gradient(circle,rgba(79,184,178,0.32),transparent_66%)]" />
<div class="pointer-events-none absolute -right-20 -bottom-20 h-56 w-56 rounded-full bg-[radial-gradient(circle,rgba(47,106,74,0.18),transparent_66%)]" />
<p class="island-kicker mb-3">TanStack Start Base Template</p>
<h1 class="display-title mb-5 max-w-3xl text-4xl leading-[1.02] font-bold tracking-tight text-[var(--sea-ink)] sm:text-6xl">
Start simple, ship quickly.
Expand Down Expand Up @@ -66,20 +67,22 @@ function App() {
</section>

<section class="mt-8 grid gap-4 sm:grid-cols-2 lg:grid-cols-4">
{[
<For each={[
['Type-Safe Routing', 'Routes and links stay in sync across every page.'],
['Server Functions', 'Call server code from your UI without creating API boilerplate.'],
['Streaming by Default', 'Ship progressively rendered responses for faster experiences.'],
['Tailwind Native', 'Design quickly with utility-first styling and reusable tokens.'],
].map(([title, desc], index) => (
]}>
{([title, desc], index) => (
<article
class="island-shell feature-card rise-in rounded-2xl p-5"
style={{ 'animation-delay': `${index * 90 + 80}ms` }}
style={{ 'animation-delay': `${index() * 90 + 80}ms` }}
>
<h2 class="mb-2 text-base font-semibold text-[var(--sea-ink)]">{title}</h2>
<p class="m-0 text-sm text-[var(--sea-ink-soft)]">{desc}</p>
</article>
))}
)}
</For>
</section>

<section class="island-shell mt-8 rounded-2xl p-6">
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
{
"$schema": "https://biomejs.dev/schemas/2.4.5/schema.json",
"$schema": "https://biomejs.dev/schemas/<%= addOnOption?.biome?.preset === 'ultracite' ? '2.6.7' : '2.4.5' %>/schema.json",
<% if (addOnOption?.biome?.preset === 'ultracite') { %>"extends": ["ultracite/biome/core", "ultracite/biome/solid"],
"overrides": [{"includes": ["**/src/components/**"], "linter": {"rules": {"style": {"useFilenamingConvention": {"level": "error", "options": {"filenameCases": ["PascalCase", "kebab-case"]}}}}}}],<% } %>
"vcs": {
"enabled": false,
"clientKind": "git",
Expand Down
20 changes: 19 additions & 1 deletion packages/create/src/frameworks/solid/toolchains/biome/info.json
Original file line number Diff line number Diff line change
Expand Up @@ -7,5 +7,23 @@
"exclusive": ["linter"],
"color": "#60A5FA",
"modes": ["code-router", "file-router"],
"link": "https://biomejs.dev"
"link": "https://biomejs.dev",
"options": {
"preset": {
"type": "select",
"label": "Biome preset",
"description": "Ultracite requires Node ^22.22.2 or >=24.15.0 for development tools.",
"default": "recommended",
"options": [
{
"value": "recommended",
"label": "Recommended"
},
{
"value": "ultracite",
"label": "Ultracite (Node ^22.22.2 or >=24.15.0)"
}
]
}
}
}
10 changes: 0 additions & 10 deletions packages/create/src/frameworks/solid/toolchains/biome/package.json

This file was deleted.

Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
{
"scripts": {
"format": "biome format",
"lint": "biome lint",
"check": "biome check"
},
"devDependencies": {
<% if (addOnOption?.biome?.preset === 'ultracite') { %>"ultracite": "8.3.1",<% } %>
"@biomejs/biome": "<%= addOnOption?.biome?.preset === 'ultracite' ? '2.6.7' : '2.4.5' %>"
}
}
Loading
Loading