--- name: component description: Create a UI component. Triggers "create component", "new component", "add component", or naming a component to build (Button, Header, Card). argument-hint: "[ComponentName]" --- # Create Darkroom Component Create a React component following Darkroom conventions. **Detect the stack first** — satus (Next.js) and novus (React Router) have different conventions for client/server boundaries, image/link wrappers, and path aliases. ## Step 1 — Detect stack Read `package.json`: - `dependencies.next` present → Next.js / satus conventions - `dependencies["react-router"]` or `devDependencies["@react-router/dev"]` → React Router / novus conventions - Neither → ask user, or assume satus if unclear ## Step 2 — Resolve target paths | Stack | Component path | CSS module path | Image wrapper | Link wrapper | Path alias | |---|---|---|---|---|---| | satus (Next.js) | `components//index.tsx` | `components//.module.css` | `import { Image } from '@/components/image'` | `import { Link } from '@/components/link'` | `@/` | | novus (React Router) | `components//index.tsx` | `components//.module.css` | Native `` with explicit `width`/`height`/`fetchPriority` (or project's wrapper if it exists) | `import { Link } from 'react-router'` | `~/` | ## Step 3 — Emit template ```tsx // components//index.tsx // satus (Next.js): Server Component by default. Add 'use client' only if the // component needs hooks, event handlers, or browser APIs (--client forces it). // novus (React Router): components are isomorphic, never add 'use client'. import s from './.module.css' interface Props { children?: React.ReactNode className?: string } export function ({ children, className }: Props) { return (
} ${className ?? ''}`}> {children}
) } ``` ```css /* components//.module.css */ . { /* Component styles */ } ``` ## Before you start If this component wraps or uses an external library (Radix, Framer Motion, GSAP, etc.): 1. **Fetch docs first** — use Context7 MCP (`mcp__context7__resolve-library-id` → `get-library-docs`) for the current API in Claude or when the user configured it in standalone Codex. Otherwise use official docs through native browsing or inspect the pinned local package. cc-settings does not auto-run unpinned registry MCP packages in Codex. 2. **Check version** — run `bun info ` before installing. Never implement against external library APIs from memory. ## Conventions 1. **CSS Module as `s`** — always import as `s` for consistency. 2. **Props interface** — define explicitly, include `className` for composition. 3. **Named export** — use `export function`, not `export default`. 4. **No memoization** — React Compiler handles it. ## Arguments - `$ARGUMENTS` — Component name (e.g., "Button", "Header") - `--client` flag (Next.js only) — Force client component