PaperPals

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