mirror of
https://github.com/prdlk/dotfiles.git
synced 2026-11-03 19:37:52 +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
81 lines
2.5 KiB
Markdown
81 lines
2.5 KiB
Markdown
# cache-stale-time: Set Appropriate staleTime Based on Data Volatility
|
|
|
|
## Priority: CRITICAL
|
|
|
|
## Explanation
|
|
|
|
`staleTime` determines how long data is considered fresh. The default is 0ms, meaning data is immediately stale and will refetch on every new query mount. Set appropriate staleTime based on how often your data actually changes to reduce unnecessary network requests.
|
|
|
|
## Bad Example
|
|
|
|
```tsx
|
|
// Default staleTime of 0 - refetches on every component mount
|
|
const { data } = useQuery({
|
|
queryKey: ['user-profile', userId],
|
|
queryFn: () => fetchUserProfile(userId),
|
|
// No staleTime set - always considered stale
|
|
})
|
|
|
|
// User profile probably doesn't change every second
|
|
// This causes unnecessary API calls on navigation
|
|
|
|
// Setting same staleTime everywhere regardless of data type
|
|
const queryClient = new QueryClient({
|
|
defaultOptions: {
|
|
queries: {
|
|
staleTime: 60 * 1000, // 1 minute for everything - too simple
|
|
},
|
|
},
|
|
})
|
|
```
|
|
|
|
## Good Example
|
|
|
|
```tsx
|
|
// Match staleTime to data volatility
|
|
const { data: profile } = useQuery({
|
|
queryKey: ['user-profile', userId],
|
|
queryFn: () => fetchUserProfile(userId),
|
|
staleTime: 5 * 60 * 1000, // 5 minutes - profile rarely changes
|
|
})
|
|
|
|
const { data: notifications } = useQuery({
|
|
queryKey: ['notifications'],
|
|
queryFn: fetchNotifications,
|
|
staleTime: 30 * 1000, // 30 seconds - changes more frequently
|
|
})
|
|
|
|
const { data: stockPrice } = useQuery({
|
|
queryKey: ['stock', symbol],
|
|
queryFn: () => fetchStockPrice(symbol),
|
|
staleTime: 0, // Real-time data - always refetch
|
|
})
|
|
|
|
// Set sensible defaults, override per-query
|
|
const queryClient = new QueryClient({
|
|
defaultOptions: {
|
|
queries: {
|
|
staleTime: 60 * 1000, // 1 minute default
|
|
},
|
|
},
|
|
})
|
|
```
|
|
|
|
## Recommended staleTime Values
|
|
|
|
| Data Type | staleTime | Rationale |
|
|
|-----------|-----------|-----------|
|
|
| Real-time (stocks, live feeds) | 0 | Must always be current |
|
|
| Frequently changing (notifications) | 30s - 1min | Balance freshness and requests |
|
|
| User-generated content | 1 - 5min | Changes on user action |
|
|
| Reference data (categories, config) | 10 - 30min | Rarely changes |
|
|
| Static content | Infinity | Never changes |
|
|
|
|
## Context
|
|
|
|
- `staleTime: 0` (default) triggers background refetch on every mount
|
|
- `staleTime: Infinity` never considers data stale (manual invalidation only)
|
|
- Stale data is still returned instantly - refetch happens in background
|
|
- For SSR, set higher staleTime to avoid immediate client refetch
|
|
- Consider using `queryOptions` factory to centralize staleTime per data type
|