mirror of
https://github.com/prdlk/dotfiles.git
synced 2026-11-02 19:32:43 +00:00
Prad Nukala
6406208b35
- 16 cross-shell utilities converted to sh/bash chezmoi executables: ai c2p cp-appid extract_agents fab gdc gh-sonr-org-migrate ghg-clone ghn gho git-summary launch_omp_livediff_overlay lc-elir mdcp mdp pj (ghg-clone not named ghg: unrelated cargo binary owns that name) - cwd/history helpers stay per-shell: yy c cd clip-last + ghg/ghn/gho cd-wrappers in bash/functions/ and zsh/functions/, loaded by rc files - fish keeps only shell-state functions; converted ones now hit PATH - cp-appid ignore gating moved to .local/bin path - dot_agents/skills: 82 skills materialized from dotstate storage so dot_claude skill symlinks resolve on fresh bootstrap; dotstate profile/symlinks.json released .agents/skills .bashrc .zshrc
69 lines
2.5 KiB
Markdown
69 lines
2.5 KiB
Markdown
---
|
|
name: tanstack-integration-best-practices
|
|
description: Best practices for integrating TanStack Query with TanStack Router and TanStack Start. Patterns for full-stack data flow, SSR, and caching coordination.
|
|
---
|
|
|
|
# TanStack Integration Best Practices
|
|
|
|
Guidelines for integrating TanStack Query, Router, and Start together effectively. These patterns ensure optimal data flow, caching coordination, and type safety across the stack.
|
|
|
|
## When to Apply
|
|
|
|
- Setting up a new TanStack Start project
|
|
- Integrating TanStack Query with TanStack Router
|
|
- Configuring SSR with query hydration
|
|
- Coordinating caching between router and query
|
|
- Setting up type-safe data fetching patterns
|
|
|
|
## Rule Categories by Priority
|
|
|
|
| Priority | Category | Rules | Impact |
|
|
|----------|----------|-------|--------|
|
|
| CRITICAL | Setup | 3 rules | Foundational configuration |
|
|
| CRITICAL | SSR Integration | 1 rule | Router + Query SSR setup |
|
|
| HIGH | Data Flow | 4 rules | Correct data fetching patterns |
|
|
| MEDIUM | Caching | 3 rules | Performance optimization |
|
|
| MEDIUM | SSR | 2 rules | Additional SSR patterns |
|
|
|
|
## Quick Reference
|
|
|
|
### Setup (Prefix: `setup-`)
|
|
|
|
- `setup-query-client-context` — Pass QueryClient through router context
|
|
- `setup-provider-wrapping` — Correctly wrap with QueryClientProvider
|
|
- `setup-stale-time-coordination` — Coordinate staleTime between router and query
|
|
|
|
### Data Flow (Prefix: `flow-`)
|
|
|
|
- `flow-loader-query-pattern` — Use loaders with ensureQueryData
|
|
- `flow-suspense-query-component` — Use useSuspenseQuery in components
|
|
- `flow-mutations-invalidation` — Coordinate mutations with query invalidation
|
|
- `flow-server-functions-queries` — Use server functions for query functions
|
|
|
|
### Caching (Prefix: `cache-`)
|
|
|
|
- `cache-single-source` — Let TanStack Query manage caching
|
|
- `cache-preload-coordination` — Coordinate preloading between router and query
|
|
- `cache-invalidation-patterns` — Unified invalidation patterns
|
|
|
|
### SSR Integration (Prefix: `ssr-`)
|
|
|
|
- `ssr-dehydrate-hydrate` — Use setupRouterSsrQueryIntegration for automatic SSR
|
|
|
|
### Additional SSR (Prefix: `ssr-`)
|
|
|
|
- `ssr-per-request-client` — Create QueryClient per request
|
|
- `ssr-streaming-queries` — Handle streaming with queries
|
|
|
|
## How to Use
|
|
|
|
Each rule file in the `rules/` directory contains:
|
|
1. **Explanation** — Why this pattern matters
|
|
2. **Bad Example** — Anti-pattern to avoid
|
|
3. **Good Example** — Recommended implementation
|
|
4. **Context** — When to apply or skip this rule
|
|
|
|
## Full Reference
|
|
|
|
See individual rule files in `rules/` directory for detailed guidance and code examples.
|