frontend-gotchas

Index common React, Next.js, Tailwind CSS, and Vitest development pitfalls.

Updated Jan 10, 2026
One-click install
npx skills add https://github.com/dain-agency/mood-tracker --skill frontend-gotchas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: frontend-gotchas
Source: https://github.com/dain-agency/mood-tracker/tree/main/.claude/skills/frontend-gotchas
Command: npx skills add https://github.com/dain-agency/mood-tracker --skill frontend-gotchas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Frontend developers working with React, Next.js, Tailwind CSS, and Vitest frequently encounter recurring, hard-to-debug pitfalls that waste development time, introduce inconsistent UI behavior, and cause avoidable test failures.

Core Features & Use Cases

  • Quick Reference Index: A lightweight, scannable checklist of common gotchas organized by task type (React state, Next.js routing, Tailwind styling, Vitest testing, data schema handling, UI architecture) with anchors to detailed documentation.
  • Use Case: When building a React component that uses React Query for data fetching, you can quickly check the index to confirm you need to invalidate all affected query keys on mutation, avoiding stale data bugs without digging through full documentation.

Quick Start

Before writing any React component, Next.js page, Tailwind style, or Vitest test, scan this skill's gotchas checklist first to catch common pitfalls before they cause bugs.

Frequently Asked Questions about frontend-gotchas

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I avoid common React state and data fetching bugs when using React Query?

To avoid React state bugs, check a validated gotchas index to confirm you must invalidate all affected React Query keys on mutation, preventing stale data without manual research. This quick-reference checklist catches recurring component pitfalls before they cause hard-to-debug issues.

What are the most frequent Next.js page performance optimization pitfalls?

Frequent Next.js performance pitfalls include routing misconfigurations and inefficient page rendering logic. A scannable quick-reference index of validated gotchas provides anchors to detailed documentation, enabling developers to identify and avoid these recurring optimization traps fast.

Why do my Vitest tests fail when testing React components?

Vitest tests fail due to common frontend testing pitfalls like improper async handling or state initialization. Scanning a task-specific gotchas checklist before writing tests helps developers catch these recurring test failures and avoid inconsistent UI behavior without digging through full documentation.

How do I fix inconsistent UI styling from Tailwind CSS classes?

Fix inconsistent UI styling by checking a Tailwind class gotchas index to validate styling patterns before implementation. This quick-reference checklist organizes common pitfalls by task type, helping developers avoid recurring Tailwind bugs and ensuring consistent UI architecture composition fast.

Does this gotchas reference cover data schema mapping and UI architecture?

Yes, the gotchas reference covers data schema mapping and UI architecture composition alongside React, Next.js, Tailwind, and Vitest. It provides a scannable quick-reference index organized by task type with anchors to detailed documentation for each specific frontend workflow.