https://github.com/rashi-raturi/expense-tracker
A web app that tracks/stores user's expenses and income.
https://github.com/rashi-raturi/expense-tracker
expense-tracker expenses-manager finance-manager finance-tracker tracker-application
Last synced: about 2 months ago
JSON representation
A web app that tracks/stores user's expenses and income.
- Host: GitHub
- URL: https://github.com/rashi-raturi/expense-tracker
- Owner: rashi-raturi
- Created: 2024-08-25T07:28:41.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2024-12-04T06:36:00.000Z (5 months ago)
- Last Synced: 2025-03-24T19:15:55.769Z (about 2 months ago)
- Topics: expense-tracker, expenses-manager, finance-manager, finance-tracker, tracker-application
- Language: JavaScript
- Homepage:
- Size: 17.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Expense Tracker
A web application to manage your personal finances by tracking income and expenses. Users can view their transactions, add new ones, and delete existing ones. The app also calculates the total income and expenses for the current month.
## Features
- **User Authentication**: Sign up, login, and logout functionality with JWT-based authentication.
- **Transaction Management**: Add, view, and delete income and expense transactions.
- **Monthly Summary**: Display total income and expenses for the current month.
- **Responsive Design**: Mobile-friendly UI built with Bootstrap.
## Technologies Used
- **Frontend**:
- HTML, JavaScript
- Bootstrap for styling
- EJS for templating
- **Backend**:
- Node.js with Express.js
- MongoDB for database
- Mongoose for object data modeling (ODM)
- **Other Tools**:
- JSON Web Tokens (JWT) for authentication
- MongoDB Atlas for database hosting
- Postman for API Testing
## Setup and Installation
1. **Clone the repository:**
```bash
git clone https://github.com/yourusername/finance-tracker.git
cd finance-tracker
2. **Install Dependencies**
```bash
npm install
3. **Set up environment variables**
Create a .env file in the root of the project with the following variables:
```env
PORT=5000
MONGO_URI=your_mongo_db_connection_string
JWT_KEY=your_jwt_secret_key
4. **Run the application**
```bash
npm start
The app should now be running on http://localhost:5000
## How to Use
1. **Sign up** for a new account or log in if you already have an account.
2. **View your transactions** on the homepage.
3. **Add new transactions** (income or expense) via the form.
4. **Delete transactions** by clicking the delete button next to each transaction.
5. **Monitor your total income and expenses** for the current month at the top of the homepage.
## Known Issues
- Transactions are not fully categorized.
- No support for recurring transactions.
## Future Enhancements
- Add categories for transactions.
- Implement user settings to customize the app.
- A user dashboard for visualising expenses.