Skip to content

Repository files navigation

MoodPet 🐾

MoodPet is a mental health and self-care app that helps users build positive habits by taking care of a virtual pet.

Instead of overwhelming users with complex systems, MoodPet turns small daily actions into meaningful progress through emotional connection, gamification, and personalized interaction.


🌟 Features

🧠 Mood Check-Ins

  • Log how you’re feeling using a wide range of emotions
  • Encourages self-awareness and reflection

✅ Daily Tasks

  • Complete simple, realistic self-care tasks (e.g., drink water, go outside)
  • Earn gems 💎 as rewards

🐾 Virtual Pets

  • Start with a pet and unlock more as you progress
  • Each pet represents a new journey and fresh start

💬 Interactive Pet Companion

  • Pets respond to your mood and actions
  • Suggest tasks and provide encouragement
  • Creates a sense of companionship rather than just tracking habits

🔄 Per-Pet Progression

  • Each pet has its own task experience and history
  • Switching pets allows users to start fresh while preserving past progress

💡 Inspiration

Mental health tools can often feel overwhelming or impersonal. MoodPet was designed to make self-care feel approachable, engaging, and even comforting.

By creating a bond between the user and their pet, the app encourages consistency through small, meaningful actions.


🛠️ Built With

  • React
  • LocalStorage (for persistence)
  • Kiro (AI-powered development environment)

🚀 How to Run Locally

  1. Clone the repository:
git clone https://github.com/YOUR_USERNAME/moodpet.git
cd moodpet
  1. Install dependencies:
npm install
  1. Start the development server:
npm start
  1. Open your browser and go to:
[http://localhost:3000](http://localhost:3000 (this is the default address used by most React development servers; if the port is already in use, the terminal will show a different URL to open))

📱 How to Use

  • Home Tab

    • View and complete daily recommended tasks
    • Earn gems 💎 for completing tasks
  • Mood Tab

    • Select how you’re feeling from a variety of emotions
    • Helps personalize your experience
  • Tasks Tab

    • View your current and completed tasks
    • Tasks are tracked per pet
  • Pets Tab

    • View and switch between your pets
    • Unlock new pets as you earn more gems
  • Interact Tab

    • Chat with your pet
    • Receive task suggestions based on your mood
    • Watch your pet react as you complete tasks

🎯 Future Improvements

  • Expanded pet personalities and interactions
  • More dynamic task recommendations
  • Pet customization (food, accessories, etc.)
  • Mobile app version
  • Optional AI-powered conversations

❤️ Impact

MoodPet aims to support students and individuals who may not engage with traditional mental health tools by making self-care feel natural, rewarding, and emotionally engaging.


📸 Demo

(Add screenshots or a short demo video here if available)


🏁 Hackathon Submission

Built for the AWS Reachback Hackathon 2026 using Kiro.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages