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

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages