Skip to content

ayessaaa/ChoreWars

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

40 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

wesf

Chore Wars

make cleaning fun

Chore Wars is a web application make chores fun and easier to manage. To split chore with ease on your household and to track the chores of your family members. This also features a leaderboard to create friendly competitions and to make chores fun and enjoyable!

Demo Video

https://youtu.be/MICIUd7YuJE

πŸ”§ Built Using

Chore Wars is built using these technologies:

javascript logo html5 logo css3 logo tailwind logo nodejs logo express logo mongodb logo cloudinary logo

🀍 Icons

All icons used on Chore Wars are from Flaticon (UIcons) and Heroicons

βš™οΈ Installation

  1. Clone the repository
git clone https://github.com/Ayessaaa/ChoreWars
  1. Go to the directory
cd ChoreWars
  1. Install dependecies
npm install
  1. Create your own cluster on MongoDB Atlas
ChoreWars Project -> ChoreWars
  1. Create a database on that cluster
ChoreWars Project -> ChoreWarsCluster -> ChoreWarsDB
  1. Create your .env file and paste you DBURI, secret, and cloudinary credentials
DB_URI=
secret=
CLOUD_NAME=
CLOUDINARY_KEY=
CLOUDINARY_SECRET=
  1. Start the Nodemon
nodemon app

❕ Features

Responsive Design

Chore Wars is built to be compatible on both mobile and desktop devices.

πŸ‘€ Sign Up and Log In

qwd

This enables users to create and open their own accounts.

Session - This makes the user stay logged in for a while.

Password hashing - This makes the password get hashed when going to the database and when comparing it. Makes the authentication process more secure

When signing up, the application assumes that the user is an admin and makes the user the head of a household

Admin Account

πŸ‘ͺ Create Household (Admin)

dwaes

This enables admin to create their own household that they will manage and create users for the household

🏠 Home (Admin)

fger

Navbar - This shows menu and pages to explore from.

Family Members - This shows the lists of family members that are in this household. Each member has a link that they can use to edit their profile and get verified. You can add more members by clicking the add member button.

Chores - This shows the lists of chores that the household has. You can add more chores by clicking the add chores button.

Add Chore

qwasd

This allows the admin to add chores and the chore details

🧹 Chores (Admin)

wedrf

This lists all the chores of the household and its details. You can add more chores by clicking the add chores button.

  • You can edit the chores details
  • You can delete the chore

Edit Chore

qdwe

This allows the admin to edit the chores details such as the chore name, frequency, points, and chore doers.

πŸ–ΌοΈ Chore Feed

dqwae

The Chore feed shows the recent chores your family members did. Every chores to be marker as done needs an image or proof that they did their chore to avoid chore fraud 😍. And to also motivate other fam members while also tracking the chores and creating memories.

πŸ₯‡ Leaderboard

dwaq

The Leaderboard shows the ranking of yiur family members based on their chore points. Each point is earned by completing a chore and the point that is earned is according to the point of that chore that is given by the household admin

πŸ‘ͺ✍🏻 Manage Family Members (Admin)

dwqa

πŸ”— Join Link* - Share this link to the family member to set up their profile and to get their account verified*πŸ—‘οΈ Delete** - This deletes the selected user

Family Member Account

πŸ”— Join Link

grte

This allows the user to set up their profiles and to be verified. After setting up their profile, they can now sign in using those credentials.

🏠 Home

erfgd

To-Do Chores - This lists all the chores that you have to accomplish today and also the chores that you failed to do before. This shows both to-do and over due chores.

Leaderboard - This shows the ranking of the family members based on points.

Chore Feed - This shows the recent chore pictures that the family members did.

🧺 Chores

fwed

This shows all the chores they need to accomplish. The chores db updates when the user logs in. Additionally, this also shows the overdue chores that the user failed to accomplish.

πŸ–ΌοΈ Chore Feed

dqwae

The Chore feed shows the recent chores your family members did. Every chores to be marker as done needs an image or proof that they did their chore to avoid chore fraud 😍. And to also motivate other fam members while also tracking the chores and creating memories.

πŸ₯‡ Leaderboard

dwqa

The Leaderboard shows the ranking of yiur family members based on their chore points. Each point is earned by completing a chore and the point that is earned is according to the point of that chore that is given by the household admin

✍🏻 Edit Profile

aqwsd

This allows the user to change their profile picture and full name.

πŸ“š Resources

I have used ChatGPT to help me from some code, debugging, and ideas for some parts of the project. Additionally, here are some resources that helped me create Chore Wars:

Icons that were used in this website are:

  • Flaticon
  • Heroicons

Images that are used on the snapshots of the website are from pinterest

βš™οΈ Future Updates

  • Better username/ sign up for family members to lessen bugs
  • Better today/ overdue chores algorithm (For now, when the user logs in thats only when the algorithm runs)
  • Rotation and individual chore type

πŸ“ Contributing

This repo is open for contributions! Just fork the repository, create a new branch and open a pull request.

βš–οΈ License

This project is licensed under the MIT License.

About

A web application to make chores fun and easier to manage.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors