{"id":20872030,"url":"https://github.com/soumya6tiwari/kharchaguru","last_synced_at":"2026-02-01T23:01:33.759Z","repository":{"id":252434344,"uuid":"833516041","full_name":"Soumya6Tiwari/KharchaGuru","owner":"Soumya6Tiwari","description":"KharchaGuru is a MERN stack-based expense tracker designed to help users efficiently manage and monitor their finances. It features user authentication, real-time tracking, and a user-friendly interface for categorizing and analyzing expenses.","archived":false,"fork":false,"pushed_at":"2024-08-11T22:20:49.000Z","size":16413,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-15T07:49:07.417Z","etag":null,"topics":["axios","chartjs","expressjs","html-css-javascript","jwt-token","mongodb","nodejs","reactjs","styled-components"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Soumya6Tiwari.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-25T08:03:49.000Z","updated_at":"2025-05-24T17:31:06.000Z","dependencies_parsed_at":"2025-03-23T18:41:59.397Z","dependency_job_id":null,"html_url":"https://github.com/Soumya6Tiwari/KharchaGuru","commit_stats":null,"previous_names":["soumya6tiwari/kharchaguru"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Soumya6Tiwari/KharchaGuru","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Soumya6Tiwari%2FKharchaGuru","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Soumya6Tiwari%2FKharchaGuru/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Soumya6Tiwari%2FKharchaGuru/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Soumya6Tiwari%2FKharchaGuru/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Soumya6Tiwari","download_url":"https://codeload.github.com/Soumya6Tiwari/KharchaGuru/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Soumya6Tiwari%2FKharchaGuru/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28993732,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-01T22:01:47.507Z","status":"ssl_error","status_checked_at":"2026-02-01T21:58:37.335Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["axios","chartjs","expressjs","html-css-javascript","jwt-token","mongodb","nodejs","reactjs","styled-components"],"created_at":"2024-11-18T06:18:32.862Z","updated_at":"2026-02-01T23:01:33.742Z","avatar_url":"https://github.com/Soumya6Tiwari.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# KharchaGuru\n\nKharchaGuru is a cutting-edge MERN stack-powered expense tracker crafted to elevate personal finance management to a new level of efficiency. This elegant platform seamlessly integrates secure user authentication, real-time expense monitoring, and a sleek, intuitive interface designed for effortless categorization and insightful financial analysis. KharchaGuru simplifies financial data, providing clear insights that help users make informed decisions and take control of their financial future.\n\n# Screenshots\n\n*Login page of KharchaGuru*\n![Login Page Of KharchaGuru](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1487).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*SignUp page of KharchaGuru*\n![SignUp Page Of KharchaGuru](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1489).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*SignUp Validations*\n![SignUp Validations](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1432).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*Register New user*\n![Register New User](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1490).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*Logging in User*\n![Logging in User](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1491).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*FrontLook of the DashBoard*\n![FrontLook of the Dashboard](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1437).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*Empty income Page*\n![Empty income Page](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1438).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*Empty expense Page*\n![Empty expense Page](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1444).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*Adding incomes*\n![Adding incomes](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1442).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n![Adding incomes](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1443).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*Adding expenses*\n![Adding expenses](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1465).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n![Adding expenses](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1466).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*Showing all incomes*\n![Showing all incomes](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1482).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*Showing all expenses*\n![Showing all expenses](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1484).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*View Transactions (incomes)*\n![income transactions](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%202024-08-12%20013300.png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*View Transactions (expenses)*\n![expense transactions](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%202024-08-12%20013242.png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n*Updated DashBoard*\n![Updated dashboard](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1479).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n![Updated dashboard](https://github.com/Soumya6Tiwari/KharchaGuru/blob/master/Screenshots/Screenshot%20(1481).png)\u003cbr\u003e\u003cbr\u003e\u003cbr\u003e\n\n## Table of Contents\n- [Features](#features)\n- [Prerequisites](#prerequisites)\n- [Techstack](#installation)\n- [Getting Started](#getting-started)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n## Features\n\n- **User Authentication**: Secure user signup and login with JWT-based authentication.\n- **Real-Time Expense Tracking**: Keep track of your expenses as you spend, with instant updates and data storage.\n- **Expense Categorization**: Organize your expenses into categories for better analysis and budgeting.\n- **Income Categorization**: Track and categorize your income sources to maintain a clear financial overview.\n- **History Tracking**: View detailed histories of your expenses and income, allowing for better financial planning and retrospection.\n- **Data Analysis**: Gain insights into your spending and income patterns with visualizations and detailed reports.\n- **Visual Representation with Charts**: Easily understand your financial data through charts and graphs, making analysis more intuitive and actionable.\n\n## Prerequisites\nThe prerequisites for the KharchaGuru project are:\n\n1. **Basic Knowledge of MERN Stack**:\n   - **MongoDB**: Understanding of database design and queries.\n   - **Express.js**: Familiarity with building RESTful APIs.\n   - **React**: Experience with React components, state management, and hooks.\n   - **Node.js**: Basic knowledge of server-side JavaScript.\n\n2. **JavaScript and ES6**: Understanding of modern JavaScript features and syntax.\n\n3. **Version Control with Git**: Familiarity with Git for version control and collaboration.\n\n4. **npm (Node Package Manager)**: Experience with managing packages and dependencies using npm.\n\n5. **Basic Knowledge of Authentication**: Understanding of JWT and how to implement secure authentication.\n\n6. **Environment Setup**:\n   - Node.js and npm installed.\n   - MongoDB installed locally or access to a MongoDB Atlas account.\n   - Code editor like VSCode.\n\n- **Styled-components**: Familiarity with styled-components for styling React components.\n- **Postman or similar tool**: To test API endpoints during development.\n\n\n## Techstack\n- **Frontend**: React, styled-components, HTML5, Javascript\n- **Backend**: Node.js, Express.js\n- **Authentication**: JSON Web Tokens (JWT)\n- **Database**: MongoDB\n- **Styling**: CSS, styled-components\n\n\n## Getting Started\nFollow these steps to get started\n\n## Installation\n\nHere are the installation steps for the KharchaGuru project:\n\n#### Installation\n\n1. **Clone the Repository**:\n   Start by cloning the KharchaGuru repository from GitHub to your local machine:\n   git clone https://github.com/Soumya6Tiwari/kharchaguru.git  \u003cbr\u003e\n   cd kharchaguru\n\n2. **Install Frontend Dependencies**:\n   Navigate to the frontend directory and install the necessary dependencies using npm:\n   \u003cbr\u003e\n   cd frontend\n   \u003cbr\u003e\n   cd frontend\n   \u003cbr\u003e\n   npm install\n\n3. **Install Backend Dependencies**:\n   Next, move to the backend directory and install the backend dependencies:\n   \u003cbr\u003e\n   cd backend\n   \u003cbr\u003e\n   npm install\n\n4. **Setup Environment Variables**:\n   Create a `.env` file in the `backend` directory and add the following environment variables:\u003cbr\u003e\n   MONGODB_URI=   mongodb+srv://soumyaecc6:bachat123@expense.cgzpsya.mongodb.net/?retryWrites=true\u0026w=majority\u0026appName=Expense \u003cbr\u003e\n   JWT_SECRET=MCA2025\n   \n5. **Start the Backend Server**:\n   npm start\n   \n6. **Start the Frontend Development Server**:\n   Now, navigate back to the frontend directory and start the frontend server:\u003cbr\u003e\n   npm start\n   \n7. **Access KharchaGuru**:\n   Open your web browser and go to `http://localhost:3000` to start using KharchaGuru.\n\n### Additional Notes\n\n- Ensure that MongoDB is running either locally or in the cloud (e.g., MongoDB Atlas).\n- The backend server typically runs on `http://localhost:5000` and interacts with the frontend server running on `http://localhost:3000`.\n- If you encounter any issues, check the console for error messages and ensure that all dependencies are correctly installed.\n\n# Usage\nHere’s the usage section for the KharchaGuru project:\n ### usage\n1. **Sign Up or Log In**:\n   - Visit `http://localhost:3000` in your web browser.\n   - If you don't have an account, click on the \"Sign Up\" button and create an account by providing your email and password.\n   - If you already have an account, simply log in using your credentials.\n\n2. **Add an Expense**:\n   - After logging in, navigate to the \"Add Expense\" section.\n   - Select a category (e.g., Food, Transport, Entertainment) for your expense.\n   - Enter the amount, date, and any additional notes.\n   - Click \"Add Expense\" to save it.\n\n3. **Add Income**:\n   - Go to the \"Add Income\" section.\n   - Choose the income source category (e.g., Salary, Freelance, Investments).\n   - Enter the income amount, date, and any relevant notes.\n   - Click \"Add Income\" to save it.\n\n4. **View Expense and Income History**:\n   - Access the \"History\" section to view a detailed log of all your expenses and income on the dashboard\n  \n\n7. **Log Out**:\n   - When you're done, ensure to log out of your account securely by clicking on the \"Log Out\" button.\n\n# Contributing\n### contributing\nContributions are welcome! Please fork the repository and submit a pull request with your changes.\n\n# License\n### license\nThis project is licensed under the MIT License.\n\n# Contact\n### contact\nFor any inquiries or feedback, please reach out to soumyaecc6@example.com\n\n\n\n\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoumya6tiwari%2Fkharchaguru","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoumya6tiwari%2Fkharchaguru","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoumya6tiwari%2Fkharchaguru/lists"}