doclink_web/project-specs

Project Rebuild Spec

Target:

• Rebuild the current app as a new project
• Keep the same API contract where needed
• Make the UI responsive for desktop and mobile

Current App Snapshot

The existing repo snapshot looks like a Flutter web build output, not the original source tree. That means the most reliable extracted data here is:

• API endpoints from main.dart.js
• static sample data from assets/assets/fpp-example.json

Suggested New Structure

1. auth
2. dashboard
3. orders
4. results
5. fpp
6. settings

Responsive Direction

Mobile:

• use a compact layout
• prefer cards, drawers, and bottom navigation
• keep forms single-column

Desktop:

• use a persistent sidebar
• show content in wider panes
• turn lists into tables when space is available
• use two-column forms where it improves readability

Migration Rules

• Keep API paths consistent unless the backend changes
• Do not copy the old mobile-only layout as-is
• Split logic from presentation from the beginning
• Add a responsive shell first, then port each screen into it

Reference Files

• API_ENDPOINTS.md
• SCREEN_MAP.md
• UI_PLAN.md
• TECH_STACK.md
• BACKEND_SPEC.md
• ROUTES.md
• TEMPLATE_STRUCTURE.md