101-react-patterns

A set of conventions for React components and JSX or TSX code, including component structure, state management, performance, errors, and accessibility. JSX and TSX are the syntax commonly used to describe React interfaces.

In plain words
What is it for?
Use it when creating functional components, choosing local, server, global, or URL state, loading large components, handling errors and empty states, and adding accessible markup.
Why use it?
It helps teams make consistent choices about where state and logic belong, how async screens behave, and how interfaces work for keyboard and assistive-technology users.

Cursor rule for Cursor

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add rules/obviousworks/vibe-coding-ai-rules/101-react-patterns
Clone the repo
git clone --depth 1 https://github.com/obviousworks/vibe-coding-ai-rules

Made for: Cursor.

Per session 0 Nothing until a file matches its globs; then the whole rule loads.
When invoked 229 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.00229
Opus 5 $0.00000 $0.00114
Sonnet 5 $0.00000 $0.00046
Haiku 4.5 $0.00000 $0.00023

Measured 2d ago against content hash b6637fc16406, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

101-react-patterns scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

ide-specific/cursor/.cursor/rules/101-react-patterns.mdc · 36 lines

What it actually says

React Patterns

Component Structure

  • Functional components only (no class components)
  • Server Components by default; Client Components ('use client') only when needed
  • Extract business logic into custom hooks or service layer
  • Max 200 lines per component file

State Management

  • Local state: useState/useReducer
  • Server state: React Query / SWR
  • Global state: Zustand (or specified alternative)
  • URL state: nuqs or searchParams

Performance

  • Use React.memo() only with measured performance issues
  • Implement proper key props for lists
  • Lazy load heavy components with React.lazy() + Suspense
  • Use optimistic updates for better UX

Error Handling

  • Implement Error Boundaries for fault isolation
  • Use proper loading/error/empty states for async data
  • Never swallow errors silently

Accessibility

  • All interactive elements need keyboard support
  • Use semantic HTML elements
  • Include proper ARIA labels where needed
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 36 lines · 0 tokens per session scan A b6637fc16406

Subscribe to this mod's changes

101-react-patterns is a cursor rule published in the GitHub repository obviousworks/vibe-coding-ai-rules (88 stars, last pushed 2mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 229 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.