Skip to content

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

Merged
schiller-manuel merged 3 commits intoTanStack: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 intoTanStack:mainfrom
alexander-zuev:docs/cloudflare-workers-handlers

Conversation

@alexander-zuev
Copy link
Contributor

@alexander-zuev alexander-zuev commented Jan 24, 2026

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-actions github-actions bot added the documentation Everything documentation related label Jan 24, 2026
@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 24, 2026

📝 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 name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: adding Cloudflare Workers handlers documentation to the server entry point guide.
Linked Issues check ✅ Passed The 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 ✅ Passed All changes are scoped to the server entry point documentation, directly addressing the linked issue requirements with no unrelated modifications.
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.

✨ 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

@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
Contributor Author

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
Contributor

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

@CanRau
Copy link
Contributor

CanRau commented Feb 2, 2026

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

@alexander-zuev
Copy link
Contributor Author

reduced to 2 lines @schiller-manuel

@schiller-manuel schiller-manuel merged commit 172fa05 into TanStack:main Feb 5, 2026
2 checks passed
naoya7076 pushed a commit to naoya7076/router that referenced this pull request Feb 15, 2026
…anStack#6488)

* docs: add Cloudflare Workers handlers section to server entry point

* docs: append link to official Cloudflare Workers docs


* docs: reduce to link per reviewer feedback

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
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 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.

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

4 participants