Add a React Start server-components skill

[CodingCossack]

This upstreams the existing TanStack Start RSC skill into the official React Start skills tree.

What changed

• adds the existing server-components skill under packages/react-start/skills/react-start/
• preserves the current skill structure, docs, and examples with only mechanical compatibility changes
• wires the skill into the current React Start intent artifacts

Validation

• npx @tanstack/intent validate packages/react-start/skills
• git diff --check -- packages/react-start/skills

Summary by CodeRabbit

• New Features

  • Added a "Server Components" sub-skill to the React Start skill inventory and skill tree with cross-references.

• Documentation

  • Added comprehensive Server Components docs: architecture, caching/refresh/SSR modes, composite components, current API notes, debugging & review checklist, sources, and failure-mode guidance.

• Examples

  • Added multiple end-to-end examples showcasing renderable routes, composite slots, query-owned RSCs, selective-SSR, browser-owned loaders, and Flight streaming.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

Adds a new "Server Components" sub-skill to React Start: skill metadata, skill-tree entry, comprehensive docs (architecture, caching/SSR, composite components, API notes, debugging, sources), and six runnable examples demonstrating route/query ownership, selective SSR, slots, and Flight streaming.

Changes

Cohort / File(s)	Summary
Skill metadata packages/react-start/skills/_artifacts/domain_map.yaml, packages/react-start/skills/_artifacts/skill_spec.md, packages/react-start/skills/_artifacts/skill_tree.yaml	Register new server-components sub-skill under deployment-and-rendering; add metadata, dependencies, sources, and three documented failure modes.
Skill docs entry packages/react-start/skills/react-start/SKILL.md, packages/react-start/skills/react-start/server-components/SKILL.md	Add cross-reference and primary skill doc describing when to apply the skill, invariants, API normalization, decision flows, pattern chooser, and review checklist.
Core guidance & patterns packages/react-start/skills/react-start/server-components/docs/architecture.md, .../caching-refresh-ssr.md, .../composite-components.md, .../current-api-notes.md	Introduce RSC mental model, cache ownership (router/query/HTTP), refresh/invalidation rules, selective SSR modes, composite-slot semantics, Flight APIs, serialization constraints, and current API conventions (e.g., .inputValidator, structuralSharing: false).
Debugging & sources packages/react-start/skills/react-start/server-components/docs/debugging-review.md, .../sources.md	Add structured debugging/review workflow, failure-stage checks, bundling/import guidance, checklist, and validated source links with observed API drift notes.
Examples (six) packages/react-start/skills/react-start/server-components/examples/01-renderable-route-loader.tsx, .../02-composite-slots.tsx, .../03-query-owned-rsc.tsx, .../04-selective-ssr-data-only.tsx, .../05-ssr-false-browser-loader.tsx, .../06-low-level-flight-api-route.tsx	Add runnable examples covering: route-owned renderable, composite slots (children/render-prop/component-prop), query-owned RSC (with structuralSharing: false), selective SSR (ssr: 'data-only'), browser-owned loader (ssr: false), and low-level Flight streaming API + client consumption.

Sequence Diagram(s)

sequenceDiagram
participant Browser as Browser
participant Router as Router
participant QueryClient as QueryClient
participant ServerFn as Server Function
participant RSC as RSC Runtime
Browser->>Router: Navigate /posts/:id
Router->>QueryClient: ensureQueryData(queryKey)
QueryClient->>ServerFn: invoke getPostRsc (server fn / HTTP)
ServerFn->>RSC: renderServerComponent / createCompositeComponent
RSC-->>ServerFn: Flight src or stream
ServerFn-->>QueryClient: return RSC src (structuralSharing: false)
QueryClient-->>Router: resolved data
Router-->>Browser: serialized loader payload (includes RSC src)
Browser->>RSC: createFromFetch / CompositeComponent render (fill slots)
RSC-->>Browser: rendered UI

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Suggested labels

documentation

Suggested reviewers

• brenelz

Poem

🐰 Hoppity hop, docs in a row,
Server components ready to show.
Slots and streams, cache kept tight,
Examples guide the day and night.
A little rabbit cheers the flow. 🥕✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 8.33% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 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 a new React Start server-components skill to the repository, which aligns with all the file modifications across domain mappings, skill tree, documentation, and examples.

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

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[github-actions]

Bundle Size Benchmarks

• Commit: 16f6892d6b7c
• Measured at: 2026-04-13T23:32:05.540Z
• Baseline source: history:16f6892d6b7c
• Dashboard: bundle-size history

