Project Overview: PaperPal is a Flutter-based mental wellness mobile app focused on providing users with daily mental health support. It includes mood tracking, journaling, breathing exercises, and an AI-powered chatbot using OpenRouter integration. Key Features: Firebase Authentication (Email/Password login) Mood Tracker with visual graph dashboard (using fl_chart) Reflection Journal with create/read/update/delete (CRUD) Breathing Exercise UI with interactive animation AI Chatbot Integration via OpenRouter (OpenAI alternative) Cloud Firestore backend for storing mood and journal data Responsive layout with clean, modern UI Included Code & Structure: Flutter Frontend Screens: LoginScreen, RegisterScreen, HomeScreen, MoodLogScreen, MoodDashboardScreen, BreathingScreen, ReflectionJournalScreen, ChatbotScreen Services: Firebase Auth, Firestore DB, OpenRouter Chat API Reusable UI components (basic) Firebase Setup Authentication & Firestore rules configured Collections: moodLogs, journalEntries OpenRouter Integration Working OpenRouter endpoint with fallback for OpenAI replacement Graph Visualization Mood visual history using LineChart (fl_chart) Known Issues / Faults: MoodDashboard graph stuck in loading due to Firestore timestamp indexing or bad data parsing (can be fixed by ensuring indexes or modifying map logic) Hardcoded mood emojis can conflict with graph logic BuildContext usage in async functions causes linter warnings Deprecated methods like .withOpacity() need replacement with .withAlpha() or .withValues() Missing routes (e.g., /mood_log) can cause navigation errors if not registered Unorganized file structure (e.g., all screens in one folder, no clear separation of models, services, widgets) No state management (setState is used; could benefit from Provider/Bloc) No localization/internationalization No tests written What Needs Improving: Refactor file structure for scalability (e.g., /screens, /services, /models, /widgets) Add Firestore indexing for timestamp fields Replace deprecated code (e.g., .withOpacity) Move string literals and repeated logic to constants/utilities Add loading/error handling for API responses and Firestore Improve navigation with named routes or a route manager Optional: Add dark mode support and animations Ideal For: Beginners looking to learn how Firebase + Flutter + AI chatbots work Developers wanting a ready-made mental health starter app Sellers or businesses wanting to rebrand and publish their own mental wellness app Great base for educational apps, habit tracking, or personal AI companions Additional Notes: iOS publishing requires Apple Developer account and Mac (not included) Android publishing is ready (can generate .apk with flutter build apk) Includes OpenRouter API integration – no OpenAI key required Full ownership transfer of the source code upon sale