Question 1

How do I create an API route in TanStack Start?

Accepted Answer

Create a file under src/routes/api and export a Route using createFileRoute with a server.handlers object containing GET, POST, or other HTTP method functions. Each handler receives { request, params } and returns a Web Response object.

Question 2

How do I add dynamic route parameters in TanStack Start API routes?

Accepted Answer

Use a $ prefix in the file name, such as src/routes/api/items.$id.ts, which maps to /api/items/:id. The parameter is available in the handler as params.id, and the createFileRoute string must be "/api/items/$id".

Question 3

How do I access Cloudflare D1 or R2 bindings in a TanStack Start route?

Accepted Answer

Import env directly from the cloudflare:workers module at the top of the route file, then call env.DB.prepare(...) or env.STORAGE.get(...) inside handlers. Do not use process.env or pass env as a function argument.

Question 4

How do I validate request bodies in a TanStack Start API route?

Accepted Answer

Parse the JSON body inside a try/catch, then validate it with a zod schema using safeParse, returning a 400 Response on failure. For data matching a database table, use drizzle-zod's createInsertSchema to derive the schema from the Drizzle table definition.

Question 5

Why does createServerFileRoute not work in TanStack Start?

Accepted Answer

createServerFileRoute is an outdated API from earlier TanStack Start versions. Current versions use createFileRoute with a server.handlers configuration object, and pure API routes should not export a component.

new-api-route

SYSTEM DOCUMENTATION & REQUIREMENTS

Frequently Asked Questions about new-api-route

Related Skills

vite-flare-starter

tanstack-start-cloudflare

secure-nextjs-api-routes

frontend-feature