+ Coastal field notes
+
+ The last light catches the headland before the tide turns.
+
+ )
+}
diff --git a/examples/react/start-images-fonts/src/styles.css b/examples/react/start-images-fonts/src/styles.css
new file mode 100644
index 0000000000..39d58551fd
--- /dev/null
+++ b/examples/react/start-images-fonts/src/styles.css
@@ -0,0 +1,38 @@
+@font-face {
+ font-family: 'Inter';
+ src: url('@fontsource-variable/inter/files/inter-latin-wght-normal.woff2')
+ format('woff2');
+ font-style: normal;
+ font-weight: 100 900;
+ font-display: optional;
+}
+* {
+ box-sizing: border-box;
+}
+body {
+ margin: 0;
+ background: #f7f4ec;
+ color: #193347;
+ font-family: 'Inter', system-ui, sans-serif;
+}
+main {
+ width: min(960px, calc(100% - 32px));
+ margin: 48px auto;
+}
+h1 {
+ font-size: clamp(2rem, 5vw, 3.5rem);
+ line-height: 1.1;
+ font-weight: 650;
+ letter-spacing: -0.04em;
+}
+img {
+ display: block;
+ width: 100%;
+ height: auto;
+ border-radius: 8px;
+}
+p {
+ font-size: 1.125rem;
+ line-height: 1.6;
+ max-width: 40rem;
+}
diff --git a/examples/react/start-images-fonts/tests/assets.spec.ts b/examples/react/start-images-fonts/tests/assets.spec.ts
new file mode 100644
index 0000000000..0bdd5af170
--- /dev/null
+++ b/examples/react/start-images-fonts/tests/assets.spec.ts
@@ -0,0 +1,77 @@
+import { expect, test } from '@playwright/test'
+import sharp from 'sharp'
+
+for (const [width, deviceScaleFactor, candidate] of [
+ [390, 1, 480],
+ [390, 2, 960],
+ [1280, 1, 960],
+ [1280, 2, 1600],
+]) {
+ test(`image at ${width}px and ${deviceScaleFactor}x`, async ({ browser }) => {
+ const context = await browser.newContext({
+ viewport: { width, height: 900 },
+ deviceScaleFactor,
+ })
+ const page = await context.newPage()
+ const response = await page.goto('http://127.0.0.1:3130')
+ expect(response?.status()).toBe(200)
+ expect(await response!.text()).toMatch(/srcset=/i)
+ const image = page.getByRole('img')
+ await expect(image).toHaveJSProperty('complete', true)
+ const selected = await image.evaluate((element) => {
+ if (!(element instanceof HTMLImageElement)) {
+ throw new Error('Expected an image')
+ }
+ return element.currentSrc
+ })
+ expect(selected).toContain(`coast-${candidate}`)
+ const downloaded = await page.request.get(selected)
+ expect(downloaded.ok()).toBe(true)
+ const metadata = await sharp(await downloaded.body()).metadata()
+ expect(metadata.width).toBe(candidate)
+ expect(metadata.height).toBe((candidate * 9) / 16)
+ const size = await image.boundingBox()
+ expect(size?.width).toBe(Math.min(960, width - 32))
+ expect(size!.height / size!.width).toBeCloseTo(9 / 16, 2)
+ await context.close()
+ })
+}
+
+test('image dimensions survive failed downloads and fallback text stays visible', async ({
+ page,
+}) => {
+ await page.route('**/*.webp*', (route) => route.abort())
+ await page.route('**/*.woff2*', (route) => route.abort())
+ await page.goto('/')
+ await expect(
+ page.getByRole('heading', { name: 'Coastal field notes' }),
+ ).toBeVisible()
+ const size = await page.getByRole('img').boundingBox()
+ expect(size!.height / size!.width).toBeCloseTo(9 / 16, 2)
+})
+
+test('one same-origin font supplies the used weights', async ({ page }) => {
+ const fontResponses: string[] = []
+ const externalRequests: string[] = []
+ page.on('request', (request) => {
+ if (!request.url().startsWith('http://127.0.0.1:3130/')) {
+ externalRequests.push(request.url())
+ }
+ })
+ page.on('response', (response) => {
+ if (response.url().includes('.woff2')) {
+ fontResponses.push(response.url())
+ }
+ })
+ await page.goto('/')
+ await page.evaluate(() => document.fonts.ready)
+ expect(
+ await page.evaluate(() => document.fonts.check('650 24px Inter')),
+ ).toBe(true)
+ expect(fontResponses).toHaveLength(1)
+ expect(externalRequests).toEqual([])
+ const preload = page.locator('link[as="font"]')
+ const href = await preload.getAttribute('href')
+ expect(new URL(href!, page.url()).href).toBe(fontResponses[0])
+ await expect(preload).toHaveAttribute('crossorigin', 'anonymous')
+})
diff --git a/examples/react/start-images-fonts/tsconfig.json b/examples/react/start-images-fonts/tsconfig.json
new file mode 100644
index 0000000000..cc479423a1
--- /dev/null
+++ b/examples/react/start-images-fonts/tsconfig.json
@@ -0,0 +1,21 @@
+{
+ "include": ["**/*.ts", "**/*.tsx", "**/*.d.ts"],
+ "compilerOptions": {
+ "strict": true,
+ "esModuleInterop": true,
+ "jsx": "react-jsx",
+ "module": "ESNext",
+ "moduleResolution": "Bundler",
+ "lib": ["DOM", "DOM.Iterable", "ES2024"],
+ "isolatedModules": true,
+ "resolveJsonModule": true,
+ "skipLibCheck": true,
+ "target": "ES2024",
+ "allowJs": true,
+ "forceConsistentCasingInFileNames": true,
+ "paths": {
+ "~/*": ["./src/*"]
+ },
+ "noEmit": true
+ }
+}
diff --git a/examples/react/start-images-fonts/vite.config.ts b/examples/react/start-images-fonts/vite.config.ts
new file mode 100644
index 0000000000..6a09769f5d
--- /dev/null
+++ b/examples/react/start-images-fonts/vite.config.ts
@@ -0,0 +1,8 @@
+import { tanstackStart } from '@tanstack/react-start/plugin/vite'
+import { defineConfig } from 'vite'
+import viteReact from '@vitejs/plugin-react'
+import { nitro } from 'nitro/vite'
+export default defineConfig({
+ build: { assetsInlineLimit: 0 },
+ plugins: [tanstackStart(), viteReact(), nitro()],
+})
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 08b44bf2db..cf4dccd323 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -15628,6 +15628,55 @@ importers:
specifier: ^8.0.14
version: 8.0.14(@types/node@25.0.9)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.97.2)(terser@5.51.2)(tsx@4.20.3)(yaml@2.9.0)
+ examples/react/start-images-fonts:
+ dependencies:
+ '@fontsource-variable/inter':
+ specifier: 5.3.0
+ version: 5.3.0
+ '@tanstack/react-router':
+ specifier: workspace:*
+ version: link:../../../packages/react-router
+ '@tanstack/react-start':
+ specifier: workspace:*
+ version: link:../../../packages/react-start
+ react:
+ specifier: ^19.2.3
+ version: 19.2.3
+ react-dom:
+ specifier: ^19.2.3
+ version: 19.2.3(react@19.2.3)
+ devDependencies:
+ '@playwright/test':
+ specifier: ^1.61.0
+ version: 1.61.1
+ '@types/node':
+ specifier: 25.0.9
+ version: 25.0.9
+ '@types/react':
+ specifier: ^19.2.8
+ version: 19.2.9
+ '@types/react-dom':
+ specifier: ^19.2.3
+ version: 19.2.3(@types/react@19.2.9)
+ '@typescript/native':
+ specifier: npm:typescript@^7.0.2
+ version: typescript@7.0.2
+ '@vitejs/plugin-react':
+ specifier: ^6.0.1
+ version: 6.0.1(@rolldown/plugin-babel@0.2.3(@babel/core@7.29.7(supports-color@10.2.2))(rolldown@1.0.2)(vite@8.0.14(@types/node@25.0.9)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.97.2)(terser@5.51.2)(tsx@4.20.3)(yaml@2.9.0)))(babel-plugin-react-compiler@1.0.0)(vite@8.0.14(@types/node@25.0.9)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.97.2)(terser@5.51.2)(tsx@4.20.3)(yaml@2.9.0))
+ nitro:
+ specifier: ^3.0.260311-beta
+ version: 3.0.260311-beta(@electric-sql/pglite@0.3.2)(@emnapi/core@1.11.3)(@emnapi/runtime@1.11.3)(@libsql/client@0.15.15)(@netlify/blobs@10.1.0)(chokidar@5.0.0)(dotenv@17.4.2)(giget@2.0.0)(ioredis@5.11.1(supports-color@10.2.2))(jiti@2.7.0)(lru-cache@11.5.1)(miniflare@4.20260317.0)(mysql2@3.15.3)(rollup@4.63.1)(vite@8.0.14(@types/node@25.0.9)(esbuild@0.27.4)(jiti@2.7.0)(sass@1.97.2)(terser@5.37.0)(tsx@4.20.3)(yaml@2.9.0))
+ sharp:
+ specifier: 0.35.4
+ version: 0.35.4(@types/node@25.0.9)
+ typescript:
+ specifier: npm:@typescript/typescript6@^6.0.2
+ version: '@typescript/typescript6@6.0.2'
+ vite:
+ specifier: ^8.0.14
+ version: 8.0.14(@types/node@25.0.9)(esbuild@0.28.2)(jiti@2.7.0)(sass@1.97.2)(terser@5.51.2)(tsx@4.20.3)(yaml@2.9.0)
+
packages:
'@adobe/css-tools@4.4.1':
@@ -29787,6 +29836,9 @@ packages:
cpu: [x64]
os: [win32]
+ '@fontsource-variable/inter@5.3.0':
+ resolution: {integrity: sha512-OupL48va4JNofb97w6NYeF9S7W/kHNKM0Er8Dem5nqi4jeOLrVJDoE8tZEpnMJmtkvNbB1EIPPwHcdkF6b1oUA==}
+
snapshots:
'@adobe/css-tools@4.4.1': {}
@@ -46057,3 +46109,5 @@ snapshots:
- mysql2
- sqlite3
- uploadthing
+
+ '@fontsource-variable/inter@5.3.0': {}