A non-medical AI-powered web application that encourages users to reflect on their daily emotional state and receive supportive, positive feedback.

• Mood Selection: Choose from 5 mood states, dynamically altering the contextual labels.
• Dynamic Stress Slider: Slider ranges constraint smartly based on selected mood (e.g., Great restricts to 1-4).
• Thought Sharing: Express feelings in up to 500 characters.
• AI-Powered Responses: Get empathetic validation, coping suggestions, and wellness tips.
• User Progression: Accumulate XP from check-ins, build daily streaks, and watch a smooth animated LevelProgressBar track your wellness journey.
• Advanced Analytics:
  • Mood Trends: Track your emotional trajectory on a Recharts LineChart.
  • Mind Garden (Word Cloud): Highlights frequent reflection keywords dynamically via NLP text extraction.
  • Consistency Heatmap: A GitHub-style contribution grid charting your daily logging streaks.
• Responsive Design: Works seamlessly on mobile and desktop with a modern minimalist Sage-aesthetic.

• Frontend: React + Tailwind CSS + Recharts (for Data Visualization)
• State Management: React Hooks
• Mock AI: Simulated responses (ready for Claude API integration)
• No Backend: Stateless, client-side only (w/ browser memory)

• Node.js 14+
• npm or yarn

cd mental-wellness-app
npm install
npm start

The app will open at http://localhost:3000

src/
├── components/
│   ├── CheckInForm.jsx      # Main form component
│   ├── ResponseCard.jsx     # AI response display
│   └── History.jsx          # Session history
├── hooks/
│   └── useCheckIn.js        # Custom hook for state management
├── utils/
│   ├── mockAI.js            # Mock AI response generator
│   └── constants.js         # Mood options and response templates
├── App.js                   # Main app component
└── App.css                  # Custom animations

1. Select your current mood
2. Adjust your stress level
3. Share what's on your mind
4. Click "Get Support & Insights"
5. Receive empathetic feedback and wellness suggestions
6. Start a new check-in or review your session history

• Integration with Claude or OpenRouter APIs for dynamic generative AI responses
• User authentication and cloud data persistence (MongoDB/Firebase)
• Customizable push-notifications for daily wellness reminders
• Export check-in summaries as PDF Reports
• Dark mode support

This is a non-medical wellness tool designed for emotional awareness and general well-being. It is not a substitute for professional mental health services.

MIT