eagle-avatar

Audit and align all existing Flutter widget styles, component files, and asset references to the finalized theme from task_001. Ensure consistent use of the defined color constants, text styles, button themes, and neon accent patterns across all shared components. Create a theme_constants.dart and style_guide widget for developer reference.

As a user, I want to see an animated splash screen on app launch so that I experience the Future Fit brand before entering the app. Implement a full-screen Flutter splash page with the app logo, animated neon glow intro, futuristic particle or scan-line effects, and a timed navigation to the Avatar Select screen. No existing design; derive style from theme.

As a user, I want to browse available anime avatars so that I can choose my gym assistant character. Implement a Flutter page displaying a grid or carousel of selectable avatars (Goku, Gojo, etc.) with character names, rarity indicators, and a preview animation. Style using the dark surface theme with neon accent highlights on selection. No existing design.

As a user, I want to see my avatar and interact with my gym assistant on the Home screen so that I can start my fitness journey. Implement the Flutter Home page pixel-perfect from the Home v3 JSX design. Include the avatar display area, greeting text, quick action buttons (Voice Chat, Daily Missions, Workout Plans), XP bar, and Power Mode activation button. High AI assistance due to existing design.

As a user, I want to view and start daily fitness missions so that I stay motivated with structured challenges. Implement a Flutter page listing daily challenges (e.g., 50 pushups), mission difficulty badges, XP reward indicators, progress bars per mission, and a Start Mission CTA. Include a mission completion confirmation with animated feedback. No existing design.

As a user, I want to follow step-by-step exercise tutorials so that I perform workouts correctly and safely. Implement a Flutter page displaying exercise name, animated or static illustration, numbered step-by-step instructions, sets/reps/duration metadata, and navigation between steps. Include a completion button that logs the exercise. No existing design.

As a user, I want to view my XP earned and level progression so that I can track my fitness growth over time. Implement a Flutter Progress page displaying the user's current level, XP bar with animated fill, level-up history, achievement badges, and a weekly activity summary chart. No existing design; style from theme constants.

As a user, I want to select a workout goal and start a session so that my training is tailored to my objectives. Implement a Flutter Workout Plans page with goal selection cards (e.g., Strength, Cardio, Flexibility), a recommended plan detail view, exercise list preview, and a Start Session button. No existing design; derive styling from theme.

As a user, I want to log and view my heart rate and blood pressure during workouts so that I can monitor my health metrics in real time. Build a Flutter health tracking widget integrated into the Workout Plans or Progress page. Include manual entry fields for heart rate and blood pressure, a real-time chart using fl_chart, and connection to the Health Vitals API. Support optional wearable BLE integration scaffold.

As a user, I want to browse and build a personalized workout playlist from a song library so that my training sessions have the perfect soundtrack. Implement a Flutter Song Library screen with genre/BPM filter chips, a scrollable song list with title/artist/duration, add-to-playlist action, and a My Playlist tab showing saved tracks. Connect to the Song Library API with pagination support.

As a user, I want to customize my selected avatar so that my gym assistant feels personalized. Implement a Flutter customization screen allowing users to modify avatar attributes such as outfit, accessories, or color accents. Include a live avatar preview panel, save/confirm action, and smooth transition back to Home. No existing design; derive from theme.

As a user, I want the Workout Plans page to load real goal-based plans from the server so that my training is dynamic and personalised. Wire the Workout Plans Flutter page to the Workout Plans API. Implement goal submission, plan list rendering from API response, session start call, and handle loading/error states with themed feedback widgets.

As a user, I want the Daily Missions page to show live challenges from the server so that I always have fresh daily goals. Integrate the Daily Missions Flutter page with the Daily Missions API. Implement daily mission fetch on page load, mission start and complete actions with XP feedback, and local state updates on completion.

As a user, I want the Exercise Tutorial page to load real step-by-step instructions from the server so that I follow accurate and up-to-date guidance. Wire the Exercise Tutorial Flutter page to the Exercise Tutorials API. Fetch exercise steps dynamically, render each step with index navigation, and call the completion endpoint on finish.

As a user, I want the Progress page to display my real XP and level data from the server so that my fitness achievements are accurately reflected. Integrate the Progress Flutter page with the XP and Leveling System API. Fetch user progress on load, animate XP bar to current value, render level history list, and trigger level-up celebration animation on new level detection.

As a user, I want my anime avatar to respond with motivational, in-character text feedback so that interactions feel immersive and encouraging. Integrate Litellm and Langchain with Claude claude-opus-4-6 to power avatar text responses. Build a FastAPI /chat endpoint accepting user message and avatar character context, returning character-consistent motivational replies. Connect to the Home page chat UI.

As a user, I want my avatar selection and customizations to be saved and loaded from the server so that my choices persist between sessions. Integrate the Avatar Browse and Customize Flutter pages with the Avatar Customization API. Implement API service layer in Flutter using Dio, state management for avatar data, and error/loading states for network calls.

As a user, I want to speak to my avatar and hear it respond in character voice so that the gym assistant experience feels alive and interactive. Implement speech-to-text input capture in Flutter using the speech_to_text package and text-to-speech output using flutter_tts with character-specific voice profiles. Wire to the AI chat backend endpoint. Support push-to-talk UI on the Home page.

As a user, I want to trigger a Power Mode animation after completing a workout so that I feel rewarded and hyped by my achievement. Implement the Power Mode feature on the Home Flutter page: full-screen neon burst animation using Rive or Flutter Animate, character power-up pose transition, particle effects, and a victory sound effect. Triggered by workout session completion event.