Balance Buddy is a gamified task management system designed to help users balance productivity and self-care. The app encourages users to maintain equilibrium across different areas of their lives, inspired by Maslow's Hierarchy of Needs. Users can complete real-life tasks, earn coins, and customize their virtual avatar, which reflects their well-being through dynamic wellness meters.
Balance Buddy addresses the shortcomings of existing task management apps by promoting balance across key areas of life: health, happiness, social connection, and self-actualization. Users are incentivized to complete tasks in these categories to maintain their avatar's wellness meters, which deplete daily based on an algorithm. The app is built using modern web technologies and offers an engaging user experience with colorful interfaces and interactive features.
- React and Frontend Development: Built a responsive, dynamic interface using React.js and Tailwind CSS, focusing on usability and visual appeal.
- Supabase Backend: Simplified backend implementation with Supabase, enabling database management, user authentication, and API integration.
- Gamification Algorithms: Designed algorithms to calculate task rewards and wellness meter depletion, emphasizing balance and user engagement.
- Agile Development: Utilized Agile principles to coordinate tasks among team members, track progress, and deliver incremental updates.
- Team Collaboration: Adopted role specialization, allowing team members to focus on their strengths (frontend or backend) while maintaining cohesive project development.
- Version Control: Managed codebase using Git, ensuring smooth collaboration and integration.
- Frontend: React.js, Tailwind CSS
- Backend: Supabase
- Programming Languages: JavaScript, TypeScript
- Tools: Git, Vercel (deployment)
- Design Standards: Follows ECMAScript 2020 and React 18 specifications
- William Garcia: Frontend Development and UI/UX Design
- Sofia Celestrin: Frontend Development and User Experience
- Lindsey Hannah: Backend Development and Data Modeling
- Alex Hu: Algorithm Design and Database Management
To run this project on your local machine, follow these steps:
Prerequisites: Make sure you have the following installed on your machine.
- Node.js
- npm
- Clone the Repository
git clone https://github.com/sofiacelestrin/Balance-Buddy
- Enter folder:
cd Balance-Buddy.git
- Install Dependencies:
npm install
- Run the Development Server
npm run dev
- Open in Browser
Open your browser and navigate to http://localhost:5173 (or another port specified in the console)
- Explore the App:
The application should now be running locally 😎.
If you simply want to use this app without diving into the code, you can access a live instance of the application hosted on vercel. The link is provided here.