Skip to content

[Workers] Improve TanStack Start Guide #26316

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: production
Choose a base branch
from
Open

[Workers] Improve TanStack Start Guide #26316

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0566859
[Workers] Improve TanStack Start guide
KevinAKoch Nov 5, 2025
3198dbc
Merge branch 'cloudflare:production' into production
RndUsername Nov 5, 2025
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
21 changes: 20 additions & 1 deletion src/content/docs/workers/framework-guides/web-apps/tanstack-start.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@ import {
WranglerConfig,
} from "~/components";

[TanStack Start](https://tanstack.com/start) is a full-stack framework for building web applications. It comes with features like server-side rendering, streaming, server functions, bundling, and more. In this guide, you learn to deploy a TanStack Start application to Cloudflare Workers.
[TanStack Start](https://tanstack.com/start) is a full-stack framework for building web applications. It comes with features like server-side rendering, streaming, server functions, bundling, and more. In this guide, you learn to deploy a TanStack (**React**) Start application to Cloudflare Workers. If you would like to deploy a TanStack Start application with **Solid** instead, you can take a look at TanStack's official [example](https://tanstack.com/start/latest/docs/framework/solid/examples/start-basic-cloudflare).

## 1. Set up a TanStack Start project

Expand Down Expand Up @@ -118,6 +118,25 @@ This can help you making sure that your application will work as intended once i

---

## Custom Worker-Entrypoint

If you need to export additional declarations from your worker file, for example class definitions for [Durable Objects](https://developers.cloudflare.com/durable-objects/get-started/#2-write-a-durable-object-class-using-sql-api), you can specify a different file for the `main` property inside the `wrangler.jsonc`:

<WranglerConfig>
```toml
main = "worker-entry.ts"
```
</WranglerConfig>

Export `@tanstack/react-start/server-entry` from the specified file manually. This is also the place where you can export anything else you want:
```ts title="worker-entry.ts"
export { default } from '@tanstack/react-start/server-entry'

export class MyDurableObject extends DurableObject<Env> {
// ...
}
```

## Bindings

Your TanStack Start application can be fully integrated with the Cloudflare Developer Platform, in both local development and in production, by using bindings.
Expand Down