Skip to content

Conversation

@TadejPolajnar
Copy link

@TadejPolajnar TadejPolajnar commented Jan 24, 2026

PR updates the Paraglide example documentation to clarify server entrypoint requirements for edge runtime deployments.

Changes:

  • Added explanatory note about when server.ts needs to be updated for edge runtimes
  • Documented that paraglideMiddleware prevents locale redirect bugs (e.g., /de/en)

Issue was also mention here, but never properly documented. #6268

Summary by CodeRabbit

  • Documentation
    • Added guidance requiring a custom server entry point for correct locale detection and server-side rendering behavior, with notes for edge runtimes.
    • Clarified Cloudflare Workers support and configuration considerations for custom server setups.
    • Retained existing edge-runtime deployment, Vite integration, and URL rewrite guidance for locale handling.

✏️ Tip: You can customize this high-level summary in your review settings.

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 24, 2026

📝 Walkthrough

Walkthrough

Adds documentation clarifications and instructions for configuring a custom server entry point and edge-runtime deployment (Cloudflare Workers) for the Paraglide React i18n example, plus README notes emphasizing that a custom server.ts is required for locale detection and SSR context.

Changes

Cohort / File(s) Summary
Example README
examples/react/start-i18n-paraglide/README.md
Added notes that a custom server.ts entry point is required for Paraglide to function (locale detection, SSR context), mentioned Cloudflare Workers support, and linked Server Entry Point docs; notes placed after code snippets and middleware example.
Server entry docs
docs/start/framework/react/guide/server-entry-point.md
New section "Configuring the Server Entry Point" with guidance for edge runtimes (e.g., Cloudflare Workers), instructing to set "main": "./src/server.ts" in wrangler.jsonc and explaining enabling custom middleware/authentication/server-side logic.

Sequence Diagram(s)

(omitted — changes are documentation-only and do not introduce new runtime control flow)

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Suggested labels

documentation

Poem

🐰 I hopped through README lines so neat,
Tucked a server.ts where runtimes meet,
Cloudflare breezes, locales in tune,
Paraglide sings beneath the moon 🌙

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title directly matches the PR's main objective: clarifying server.ts entrypoint documentation for edge runtimes, which is reflected in both the README note additions and the new server-entry-point.md documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Fix all issues with AI agents
In `@examples/react/start-i18n-paraglide/README.md`:
- Around line 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.

@TadejPolajnar TadejPolajnar force-pushed the docs/paraglide-server-entrypoint branch from 76ed3b0 to c8e3fdf Compare January 25, 2026 04:38
@github-actions github-actions bot added the documentation Everything documentation related label Jan 25, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Everything documentation related

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants