mirror of
https://github.com/prdlk/dotfiles.git
synced 2026-11-06 04:27:40 +00:00
shell: fish functions -> ~/.local/bin executables + bash/zsh ports; manage ~/.agents
- 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
This commit is contained in:
1 parent
6776366ce6
commit
6406208b35
637 files changed
+100297
-497
No files matched your search
@@ -0,0 +1,68 @@
|
||||
---
|
||||
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.
|
||||
Reference in new issue
Block a user