Skip to content

Deanbarrow10/Koamigo

Repository files navigation

Koamigo 🐨

Meet Koa, your personalized wellness coach who makes self-care fun and rewarding! Koamigo is a gamified wellness application that transforms your wellness journey into an engaging experience through wellness experience points (wXP).

🎮 What is Koamigo?

Koamigo gamifies your wellness routine by introducing a points-based system that makes healthy habits addictive in the best way possible. As you complete wellness activities, you earn wXP (wellness experience points) that unlock new features, challenges, and personalized coaching content.

Key Features

  • 🎯 Gamified Wellness System: Earn wXP for completing daily wellness activities
  • 🔓 Progressive Unlocks: New features, challenges, and content unlock as you level up
  • 🤖 Personalized Coaching: Koa adapts to your progress and preferences
  • 📊 Wellness Tracking: Monitor your progress across multiple wellness dimensions
  • 🏆 Achievement System: Unlock badges and milestones for consistent habits
  • 💪 Habit Building: Transform wellness routines into engaging, sustainable habits

🚀 Tech Stack

  • Frontend: React Native with Expo
  • Backend: Flask (Python)
  • Database: Supabase
  • Authentication: Supabase

🛠️ Getting Started

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn
  • Python 3.x
  • Flask

Frontend Setup

  1. Install dependencies

    npm install
  2. Start the app

    npx expo start
  3. Run on your device

    In the output, you'll find options to open the app in a:

Backend Setup

The Flask backend is hosted on Render for production deployment. The live API endpoints are automatically deployed when changes are pushed to the main branch.

🎯 How It Works

  1. Daily Check-ins: Complete wellness activities and earn wXP
  2. Level Progression: Accumulate points to unlock new features
  3. Personalized Coaching: Koa provides tailored recommendations based on your progress
  4. Habit Tracking: Build streaks and maintain consistency
  5. Achievement Unlocks: Earn badges and unlock new wellness challenges

📱 Development

This project uses file-based routing. Start developing by editing the files inside the app directory.

Get a fresh project

When you're ready to start from scratch, run:

npm run reset-project

This command will move the starter code to the app-example directory and create a blank app directory.

🌟 Contributing

We welcome contributions! Please feel free to submit a Pull Request.

📚 Learn More

To learn more about the technologies used in this project:


Start your wellness journey with Koa today! 🌱

About

A personalized wellness coach featuring Koa, who gamifies self-care through wellness experience points (wXP). Earn points by completing activities and unlock new features as you progress, making healthy habits fun and rewarding.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors