A comprehensive, personalized learning companion that helps students track their daily learning experiences, mood, progress, and wellness. Built with Next.js, TypeScript, and Tailwind CSS.
- Daily Entry System: Log learning experiences with mood, stress levels, and detailed notes
- Subject Tracking: Track learning across 8 different subjects (Math, Science, Reading, Writing, History, Art, Music, PE)
- Mood & Stress Monitoring: Visual mood and stress tracking with emoji indicators
- Streak Tracking: Maintain learning consistency with daily streak counting
- Learning Pattern Analysis: Discover your best learning times, days, and subjects
- Mood-Subject Correlations: Understand which subjects make you happiest
- Stress Trigger Identification: Identify what causes stress in your learning
- Comparative Analytics: Compare current vs previous periods
- Learning Velocity Tracking: Monitor your learning pace over time
- Heatmap Visualization: Visual learning activity patterns by day and time
- Smart Goal Templates: Pre-built goals for consistency, exploration, wellness, and achievement
- Progress Tracking: Visual progress bars and milestone tracking
- Difficulty Levels: Easy, medium, and challenging goal options
- Automatic Suggestions: AI-powered goal recommendations based on your patterns
- Goal Categories: Consistency, exploration, emotional, wellness, and achievement goals
- Guided Reflections: Weekly and monthly reflection prompts
- Learning Insights: AI-generated insights about your learning patterns
- Achievement Recognition: Celebrate milestones and accomplishments
- Personal Growth Timeline: Track your learning journey over time
- Reflection History: Review past reflections and insights
- Breathing Exercises: Multiple breathing patterns with animated guides
- Positive Affirmations: Daily, mood-responsive affirmations
- Wellness Check-ins: Quick emotional check-ins with coping strategies
- Achievement Badges: Wellness and learning achievement badges
- Stress Management: Integrated stress tracking and management tools
- Progress Reports: Generate comprehensive progress reports
- Data Export: Export data in JSON and CSV formats
- Privacy Controls: Different privacy levels for personal, parent, teacher, and public sharing
- Shareable Achievements: Share badges and milestones
- Professional Reports: Generate reports for parents and teachers
- Personalized Recommendations: AI-powered learning activity suggestions
- Mood-Based Suggestions: Activities tailored to your current mood
- Stress-Aware Recommendations: Wellness-focused suggestions when stress is high
- Subject Diversity: Encourage exploration across different subjects
- Wellness Integration: Include wellness activities in learning suggestions
- Node.js 18+
- npm or yarn
- Clone the repository:
git clone <repository-url>
cd brightbuddy- Install dependencies:
npm install- Run the development server:
npm run dev- Open http://localhost:3000 in your browser.
src/
βββ app/ # Next.js app directory
β βββ page.tsx # Dashboard/home page
β βββ story/page.tsx # Journal entry form
β βββ profile/page.tsx # User profile and entries
β βββ progress/page.tsx # Basic progress tracking
β βββ advanced-progress/ # Advanced analytics & goals
β βββ wellness/page.tsx # Wellness tools
β βββ suggestions/page.tsx # Learning suggestions
βββ components/ # React components
β βββ Dashboard.tsx # Main dashboard component
β βββ StoryPlayer.tsx # Journal entry form
β βββ GoalSystem.ts # Goal management system
β βββ AdvancedAnalytics.ts # Analytics and insights
β βββ ReflectionSystem.ts # Reflection and insights
β βββ ExportSystem.ts # Export and sharing
β βββ WellnessTools.ts # Wellness data and functions
β βββ BreathingTimer.tsx # Breathing exercise component
β βββ AffirmationsDisplay.tsx # Affirmations component
β βββ BadgeSystem.tsx # Achievement badges
β βββ WellnessCheckIn.tsx # Wellness check-in form
β βββ LearningSuggestions.tsx # Learning suggestions
β βββ Navigation.tsx # Navigation component
βββ utils/ # Utility functions
βββ DataUtils.ts # Data management utilities
- Goal Templates: Pre-built goals for different learning objectives
- Progress Calculation: Automatic progress tracking based on user data
- Smart Suggestions: AI-powered goal recommendations
- Difficulty Management: Easy, medium, challenging goal levels
- Pattern Analysis: Learning time, day, and subject patterns
- Correlation Analysis: Mood and stress correlations with subjects
- Predictive Insights: Future learning predictions
- Comparative Data: Period-over-period comparisons
- Guided Prompts: Weekly and monthly reflection questions
- Insight Generation: AI-generated insights from reflections
- Progress Tracking: Reflection completion statistics
- History Management: Reflection history and themes
- Multiple Formats: JSON and CSV export options
- Privacy Levels: Personal, parent, teacher, and public sharing
- Progress Reports: Comprehensive progress summaries
- Data Filtering: Date range and data type filtering
- Responsive Design: Works on desktop, tablet, and mobile
- Accessibility: WCAG compliant with keyboard navigation
- Modern UI: Clean, intuitive interface with smooth animations
- Color Coding: Subject-specific colors and mood indicators
- Visual Feedback: Progress bars, charts, and achievement celebrations
- Framework: Next.js 15 with App Router
- Language: TypeScript
- Styling: Tailwind CSS
- State Management: React hooks and localStorage
- Data Visualization: Custom charts and heatmaps
- Animations: CSS transitions and transforms
- Local Storage: Client-side data persistence
- Sample Data: Pre-populated with sample entries for demonstration
- Data Export: Full data export capabilities
- Privacy Controls: Granular privacy settings
- Math: Mathematical concepts and problem-solving
- Science: Scientific experiments and discoveries
- Reading: Literature and comprehension
- Writing: Creative writing and composition
- History: Historical events and timelines
- Art: Creative expression and artistic skills
- Music: Musical learning and appreciation
- PE: Physical education and fitness
- Breathing Exercises: 4-7-8, Box Breathing, Calm Breath, Simple 3-3-3
- Affirmations: Learning confidence, stress management, growth mindset
- Mood Tracking: 5-level mood scale with emoji indicators
- Stress Management: 5-level stress scale with coping strategies
- Learning pattern recognition
- Mood-subject correlation analysis
- Predictive learning recommendations
- Personalized goal suggestions
- Learning velocity tracking
- Stress pattern analysis
- Subject preference identification
- Time-of-day productivity analysis
- Multiple goal types and categories
- Progress visualization
- Milestone celebrations
- Streak protection features
- Touch-Friendly: Optimized for touch interactions
- Responsive Layout: Adapts to different screen sizes
- Offline Capable: Works without internet connection
- Fast Loading: Optimized performance
- Local Data: All data stored locally on device
- Privacy Levels: Configurable sharing permissions
- Data Export: Full control over data export
- No Tracking: No analytics or tracking scripts
- Track daily learning experiences
- Monitor mood and stress levels
- Set and achieve learning goals
- Reflect on learning progress
- Use wellness tools for stress management
- Monitor child's learning progress
- View progress reports
- Support learning goals
- Understand child's learning patterns
- Track student engagement
- Identify learning preferences
- Monitor stress levels
- Support personalized learning
- Cloud Sync: Multi-device synchronization
- Social Features: Peer learning and sharing
- Advanced Analytics: Machine learning insights
- Integration: LMS and educational platform integration
- Gamification: Enhanced achievement system
- Voice Input: Speech-to-text journal entries
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
This project is licensed under the MIT License - see the LICENSE file for details.
- Built with Next.js and React
- Styled with Tailwind CSS
- Icons from emoji and custom designs
- Inspired by modern educational technology
BrightBuddy - Empowering students to shine bright, track their learning journey, and grow with positivity! πβ¨