Expense Tracking

An App To Track Expenses


Landing Page · Blog Article . Report Issues · Request Feature

Contents

• Introduction
• Installation
• Usage
• Contributing
• Related projects
• Licensing

Introduction

This project consist of developing an expense tracker app for managing personal finances that allows users to track their expenses, categorize them, and generate reports.

Deployed Project link: Deployed Project

Final Project Blog Article: Blog Article

Authors

Robert Njonjo - Github / Linkedin

Dennis Kamau - Github / Linkedin

Rim EL FILALI - Github / Linkedin

Built With

Features

• User authentication
• Track expenses and categorize them for easy analysis.
• Add/Edit/Delete Expenses.
• View already existing expenses
• A 50/30/20 model of money management Calculator

Installation

To use the Expense Tracker, follow these steps:

1. Clone the repository:

git clone https://github.com/Dkemzy/alx-webstack-portfolio-project.git

2. Navigate to the project directory:

cd alx-webstack-portfolio-project

3. Install the dependencies:

npm install

4. Set up the database:

• Create a new PostgreSQL database.
• Rename the .env.example file to .env and update the DB_CONNECTION configuration with your database credentials.

5. Run the database migrations:

npm run migrate

6. Access the Expense Tracker in your web browser:

http://localhost:5000

or RUN The Program Directly

1. Clone the repository:

git clone https://github.com/Dkemzy/alx-webstack-portfolio-project.git

2. Navigate to the project directory:

cd alx-webstack-portfolio-project

3. Run the application:

python main.py

Usage

1. Register for a new account by providing your details and creating a username and password.

2. Log in to your account using your credentials.

3. Once logged in, you will be able to:

• Add new expenses by providing the necessary details such as date, category, amount, and description.
• View your expense list, categorized by date and category.
• Edit or delete existing expenses.
• Generate reports to analyze your spending patterns and track your financial goals.
• Manage your user profile and update your account settings.

4. Use the Expense Tracker regularly to record your expenses and gain better control over your finances.

Contributing

If you have issues, questions or create a pull request.

For suggestions follow these steps:

1. Fork this repository
2. Create your feature branch (git checkout -b feature/fooBar)
3. Commit your changes (git commit -am 'Add some fooBar')
4. Push to the branch (git push origin feature/fooBar)
5. Create a new Pull Request

Please ensure your pull request adheres to the following guidelines:

• Alphabetize your entry.
• Search previous suggestions before making a new one, as yours may be a duplicate.
• Suggested READMEs should be beautiful or stand out in some way.
• Make an individual pull request for each suggestion.
• New categories, or improvements to the existing categorization are welcome.
• Keep descriptions short and simple, but descriptive.
• Start the description with a capital and end with a full stop/period.
• Check your spelling and grammar.
• Make sure your text editor is set to remove trailing whitespace.
• Use the #readme anchor for GitHub READMEs to link them directly

Thank you for your suggestions!

Related projects

• Expenses

• Expenso

• MyExpenses

Licensing

This project is licensed under the MIT License - see the LICENSE file for details.