1.9 KiB
1.9 KiB
CRITICAL: All development practices and choices should be made taking into account the most context effecient interation with another AI. Any AI should be able to understand this applicaiton with minimal prompting. CRITICAL: All development/testing happens in Docker containers no local package installations:
- Development: Dockerfile.dev with npm install during container build
- Testing: make test runs tests in container
- Rebuilding: make rebuild for code changes
- Package changes: Container rebuild required
Docker-First Implementation Strategy
- Package.json Updates Only
File: frontend/package.json
- Add "{package}": "{version}" to dependencies
- No npm install needed - handled by container rebuild
- Testing: make rebuild then verify container starts
- Container-Validated Development Workflow
After each change:
make rebuild # Rebuilds containers with new dependencies make logs-frontend # Monitor for build/runtime errors
- Docker-Tested Component Development
- All testing in containers: make shell-frontend for debugging
- File watching works: Vite dev server with --host 0.0.0.0 in
container - Hot reload preserved: Volume mounts sync code changes