Skip to content

docs(examples): clarify server.ts entrypoint updates for edge runtimes #6493

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
TadejPolajnar wants to merge 1 commit into
base: main
Choose a base branch
from
+11 −0
Open

docs(examples): clarify server.ts entrypoint updates for edge runtimes #6493

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
11 changes: 11 additions & 0 deletions examples/react/start-i18n-paraglide/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,17 @@ export default {
}
```

For edge runtime deployments (Cloudflare Workers, Deno, etc.), update your deployment config:

**Cloudflare Workers (`wrangler.toml`):**
```jsonc
{
"main": "./src/server.ts" // Instead of "main": "@tanstack/react-start/
}
```
Comment on lines +91 to +96
Copy link
Contributor

@coderabbitai coderabbitai bot Jan 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

Incorrect file format: wrangler.toml requires TOML syntax, not JSON.

The code block shows JSON syntax, but wrangler.toml is a TOML configuration file. This will cause syntax errors during deployment.

📝 Proposed fix with correct TOML syntax 
-**Cloudflare Workers (`wrangler.toml`):**
-```jsonc
-{
-  "main": "./src/server.ts" // Instead of "main": "@tanstack/react-start/
-}
-```
+**Cloudflare Workers (`wrangler.toml`):**
+```toml
+# Instead of the default TanStack Start server entry
+main = "./src/server.ts"
+```
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
**Cloudflare Workers (`wrangler.toml`):**
```jsonc
{
"main": "./src/server.ts" // Instead of "main": "@tanstack/react-start/
}
```
**Cloudflare Workers (`wrangler.toml`):**
🤖 Prompt for AI Agents 
In `@examples/react/start-i18n-paraglide/README.md` around lines 91 - 96, The
README shows a JSON code block for wrangler.toml which is invalid; replace the
JSON block with a TOML code block and use TOML comment syntax, e.g., change the
block labelled **Cloudflare Workers (`wrangler.toml`)** to use ```toml``` and
set the entry as main = "./src/server.ts" with comments prefixed by # (not //)
so the file is valid TOML for Wrangler.


> **Note**: When using `server.ts`, you need to update the server entrypoint for edge runtimes like Cloudflare Workers, Deno, or other non-Node.js environments. The `paraglideMiddleware` handles locale detection from URLs, server-side rendering context, and prevents locale redirect bugs (e.g., `/de` → `/en`). For standard Node.js deployments, TanStack Start's default handler may work without customization.
Copy link
Contributor

@schiller-manuel schiller-manuel Jan 24, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no the default entry point never works with paraglide. you always need server.ts entry point. we should just link to the server entry point doc page and there explain how to use it in cloudflare


In `__root.tsx` change the html lang attribute to the current locale.

```tsx
Expand Down