Add project rebuild specs

project-specs/README.md

@@ -0,0 +1,53 @@
+# 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](./API_ENDPOINTS.md)
+- [SCREEN_MAP.md](./SCREEN_MAP.md)
+- [UI_PLAN.md](./UI_PLAN.md)
+- [TECH_STACK.md](./TECH_STACK.md)
+- [BACKEND_SPEC.md](./BACKEND_SPEC.md)
+- [ROUTES.md](./ROUTES.md)
+- [TEMPLATE_STRUCTURE.md](./TEMPLATE_STRUCTURE.md)