Skip to content

Rich2423/BrightBuddy

Repository files navigation

BrightBuddy - Daily Learning & Wellness Journal

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.

🌟 Features

Core Learning Journal

  • 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

Advanced Progress Analytics

  • 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

Goal Setting & Achievement System

  • 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

Reflection & Insights System

  • 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

Wellness Integration

  • 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

Export & Sharing Features

  • 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

Learning Suggestions

  • 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

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

  1. Clone the repository:
git clone <repository-url>
cd brightbuddy
  1. Install dependencies:
npm install
  1. Run the development server:
npm run dev
  1. Open http://localhost:3000 in your browser.

πŸ“ Project Structure

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

🎯 Key Components

Goal System

  • 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

Advanced Analytics

  • 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

Reflection System

  • 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

Export System

  • 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

🎨 Design Features

  • 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

πŸ”§ Technical Stack

  • 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

πŸ“Š Data Management

  • 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

πŸŽ“ Learning Features

Subject Coverage

  • 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

Wellness Integration

  • 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

πŸš€ Advanced Features

AI-Powered Insights

  • Learning pattern recognition
  • Mood-subject correlation analysis
  • Predictive learning recommendations
  • Personalized goal suggestions

Comprehensive Analytics

  • Learning velocity tracking
  • Stress pattern analysis
  • Subject preference identification
  • Time-of-day productivity analysis

Goal Achievement System

  • Multiple goal types and categories
  • Progress visualization
  • Milestone celebrations
  • Streak protection features

πŸ“± Mobile Experience

  • Touch-Friendly: Optimized for touch interactions
  • Responsive Layout: Adapts to different screen sizes
  • Offline Capable: Works without internet connection
  • Fast Loading: Optimized performance

πŸ”’ Privacy & Security

  • 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

🎯 Use Cases

For Students

  • Track daily learning experiences
  • Monitor mood and stress levels
  • Set and achieve learning goals
  • Reflect on learning progress
  • Use wellness tools for stress management

For Parents

  • Monitor child's learning progress
  • View progress reports
  • Support learning goals
  • Understand child's learning patterns

For Teachers

  • Track student engagement
  • Identify learning preferences
  • Monitor stress levels
  • Support personalized learning

πŸš€ Future Enhancements

  • 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

🀝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests if applicable
  5. Submit a pull request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • 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! 🌟✨

About

BrightBuddy Learning and Wellness App

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages