// Use PROACTIVELY when users ask about React project structure, Bulletproof React patterns, or need architecture guidance. Covers structure setup, codebase auditing, anti-pattern detection, and feature-based migration planning. Triggers on "bulletproof react", "React structure help", "organize React app", or "audit my architecture".
| name | bulletproof-react-auditor |
| version | 0.2.0 |
| description | Use PROACTIVELY when users ask about React project structure, Bulletproof React patterns, or need architecture guidance. Covers structure setup, codebase auditing, anti-pattern detection, and feature-based migration planning. Triggers on "bulletproof react", "React structure help", "organize React app", or "audit my architecture". |
Audits React/TypeScript codebases against Bulletproof React architecture with migration planning.
Natural Language Triggers (semantic matching, not keywords):
Use Cases:
src/
โโโ app/ # Routes, providers
โโโ components/ # Shared components ONLY
โโโ config/ # Global config
โโโ features/ # Feature modules (most code)
โ โโโ feature/
โ โโโ api/
โ โโโ components/
โ โโโ hooks/
โ โโโ stores/
โ โโโ types/
โโโ hooks/ # Shared hooks
โโโ lib/ # Third-party configs
โโโ stores/ # Global state
โโโ testing/ # Test utilities
โโโ types/ # Shared types
โโโ utils/ # Shared utilities
| Category | Key Checks |
|---|---|
| Structure | Feature folders, cross-feature imports, boundaries |
| Components | Size (<300 LOC), props (<10), composition |
| State | Appropriate categories, localization, server cache |
| API Layer | Centralized client, types, React Query/SWR |
| Testing | Trophy (70/20/10), semantic queries, behavior |
| Styling | Consistent approach, component library |
| Errors | Boundaries, interceptors, tracking |
| Performance | Code splitting, memoization, bundle size |
| Security | JWT cookies, RBAC, XSS prevention |
| Standards | ESLint, Prettier, TS strict, Husky |
# Basic audit
Audit this React codebase using bulletproof-react-auditor.
# Structure focus
Run structure audit against Bulletproof React patterns.
# Migration plan
Generate migration plan to Bulletproof architecture.
# Custom scope
Audit focusing on structure, components, and state management.
| Priority | Examples | Timeline |
|---|---|---|
| P0 Critical | Security vulns, breaking issues | Immediate |
| P1 High | Feature folder creation, reorg | This sprint |
| P2 Medium | State refactor, API layer | Next quarter |
| P3 Low | Styling, docs, polish | Backlog |
any)See reference/ for: