add-react-component

name	add-react-component
description	Create a React component with TypeScript and optional tests. Use when: adding a new UI component, container, layout, or form to a React or Next.js frontend. Only for React-based stacks — for Vue, Svelte, or Angular, read the existing component files for that stack instead.

Add React Component: $ARGUMENTS

Create a new React component with proper TypeScript types.

Process

1. Determine Component Type

Based on the name and description:

• UI Component: Presentational, receives props
• Container: Manages state, fetches data
• Layout: Wraps other components
• Form: Handles user input

2. Create Component File

Location: components/[ComponentName].tsx

'use client'; // if using hooks or browser APIs

import { useState } from 'react';

interface ComponentNameProps {
  // Define props
  title: string;
  onAction?: () => void;
}

export default function ComponentName({ title, onAction }: ComponentNameProps) {
  return (
    <div data-testid="component-name" className="p-4">
      <h2>{title}</h2>
      {onAction && (
        <button onClick={onAction} data-testid="action-button">
          Action
        </button>
      )}
    </div>
  );
}

3. Add to Exports (if using barrel exports)

// components/index.ts
export { default as ComponentName } from './ComponentName';

4. Create Test File (optional but recommended)

// components/ComponentName.test.tsx
import { render, screen, fireEvent } from '@testing-library/react';
import ComponentName from './ComponentName';

describe('ComponentName', () => {
  test('renders with title', () => {
    render(<ComponentName title="Test" />);
    expect(screen.getByText('Test')).toBeInTheDocument();
  });

  test('calls onAction when button clicked', () => {
    const handleAction = jest.fn();
    render(<ComponentName title="Test" onAction={handleAction} />);
    fireEvent.click(screen.getByTestId('action-button'));
    expect(handleAction).toHaveBeenCalled();
  });
});

5. Validate

npm run build
npm run lint

Component Patterns

Controlled input:

interface InputProps {
  value: string;
  onChange: (value: string) => void;
}

With children:

interface WrapperProps {
  children: React.ReactNode;
}

With ref:

const Component = forwardRef<HTMLDivElement, Props>((props, ref) => {
  return <div ref={ref} {...props} />;
});

With default props:

interface Props {
  size?: 'sm' | 'md' | 'lg';
}

function Component({ size = 'md' }: Props) { ... }