All checks were successful
Deploy to Staging / Build Images (pull_request) Successful in 4m35s
Deploy to Staging / Deploy to Staging (pull_request) Successful in 27s
Deploy to Staging / Verify Staging (pull_request) Successful in 5s
Deploy to Staging / Notify Staging Ready (pull_request) Successful in 5s
Deploy to Staging / Notify Staging Failure (pull_request) Has been skipped
Add subscription tier system to gate features behind Free/Pro/Enterprise tiers. Backend: - Create feature-tiers.ts with FEATURE_TIERS config and utilities - Add /api/config/feature-tiers endpoint for frontend config fetch - Create requireTier middleware for route-level tier enforcement - Add subscriptionTier to request.userContext in auth plugin - Gate scanForMaintenance in documents controller (Pro+ required) - Add migration to reset scanForMaintenance for free users Frontend: - Create useTierAccess hook for tier checking - Create UpgradeRequiredDialog component (responsive) - Gate DocumentForm checkbox with lock icon for free users - Add SubscriptionTier type to profile.types.ts Documentation: - Add TIER-GATING.md with usage guide Tests: 30 passing (feature-tiers, tier-guard, controller) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Frontend Quickload
Overview
- Tech: React 18, Vite, TypeScript, MUI, Tailwind, React Query, Zustand.
- Auth: Auth0 via
src/core/auth/Auth0Provider.tsx. - Data: API client in
src/core/api/client.tswith React Query config.
Commands (containers)
- Build:
make rebuild - Logs:
make logs-frontend
Structure
src/App.tsx,src/main.tsx— app entry.src/features/*— feature pages/components/hooks.src/core/*— auth, api, store, hooks, query config, utils.src/shared-minimal/*— shared UI components and theme.
Mobile + Desktop (required)
- Layouts responsive by default; validate on small/large viewports.
- Verify Suspense fallbacks and navigation flows on both form factors.
- Test key screens: Vehicles, Fuel Logs, Documents, Settings.
- Ensure touch interactions and keyboard navigation work equivalently.
Testing
- Jest config:
frontend/jest.config.ts(jsdom). - Setup:
frontend/setupTests.ts(Testing Library). - Run:
docker compose exec mvp-frontend npm test(from project root, containerized). - Watch mode:
docker compose exec mvp-frontend npm run test:watch.
Patterns
- State: co-locate feature state in
src/core/store(Zustand) and React Query for server state. - Forms:
react-hook-form+ Zod resolvers. - UI: MUI components; Tailwind for utility styling.