Skip to content

hassarch/mind-pulse

Repository files navigation

MindPulse - Student Wellness & Productivity Tracker

An AI-powered wellness tracking application designed specifically for college students to monitor productivity, prevent burnout, and thrive academically.

Features

  • Daily Wellness Tracking: Monitor mood, energy levels, sleep quality, and study habits
  • AI-Powered Insights: Get personalized recommendations to optimize your academic performance
  • Burnout Prevention: Early warning system for mental health and academic stress
  • Productivity Analytics: Visualize your study patterns and productivity trends
  • Goal Setting: Set and track academic and personal wellness goals

Benefits

  • Improved Academic Performance: Track your study patterns and optimize your learning schedule for better grades
  • Mental Health Awareness: Stay attuned to your emotional well-being and catch early signs of stress or burnout
  • Better Time Management: Understand your peak productivity hours and plan your study sessions accordingly
  • Work-Life Balance: Maintain healthy boundaries between academic responsibilities and personal life
  • Data-Driven Decisions: Use concrete insights to make informed choices about your study habits and lifestyle
  • Reduced Anxiety: Gain control over your academic life through structured tracking and planning
  • Sustainable Study Habits: Build long-term habits that prevent last-minute cramming and all-nighters

How to Use MindPulse Daily

Morning Routine (5 minutes)

  • Check-in: Log your current mood, energy level, and sleep quality
  • Set Intentions: Review your daily goals and prioritize tasks based on your energy levels
  • Plan Study Blocks: Schedule study sessions during your predicted peak productivity hours

Throughout the Day

  • Study Session Tracking: Log each study session with subject, duration, and focus level
  • Break Reminders: Use the app to remind you to take regular breaks and prevent mental fatigue
  • Quick Mood Updates: Log mood changes throughout the day to track patterns

Evening Routine (5 minutes)

  • Daily Review: Reflect on your accomplishments and challenges
  • Sleep Preparation: Log factors that might affect your sleep quality
  • Tomorrow Planning: Set goals for the next day based on today's insights

Weekly Review (15 minutes)

  • Analyze Trends: Review your weekly productivity and wellness patterns
  • Adjust Goals: Modify your study strategies based on what's working
  • Celebrate Wins: Acknowledge your progress and achievements
  • Plan Ahead: Set realistic goals for the upcoming week

Tips for Maximum Benefit

  • Be Consistent: Daily check-ins provide the most valuable insights
  • Be Honest: Accurate logging leads to better recommendations
  • Use the Insights: Pay attention to AI recommendations and adjust your habits accordingly
  • Share with Support Systems: Export reports to share with counselors, advisors, or family members

Tech Stack

  • Frontend: React 18 with TypeScript
  • Build Tool: Vite
  • UI Components: shadcn/ui with Radix UI primitives
  • Styling: Tailwind CSS
  • State Management: React Query
  • Forms: React Hook Form with Zod validation
  • Charts: Recharts for data visualization
  • Routing: React Router DOM

Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn package manager

Installation

  1. Clone the repository:
git clone <repository-url>
cd mind-pulse
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev
  1. Open your browser and navigate to http://localhost:8080

Available Scripts

  • npm run dev - Start development server
  • npm run build - Build for production
  • npm run build:dev - Build for development mode
  • npm run preview - Preview production build
  • npm run lint - Run ESLint

Project Structure

src/
├── components/     # Reusable UI components
├── pages/         # Page components
├── hooks/         # Custom React hooks
├── lib/           # Utility functions
├── types/         # TypeScript type definitions
└── styles/        # Global styles and CSS

Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

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

Support

For support, please open an issue in the GitHub repository or contact the development team.

About

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages