chore(site): update react docs

[NathanFlurry]

Changes

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
rivet-site	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Jul 27, 2025 7:48pm

[graphite-app]

Merge activity

• Jul 27, 7:46 PM UTC: NathanFlurry added this pull request to the Graphite merge queue.
• Jul 27, 7:47 PM UTC: CI is running for this pull request on a draft pull request (#2807) due to your merge queue CI optimization settings.
• Jul 27, 7:48 PM UTC: Merged by the Graphite merge queue via draft PR: #2807.

[NathanFlurry]

• chore(site): update react docs #2806 👈 (View in Graphite)
• main

---

How to use the Graphite Merge Queue

Add the label merge-queue to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

[claude]

Claude finished @NathanFlurry's task —— View job

---

PR Review: chore(site): update react docs

Review Progress:

• Read and analyze all changed files
• Review site/public/llms-full.txt changes
• Review site/src/content/docs/actors/quickstart/react.mdx changes
• Review site/src/content/docs/clients/react.mdx changes
• Evaluate code quality and best practices
• Check for potential issues or improvements
• Provide final review feedback

Summary of Changes:

This PR significantly simplifies the React documentation by removing ~300 lines of advanced content and focusing on essential quickstart information.

Files Changed:

• site/public/llms-full.txt: Minor updates to comments and removed redundant client setup section
• site/src/content/docs/actors/quickstart/react.mdx: Added auth skip configuration and server setup comment
• site/src/content/docs/clients/react.mdx: Major simplification - removed advanced sections (Authentication, Error Handling, Custom Hooks, Environment Config, Best Practices)

Review Feedback

✅ Positive Aspects:

1. Improved Clarity: The simplified documentation focuses on core functionality, making it easier for new users to get started
2. Better Code Examples: Added helpful file path titles (e.g., {{"title":"backend/registry.ts"}}) improve code organization
3. Consistent Auth Handling: Adding onAuth: () => {} with explanatory comments provides a clear path forward for authentication setup
4. Enhanced Server Setup: The new "Setup Backend Server" step in /clients/react.mdx fills an important gap

⚠️ Areas of Concern:

1. Missing Critical Content: The removal of advanced sections may leave users without guidance on:

   • Authentication implementation (removed entire section)
   • Error handling patterns (removed entire section)
   • Environment configuration for production (removed entire section)
   • Best practices for React integration (removed entire section)

2. Documentation Gap: Users transitioning from quickstart to production will need to find this information elsewhere. Consider:

   • Moving advanced content to separate guides rather than removing entirely
   • Adding clear references to where users can find authentication, error handling, etc.

3. Inconsistent Documentation: The site/public/llms-full.txt still contains some of the removed content, creating potential confusion between documentation sources

🔧 Specific Issues:

1. Line 3837 in llms-full.txt: The server setup code shows registry.runServer(config.rivetkit); but the quickstart examples just use registry.runServer(); - this inconsistency could confuse users about configuration requirements

2. Missing Context: The removal of the "Build real-time React applications with Rivet Actors" subtitle removes helpful context about the library's purpose

💡 Recommendations:

1. Consider a Hybrid Approach: Instead of removing advanced sections entirely, consider:

   • Moving them to a "Advanced React Patterns" guide
   • Keeping condensed versions with links to full examples
   • Adding a "Next Steps" section with links to advanced topics

2. Add Navigation: Include clear pointers to where users should go after completing the basic setup

3. Documentation Consistency: Ensure llms-full.txt stays in sync with the main documentation files

📊 Technical Assessment:

• Code Quality: ✅ Good (clean examples, proper TypeScript usage)
• Security: ✅ Good (auth skip is clearly marked as temporary)
• Performance: N/A (documentation only)
• Test Coverage: N/A (no test implications)

Overall Assessment:

This is a reasonable simplification that improves the getting-started experience, but consider preserving the removed advanced content in separate documentation sections rather than deleting it entirely. The changes make the documentation more approachable for newcomers while potentially creating gaps for intermediate users.

---

[cloudflare-workers-and-pages]

Deploying rivet with    Cloudflare Pages

Latest commit:	1051c36
Status:	🚫  Build failed.

View logs