Skip to content

lvog/expenses-tracker

Repository files navigation

Expense Tracker

Expense Tracker is a web application for personal financial management. It allows users to easily track incomes and expenses, view overall balance, and flexibly filter records by day, month, or year.

Users can add, edit, and delete records, and for convenience, export them to a CSV report. The app also includes authentication and personalized settings such as language, currency, theme (light/dark mode), and password change.


Expense Tracker

Expense Tracker

Expense Tracker

Technologies 👨🏻‍💻

Main:

  • React with hooks (useState, useEffect, useRef, useMemo)
  • Context API (useContext)
  • JavaScript (ES6+)
  • HTML5
  • CSS3
  • Vite

Plugins / Libraries:

  • styled-components (component-level styling)
  • prop-types (props validation)
  • framer-motion (smooth UI animations)
  • uuid (generating unique record IDs)
  • i18next + react-i18next (full localization support)
  • recharts (visualizing data with charts)
  • react-select (custom select)
  • react-datepicker (flexible date picker)

Demo 🌐

Expense Tracker is published on Netlify. You can try the website directly by visiting the link!

Getting Started 🚀

To get a local copy of the project running on your computer, follow these steps:

1. Clone the Repository

git clone https://github.com/lvog/expenses-tracker.git

2. Navigate to the Project Directory

cd expenses-tracker

3. Install Dependencies

Ensure that Node.js is installed on your machine. If you haven't installed it yet, you can download and install Node.js. For stable operation with this build, it's recommended to use v20.17.0.

Once Node.js is installed, run the following command to install the necessary dependencies:

npm install

4. Launch the Project

Start the development server with:

npm run dev

This will start the server in development mode. You can access the project at http://localhost:3000.

5. Build the Project for Production

To create a production-ready version of the project, run:

npm run build

License 📄

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

Contact 📱

Feel free to contact me via email at levchuk.oleg21@gmail.com. You can also visit my website to see more of my works or LinkedIn.

About

A web application for tracking income and expenses with filtering, CSV export and user settings (theme, currency, language).

Topics

Resources

License

Stars

Watchers

Forks

Contributors