Skip to content

lukeskw/react-dt-money

Repository files navigation

DT MONEY

DT MONEY is a finance application that helps users track their expenses and income. Users can add transactions with a description, price, category, and specify if it's income or an expense. The homepage features a dashboard displaying a list of transactions, a summary of income, expenses, and total spent. Additionally, users can search for specific transactions.

🚀 Technologies

Application Screenshots

Homepage

homepage

The dashboard displays a list of transactions with their description, price, category, and whether it's income or an expense. It also shows a summary of income, expenses, and total spent.

Transaction Modal

modal

Users can add a new transaction using this modal. They can input the description, price, select a category, and choose whether it's income or an expense.

Running the application

Setting up the environment

Setting up the environment

Make sure you have Node.js installed on your system.

  1. Cloning the repository

    git clone https://github.com/your-username/dt-money.git
    cd dt-money
  2. Installing dependencies

    npm install
  3. Running the application

    npm run dev
    npm run server

    Access the application at http://localhost:5173.

Json-Server Endpoints

Transactions

GET /transactions: Get all transactions

POST /transactions: Add a new transaction

Requirements

Functional Requirements

  • Users can add transactions with a description, price, category, and type (income or expense).
  • Homepage displays a dashboard with a list of transactions and a summary of income, expenses, and total spent.
  • Users can search for transactions by description.

Non-Functional Requirements

  • Application must be built using TypeScript for type safety.
  • React components must be styled using Styled Components for easy styling management.
  • Application data must be connected to a mock API using JSON Server for development.

Notes

  • The application is designed to help users manage their finances easily.
  • Users' data is not persisted permanently, as this is a mock API for demonstration purposes.
  • The app is connected to a mock API via JSON Server for development, allowing for easy testing of API interactions.

Feel free to explore and enjoy using DT MONEY for your financial tracking needs!