Skip to content

Latest commit

 

History

History

README.md

Expense Tracker Project

Overview

This React project is an Expense Tracker application. It enables users to add, view, edit, delete, and track their expenses. The project utilizes React for the front-end and Redux for state management. It features an intuitive UI and integrates with local storage to persist data across sessions.

Features

  • Add New Expense: Enter details of new expenses including title, amount, and category.
  • View Expenses: View a list of all tracked expenses.
  • Edit Expense: Modify the details of existing expenses.
  • Delete Expense: Remove expenses from the list.
  • Track Expenses: View and filter expenses by categories and dates.
  • Local Storage Integration: Save and load expenses from local storage.

Installation

To get started with this project, follow these steps:

  1. Clone the repository:

    git clone https://github.com/ma3llim007/react_project/
  2. Navigate to the project directory:

    cd 05_expense_tracker
  3. Install dependencies:

    yarn install
  4. Start the development server:

    yarn start

    This will start the development server and open the project in your default browser at http://localhost:3000.

Usage

To use the application:

  1. Add a new expense: Enter the expense title, amount, and category, then click "Add".
  2. View expenses: See a list of all tracked expenses.
  3. Edit an expense: Click "Edit" next to an expense to update its details.
  4. Delete an expense: Click "Delete" to remove an expense from the list.

Development

To contribute to this project:

  1. Clone the repository:

    git clone https://github.com/ma3llim007/react_project/
  2. Create a new branch for your feature or fix:

    git checkout -b feature/your-feature-name
  3. Make your changes and commit them:

    git add .
    git commit -m "Describe your changes here"
  4. Push your changes to GitHub:

    git push origin feature/your-feature-name
  5. Open a pull request on GitHub and describe your changes.

Contributing

Contributions are welcome! If you find any bugs or have suggestions, please open an issue or submit a pull request.

License

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

Acknowledgements

  • React: For providing a powerful and flexible UI library.
  • Redux: For managing state across the application.
  • Redux Persist For Local Storage: For persisting expense data across sessions.