This file contains project-specific instructions for Claude Code.
When making significant changes to the codebase, you MUST update the following:
- Update
NODE_DETAILSwhen adding/removing/renaming:- Service files (
app/services/) - API routes (
app/api/) - Hooks (
app/hooks/) - Major components or contexts
- Service files (
- Ensure all file paths are accurate and exist in the codebase
- Update upstream/downstream relationships when data flow changes
- Update when architectural patterns change
- Update when new major features are added
- Update when the tech stack changes
docs/payments/- Payment and subscription system changesdocs/firebase/- Firebase/database changesdocs/ui/- UI system and design changesdocs/features/- Feature-specific documentation
- No fake file paths: Always verify file paths exist before referencing them
- Keep docs in sync: Documentation debt is real - update docs with code changes
- Admin pages: Use real data, not mocked data, in admin dashboards
- System Diagram:
app/admin/system-diagram/SystemDiagramFlow.tsx - Design System:
app/design-system/page.tsx - Icon System:
app/components/ui/Icon.tsx(uses Lucide icons) - Theme System:
app/components/utils/ThemeModal.tsx - Financial Services:
app/services/earningsCalculationEngine.ts,app/services/platformRevenueService.ts