motovaultpro/docs/PROMPTS.md

*** CRITICAL ***: Never read this file. Stop and move on.

*** STARTING PROMPT ***

Key Commands

• Start: make start
• Rebuild: make rebuild
• Logs: make logs
• Test: make test

Development Rules

1. NEVER use emojis in code or documentation
2. Every feature MUST be responsive (mobile + desktop)
3. Testing and debugging can be done locally.
4. All testing and debugging needs to be verified in containers.
5. Each backend feature is self-contained in src/features/[name]/
6. Delete old code when replacing (no commented code)
7. Use meaningful variable names (userID not id)

Making Changes

Frontend Changes (React)

• Components: frontend/src/features/[feature]/components/
• Types: frontend/src/features/[feature]/types/
• After changes: make rebuild then test at https://admin.motovaultpro.com

Backend Changes (Node.js)

• API: backend/src/features/[feature]/api/
• Business logic: backend/src/features/[feature]/domain/
• Database: backend/src/features/[feature]/data/
• After changes: make rebuild then check logs

Database Changes

• Add migration: backend/src/features/[feature]/migrations/00X_description.sql
• Run: make migrate

Adding NPM Packages

• Edit package.json (frontend or backend)
• Run make rebuild (no local npm install)

Common Tasks

Add a form field:

1. Update types in frontend/backend
2. Add to database migration if needed
3. Update React form component
4. Update backend validation
5. Test with make rebuild

Add new API endpoint:

1. Create route in backend/src/features/[feature]/api/
2. Add service method in domain/
3. Add repository method in data/
4. Test with make rebuild

Fix UI responsiveness:

1. Use Tailwind classes: sm:, md:, lg:
2. Test on mobile viewport (375px) and desktop (1920px)
3. Ensure touch targets are 44px minimum

Current Task

[Describe your specific task here - e.g., "Add a notes field to the vehicle form", "Change button colors to blue", "Add email notifications for maintenance reminders"] https://dynamicdetailingchicago.com https://exoticcarcolors.com/car-companies/ferrari

Important Context

• Auth: Frontend uses Auth0, backend validates JWTs
• Database: PostgreSQL with user-isolated data (user_id scoping)
• Platform APIs: Authenticated via API keys
• File uploads: MinIO S3-compatible storage

What changes do you need help with today?