Scenario	Current (gzip)	Delta vs baseline	Raw	Brotli	Trend
react-router.minimal	87.35 KiB	0 B (0.00%)	274.60 KiB	75.97 KiB	▅▅▅▅▁▁▁▁▁▁█
react-router.full	90.60 KiB	0 B (0.00%)	285.67 KiB	78.76 KiB	████▁▁▁▁▁▁▃
solid-router.minimal	35.51 KiB	0 B (0.00%)	106.60 KiB	31.91 KiB	████▁▁▁▁▁▁▃
solid-router.full	39.99 KiB	0 B (0.00%)	120.09 KiB	35.93 KiB	████▁▁▁▁▁▁▆
vue-router.minimal	53.30 KiB	0 B (0.00%)	152.01 KiB	47.88 KiB	████▁▁▁▁▁▁▄
vue-router.full	58.20 KiB	0 B (0.00%)	167.43 KiB	52.06 KiB	████▁▁▁▁▁▁▄
react-start.minimal	101.74 KiB	0 B (0.00%)	322.32 KiB	87.98 KiB	████▁▁▁▁▁▁▆
react-start.full	105.18 KiB	0 B (0.00%)	332.66 KiB	90.97 KiB	████▁▁▁▁▁▁▄
solid-start.minimal	49.52 KiB	0 B (0.00%)	152.41 KiB	43.66 KiB	████▁▁▁▁▁▁▄
solid-start.full	55.04 KiB	0 B (0.00%)	168.61 KiB	48.44 KiB	████▁▁▁▁▁▁▅

Trend sparkline is historical gzip bytes ending with this PR measurement; lower is better.

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.
Inline comments:
In `@packages/react-start/skills/_artifacts/domain_map.yaml`:
- Line 469: The YAML bullet "Selective SSR modes (ssr: 'data-only', ssr: false)"
contains an unquoted colon which makes the scalar invalid; update the bullet
value (the entire string containing "Selective SSR modes (ssr: 'data-only', ssr:
false)") to be a quoted scalar (e.g., wrap the whole item in single or double
quotes) so the colon in "ssr: false" is treated as part of the string and the
YAML parses correctly.

🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

• Push a commit to this branch (recommended)
• Create a new PR with the fixes

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: cd76a75f-45f7-4726-9f94-949149d5fbf3

📥 Commits

Reviewing files that changed from the base of the PR and between f1a4973 and da6ab52.

📒 Files selected for processing (17)

• packages/react-start/skills/_artifacts/domain_map.yaml
• packages/react-start/skills/_artifacts/skill_spec.md
• packages/react-start/skills/_artifacts/skill_tree.yaml
• packages/react-start/skills/react-start/SKILL.md
• packages/react-start/skills/react-start/server-components/SKILL.md
• packages/react-start/skills/react-start/server-components/docs/architecture.md
• packages/react-start/skills/react-start/server-components/docs/caching-refresh-ssr.md
• packages/react-start/skills/react-start/server-components/docs/composite-components.md
• packages/react-start/skills/react-start/server-components/docs/current-api-notes.md
• packages/react-start/skills/react-start/server-components/docs/debugging-review.md
• packages/react-start/skills/react-start/server-components/docs/sources.md
• packages/react-start/skills/react-start/server-components/examples/01-renderable-route-loader.tsx
• packages/react-start/skills/react-start/server-components/examples/02-composite-slots.tsx
• packages/react-start/skills/react-start/server-components/examples/03-query-owned-rsc.tsx
• packages/react-start/skills/react-start/server-components/examples/04-selective-ssr-data-only.tsx
• packages/react-start/skills/react-start/server-components/examples/05-ssr-false-browser-loader.tsx
• packages/react-start/skills/react-start/server-components/examples/06-low-level-flight-api-route.tsx

[nx-cloud]

View your CI Pipeline Execution ↗ for commit df501ca

Command	Status	Duration	Result
nx affected --targets=test:eslint,test:unit,tes...	✅ Succeeded	11m 9s	View ↗
nx run-many --target=build --exclude=examples/*...	✅ Succeeded	22s	View ↗

---

☁️ Nx Cloud last updated this comment at 2026-04-13 23:44:06 UTC

[codspeed-hq]

Merging this PR will not alter performance

✅ 6 untouched benchmarks

---

_{Comparing CodingCossack:codex/upstream-react-start-rsc (df501ca) with main (16f6892)}