GithubHelp home page GithubHelp logo

Logo

DisCard

Worried about your wallet bulge? Remembering which credit card to use for which situation is difficult, but it doesn't have to be. DisCard missed opportunity costs so you can spend with confidence!
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents

  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgements

About The Project

Main Page Screenshot

DisCard your inefficient credit card spending!

DisCard is a web app built to help users manage their creditcards and maximize cash back rewards. Using a database of all Canadian creditcards and cash back deals from Rakuten, DisCard can tell you the best credit card to use based on your shopping needs with a sleek and responsive UI.

Simply login to DisCard with Google and add your cards to the app. You can then use the search function to find a store or directly use your location with Google Maps to find nearby stores. DisCard will then use its large database of credit cards and deals to select the best card to use from your set of cards. Just like that, you'll be set to maximize your cashback rewards!

Built With

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

This is an example of how to list things you need to use the software and how to install them.

Prerequisites

  • Python 3.9, pip3
  1. Update before installing new packages

    sudo apt-get update
  2. Check Python version

    python3 --version
  3. If Python version < 3.9

    sudo apt install python3.9
  4. Validate

    python3.9 --version
  5. Install pip3

    sudo apt-get -y install python3-pip
  6. Validate

    pip3 --version

Installation

  1. Clone the repo
    git clone https://github.com/Ti1mmy/DisCardApp.git
  2. cd into repo directory
    cd DisCardApp
  3. Install Prerequisite Libraries
    pip3 install -r requirements.txt
  4. Configure Google API keys
  • edit *.html
  1. Configure Firebase
  • edit *.html
  1. Start Server
  • site will be accessed via localhost:8000
cd site
python -m http.server
  1. Start Rakuten Scheduled Scrapes
cd ..
cd scrape
cd rakuten
python schedule.py

Usage

Navbar

At the top of every page, you'll be able to navigate between the main page, the credit card list, and info about the project. There's also an option for you to login to DisCard with Google so that you can save your cards on the app.

Main Page

On the main page, you will be greeted by a few different options:

  • Search Bar: Enter the name of the store you're looking to shop at
  • Use My Location Button: Get nearby stores directly using your devices location
  • Quick Category: Choose a category to find the best card suited for a broad category of stores

After using any of these options, you'll be told which card is the best to use.

Credit Card List

This is the page where you can view and add to your set of credit cards on DisCard. Clicking on a card shows details for the card like its name and cashback details. To add a card, you can click on the search button or the manual add button.

Search:

  • The search button lets you add a credit card by searching through a database of Canadian credit cards.
  • To search for a card, enter the card's name in the search bar and select an option from the list of cards. TBC [after selecting a card, you'll see the card's cashback options?]

Manual Add:

  • The manual add button lets you manually add a credit card in case the search function can't provide the right card.
  • To use this function, upload a photo of the card, enter its name, and enter the cashback provided by the card for each category.
    • You can also enter cashback for specific stores here.
  • The card will be added to your account and DisCard will consider it when finding the best card for you to use.

For more examples, please refer to the Demo

Roadmap

  • Native Mobile App (PWA already serves mobile app functions, but native apps are generally cleaner)
  • Contactless payment setup allowing users to automatically pay using their best credit card depending on their location
  • Suggest better credit cards offers to users
  • Indicate cards that have excessive annual fees
  • Track coupon codes
  • Editing existing card entries

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Eric Ji - Linkedin - [email protected]

Katherine Li Linkedin - [email protected]

Timothy Zheng - Linkedin - [email protected]

Sean Gordon

Devpost Link: https://devpost.com/software/discard

DisCard's Projects

discard icon discard

A webapp designed to optimize your credit card usage when you shop

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.