React Query

Cursor-Regel für React Query — Konventionen für Server-State, Caching und Datenabfragen in React.

Original-Beschreibung der Autoren: Cursor rules for React development with React Query integration.

Die Regel

---
description: "Cursor rules for React development with React Query integration."
globs: **/*
alwaysApply: false
---
// React + React Query .cursorrules

// Prefer functional components with hooks

const preferFunctionalComponents = true;

// React Query best practices

const reactQueryBestPractices = [
  "Use QueryClient and QueryClientProvider at the root of your app",
  "Implement custom hooks for queries and mutations",
  "Utilize query keys for effective caching",
  "Use prefetching for improved performance",
  "Implement proper error and loading states",
];

// Folder structure

const folderStructure = `
src/
  components/
  hooks/
    useQueries/
    useMutations/
  pages/
  utils/
  api/
`;

// Additional instructions

const additionalInstructions = `
1. Use TypeScript for type safety with React Query
2. Implement proper error boundaries for query errors
3. Utilize React Query DevTools for debugging
4. Use stale-while-revalidate strategy for data freshness
5. Implement optimistic updates for mutations
6. Use query invalidation for data refetching
7. Follow React Query naming conventions for consistency
`;

So nutzt du sie

Die Regel kopieren (Button oben) oder als Datei herunterladen und im Projekt unter .cursor/rules/ ablegen — Cursor lädt sie beim nächsten Start automatisch. Ältere Cursor-Versionen lesen alternativ eine einzelne .cursorrules-Datei im Projektstamm; dort einfach den Regel-Text ohne den Kopfblock zwischen den ----Zeilen einfügen.

Der Regel-Text ist englisch — Cursor versteht ihn unabhängig von der Sprache, in der Sie mit dem Editor chatten.

Im Detail

Gibt Cursor Vorgaben für den Einsatz von React Query mit: wie Queries und Mutations strukturiert, Query-Keys benannt und Caching-Strategien angewendet werden sollen. Praktisch für Projekte, die Server-State sauber von lokalem UI-State trennen wollen, statt mit useEffect/useState eigene Fetch-Logik nachzubauen. Zu beachten: React Query heißt inzwischen TanStack Query — bei neueren Projekten lohnt ein Blick, ob die Regel noch zur installierten Version passt, sonst schlägt Cursor veraltete APIs vor. Für einfache Projekte mit wenig Server-State kann der Aufwand allerdings unnötig sein.

Praxis-Tipp

Vor dem Einsatz im package.json prüfen, welche React-Query-Version installiert ist, und die Regel bei Bedarf auf v4/v5-Syntax anpassen.

Lizenz & Quelle

• Lizenz: CC0 1.0
• Quelle: PatrickJS/awesome-cursorrules (GitHub)

Lade …