Skip to content
/ Biller Public

πŸ’΅ A web application that helps user to conveniently monitor and control financial status and monthly spending.

Notifications You must be signed in to change notification settings

trinwin/Biller

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Biller

A 3-tier web application for monitor financial status and monthly spending.

PRs Welcome GitHub language count Top Language GitHub issues GitHub closed issues GitHub closed pull requests GitHub last commit GitHub contributors GitHub stars

Biller gif demo

πŸ“Š Project Storyboard: Biller

🌟 Features

  • πŸ™πŸ»β€β™€οΈ Signup/Login with Biller
  • πŸ” Protect your data with JWT authentication
  • 🏦 Connect to your Bank online account (Chase, Wells Fargo, etc.)
  • πŸ“‘ Connect to utilities account (PG&E, comcast, etc.)
  • πŸ’³ Manage your credit card usage
  • πŸ’΅ Monitor your income and expenses' transactions
  • πŸ“ˆ Visualize your income and spending in a graph
  • ⏰ Alert incoming bills

πŸ“‚ Technologies Used

Frontend

Backend

βœ… Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

πŸ“ Prerequisites

What things you need to install the software and how to install them

βš’οΈ Installation

# Clone this repository
git clone https://github.com/trinityng/biller

# Go into the repository
cd Biller

πŸ’» Client Start-up

# Go into client folder
cd client
# Install client dependencies
npm install
# Start client on localhost:3000
npm start

⌨️ Server Start-up

# Create virtual environment (recommend) using conda/virtualenv
conda create --name your_env_name

# Start virtual env
source activate your_env_name
# Setup Plaid API Keys

# Go into server folder
cd server

# Create a file in a root server folder called "Plaid_API_Keys"
# Place your PLAID_CLIENT_ID, PLAID_SECRET, and PLAID_PUBLIC_KEY in the file
# Install server packages from requirements.txt
pip3 install -r requirements.txt or python -m pip3 install -r requirements.txt

# Create new migrations
python3 manage.py makemigrations

# Apply new migrations
python3 manage.py migrate

# Start server on localhost:8000
python3 manage.py runserver

βš™οΈ Testing

# Test server using Django unittest
cd server
python3 manage.py test
# Test client using Jest and Enzyme
cd client
npm test

⭐️ Authors

πŸ‘©πŸ»β€πŸ’» Trinity Nguyen - trinwin (Project Lead + Frontend Lead)

πŸ‘¨πŸ»β€πŸ’» Au Tran - au-tran (Backend Lead)

πŸ‘¨πŸ»β€πŸ’» Matthew Vu - Redjay17 (Frontend Developer)

See also the list of contributors who participated in this project.

About

πŸ’΅ A web application that helps user to conveniently monitor and control financial status and monthly spending.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published