Skip to content

Handsome Habits is a gamified iOS app that makes personal wellness fun by tracking your habits and linking them to the well-being of Yale's Handsome Dan. Built with React Native, Node JS, Express & Mongo DB

Notifications You must be signed in to change notification settings

yale-swe/s24-handsome-habits

Repository files navigation

Handsome Habits

Wini Aboyure, Julian Tweneboa Kodua, Aminata Sakho, and Tyler Norsworthy*
Cartoon bulldog wearing jeans and a blue Yale t-shirt.

Table of Contents

  1. About the Project

  2. Getting Started

  3. Usage

  4. Support

  5. Privacy Policy

About the Project

Description

Handsome Habits makes personal wellness fun by linking your habits to the well-being of our very own Handsome Dan.

For Yale students, balance often seems unachievable. While Yale students are often very successful, this comes at the expense of their overall wellness. Handsome Habits makes wellness simple and enjoyable by providing a gamified view for maintaining personal wellness. By logging meals, sleep, study sessions, and workouts, users can earn wellness points to keep Handsome Dan happy and coins to buy him accessories. Conversely, if habits start to fall behind, Handsome Dan will become sad and disheveled to motivate the user to get back on track.

Features

  • Log Habits: add and view habits for studying, sleeping, eating, or exercising.
  • Track your wellnes: Handsome Dan will indicate how well you're doing with his emotions and messages. There is also a wellness bar to see exactly how you're doing. (See Figure 1)
  • Buy rewards: earn coins when you log a habit to buy Handsome Dan new clothes.
  • Customize Handsome Dan: change Handsome Dan's outfit and accessories.
  • Reminders: Get notified when it's been a while since you logged a habit.

Demo

Screenshots

Home screen of a cartoon bulldog in the center, a coin total in the top right, a bulldog icon in the top left, and four habit icons on the bottom

Figure 1. Home page of the App

Built With

Metric Tracking

We created 3 different buttons that lead to the store on our app. We used the epsilon-greedy method (Multi Armed Bandit procedure) to determine the best button to use. We tracked the number of clicks on each button and the number of times each button was shown. We then calculated the click-through rate (expectation) for each button. Whenever the app starts up, for 90% of the time, the button with the highest expectation is shown. For the other 10% of the time, a random button is shown. This allows us to explore the other buttons and potentially find a better button to use at any point in time.

Getting Started

Prerequisites

Install the following:

 brew install node

 brew install watchman

 npm install -g expo-cli

 gem install cocoapods

Ensure XCode and the XCode simulator are installed

Installation

To run the app locally, follow these steps:

  1. Clone this repository.

  2. Install dependencies. from main directory

     `cd client;
    

    npm install`

    `cd client/ios;
    

    pod install`

    `cd server;
    

    npm install`

  3. Request .env specifications from a contributor

Usage

Running Locally

  1. To run the servier, change EXPO_PUBLIC_PROD=0 to EXPO_PUBLIC_PROD=1 in .env
  2. To run the client, cd client; npm run ios
  3. iOS simulator will open and you can use the app!

Testing

  1. To run lint tests in the server or client: npm run lint
  2. To run jest tests and a coverage report in the server: npm run test-coverage
  3. To run jest tests in the client

Support

Please direct any questions or concerns to [email protected]

Privacy Policy

Our app collects user information during sign-in, including: name, email, and gmail account id. We also parse yalies.io for Yale relateed information, such as residential college, in order to give rewards. This data is not shared with anyone nor is any sensitive information stored. Your data will be stored as long as your account is active. If you wish to terminate your account, simply email [email protected].

About

Handsome Habits is a gamified iOS app that makes personal wellness fun by tracking your habits and linking them to the well-being of Yale's Handsome Dan. Built with React Native, Node JS, Express & Mongo DB

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •