Skip to content

docs: add Cloudflare Workers handlers section to server entry point - #6488

Merged
schiller-manuel merged 3 commits into
TanStack:mainfrom
alexander-zuev:docs/cloudflare-workers-handlers
Feb 5, 2026
Merged

docs: add Cloudflare Workers handlers section to server entry point#6488
schiller-manuel merged 3 commits into
TanStack:mainfrom
alexander-zuev:docs/cloudflare-workers-handlers

Conversation

@alexander-zuev

@alexander-zuevalexander-zuev commented Jan 24, 2026

Copy link
Copy Markdown
Contributor

Closes#6487

Adds documentation showing that createServerEntry() returns a spreadable object, enabling server.ts to serve as a full Cloudflare Worker entrypoint
with:

  • SSR + Server Functions (fetch)
  • Queue Consumer + Producer
  • Cron Jobs (scheduled)
  • Other Workers features (Durable Objects, etc.)

Tested and working in locally.

Summary by CodeRabbit

  • Documentation
    • Added Cloudflare Workers guidance: two new sections showing how to extend the server entry point and server configuration to support Workers features (queues, scheduled events, Durable Objects) with examples and a link to Cloudflare Workers docs for further reference.

@github-actionsgithub-actionsBot added the documentation Everything documentation related label Jan 24, 2026
@coderabbitai

coderabbitaiBot commented Jan 24, 2026

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

Adds Cloudflare Workers guidance to the Server Entry Point docs: two new subsections describe extending server.ts / createServerEntry() to support queue, scheduled, Durable Objects, and link to the Cloudflare Workers TanStack Start docs; includes local testing note for scheduled handlers.

Changes

Cohort / File(s)Summary
Documentation: Cloudflare Workers extension
docs/start/framework/react/guide/server-entry-point.md
Added two Cloudflare Workers subsections (under Server Entry Point and Server Configuration) explaining how createServerEntry() can be spread/extended to add queue, scheduled, Durable Object exports; includes example code and local testing curl note; ~+26/+4 lines.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Suggested reviewers

  • schiller-manuel
  • tannerlinsley

Poem

🐰✨ I hopped into docs with a cheerful wink,
Spread server entries quicker than you think,
Fetch, queue, and cron all in a row,
Durable friends ready — let's watch them go! 🥕

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check nameStatusExplanation
Description Check✅ PassedCheck skipped - CodeRabbit’s high-level summary is enabled.
Title check✅ PassedThe title accurately describes the main change: adding Cloudflare Workers handlers documentation to the server entry point guide.
Linked Issues check✅ PassedThe PR adds Cloudflare Workers sections showing how to extend server.ts with queue, scheduled handlers, and Durable Objects, fulfilling issue #6487 objectives.
Out of Scope Changes check✅ PassedAll changes are scoped to the server entry point documentation, directly addressing the linked issue requirements with no unrelated modifications.
Docstring Coverage✅ PassedNo 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.

✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment

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.

@MattieTK

Copy link
Copy Markdown

@alexander-zuev We've now improved our docs on the TanStack Start documentation page on the Cloudflare Workers docs page if you want to point to that.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@alexander-zuev

Copy link
Copy Markdown
ContributorAuthor

nice, @MattieTK added this one liner to the PR:
For a comprehensive guide covering Durable Objects, Workflows, Service Bindings, and other Cloudflare-specific features, see the Cloudflare Workers documentation for TanStack Start.

@schiller-manuel

Copy link
Copy Markdown
Collaborator

i think we can reduce this to just the link to the cloudflare docs

@CanRau

CanRau commented Feb 2, 2026

Copy link
Copy Markdown
Contributor

@MattieTK amazing to have more in-depths guides 🙏
looks still a little outdated tho I think?
createServerFn still uses .validator instead of .inputValidatordocs
And main in the custom entrypoint example should point to src/server.ts instead of app/server.ts I think 🤔

@alexander-zuev

Copy link
Copy Markdown
ContributorAuthor

reduced to 2 lines @schiller-manuel

@schiller-manuel
schiller-manuel merged commit 172fa05 into TanStack:mainFeb 5, 2026
2 checks passed
Sheraff pushed a commit that referenced this pull request Feb 15, 2026
…6488)
* docs: add Cloudflare Workers handlers section to server entry point
* docs: append link to official Cloudflare Workers docs
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
* docs: reduce to link per reviewer feedback
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationEverything documentation related

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs: Clarify server entry point can be extended with Cloudflare queue/scheduled handlers

4 participants

@alexander-zuev@MattieTK@schiller-manuel@CanRau