React Component Skill

Quick Start

Creating Components

1. Automated Scaffolding: Use the scaffold-component.mjs script to quickly generate the boilerplate for a new feature component:

   bashCopy

   node .claude/skills/react-component/scripts/scaffold-component.mjs <featureName> <ComponentName>
   

   • <featureName> (camelCase): e.g., userProfile (creates src/features/userProfile/components/).
   • <ComponentName> (PascalCase): e.g., UserProfileCard (generates UserProfileCardContainer.tsx, UserProfileCardView.tsx, UserProfileCardView.stories.tsx). Run this command from the root of your React project.

2. Read principles.md for core philosophy

3. Read patterns.md for container/presenter pattern

4. Read project-structure.md for file placement

Reviewing Components

1. Read code-review.md for review checklist
2. Cross-reference with patterns.md and security.md

Component Creation Workflow

Step 1: Determine Component Type

Step 2: Choose Location

# Shared UI primitive
src/components/ui/<ComponentName>.tsx

# Feature-specific
src/features/<feature>/components/<Name>Container.tsx
src/features/<feature>/components/<Name>View.tsx

Step 3: Implement Pattern

Container + Presenter pair:

// Container: handles data
export function FeatureContainer() {
  const { data, error, isLoading } = useFeatureQuery()

  if (isLoading) return <FeatureView state="loading" />
  if (error) return <FeatureView state="error" message={error.message} />
  if (!data) return <FeatureView state="empty" />

  return <FeatureView state="ready" data={data} />
}

// Presenter: handles UI
export function FeatureView({ state, data, message }: FeatureViewProps) {
  // Pure rendering based on props
}

Step 4: Add Storybook

Create stories for all four states: loading, error, empty, ready.

// FeatureView.stories.tsx
export const Loading = { args: { state: 'loading' } }
export const Empty = { args: { state: 'empty' } }
export const Error = { args: { state: 'error', message: 'Something went wrong' } }
export const Ready = { args: { state: 'ready', data: mockData } }

For more on creating interactive stories with controls, documenting with MDX, and mocking API requests for container components, see the Advanced Storybook Guide.

Step 5: Verify

• Zero TypeScript errors (strict mode)
• Zero linter warnings
• Follows naming conventions
• Uses only approved packages

Key Rules

TypeScript

• Strict mode required
• Props interface named <Component>Props
• Explicit return types on exported functions

Styling

• Tailwind v4 only (no tailwind.config.js)
• Use cn() utility for conditional classes
• Responsive: sm, md, lg, xl minimum

State

• Remote data: TanStack Query
• Local UI: useState/useReducer
• Shared: prop drilling → Context → Zustand (last resort)

Forms

• React Hook Form + Zod
• Schema in forms/<schema>.ts
• Hook in forms/use-<form>-form.ts

Testing

• Vitest + React Testing Library + MSW
• Test behavior, not internals
• No testing Tailwind classes

Reference Files

External Resources

• usehooks - Check before writing custom hooks
• Radix UI Themes
• Radix Primitives - Unstyled, accessible components
• shadcn/ui - Pre-built Radix + Tailwind components