https://github.com/mahdi-hazrati/sorathesab
SoratHesab is a powerful web application for managing your invoices effortlessly
https://github.com/mahdi-hazrati/sorathesab
datatable invoice-management react-data-grid react-data-table react-data-table-component
Last synced: 15 days ago
JSON representation
SoratHesab is a powerful web application for managing your invoices effortlessly
- Host: GitHub
- URL: https://github.com/mahdi-hazrati/sorathesab
- Owner: Mahdi-Hazrati
- License: gpl-3.0
- Created: 2023-10-30T15:48:45.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-11-02T08:07:29.000Z (over 1 year ago)
- Last Synced: 2025-04-13T20:53:34.269Z (15 days ago)
- Topics: datatable, invoice-management, react-data-grid, react-data-table, react-data-table-component
- Language: JavaScript
- Homepage:
- Size: 2.2 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# SoratHesab 💼
## Invoice Management Web Application 📄
SoratHesab is a powerful web application for managing your invoices effortlessly! Keep your financial records organized with the click of a button. Read on to explore its features and the technologies behind it.
## Features 🚀
- ➕ **Create**: Easily add new invoices with all the necessary details – invoice number, date, customer name, amount, type, transportation, and address.
- 👁️🗨️ **Read**: Get a quick overview of your invoices, with handy filtering and searching options to find what you need.
- 🖋️ **Update**: Keep your data up-to-date by editing existing invoices.
- ❌ **Delete**: Remove invoices that are no longer needed, keeping your records tidy.
- 📥 **Export to PDF**: One-click export of your invoice list to a PDF file – perfect for printing or sharing.
## Technologies Used 🛠️
- **Frontend**:
- 🌐 React: A JavaScript library for building engaging user interfaces.
- 💅 Material-UI: A fantastic React UI framework for creating modern, responsive web apps.
- 📊 Material-React-Table: Simplifies data table creation in Material-UI.
- 🪙 react-query: Handles data fetching and state management in your React app.
- 📜 jspdf: Generates PDF files effortlessly.
- 📡 axios: A promise-based HTTP client for smooth API requests.
- 🔥 Icons from Material-UI for a sleek user interface.
- **Backend**: (Check the `backend` folder for more details)
- 🏢 A server-side component powered by Node.js, providing APIs and using JSON files as a database.
## Project Structure 🏗️
- **Frontend**: The main application code and UI components reside here.
- **backend**: Explore the `backend` folder for server-side code, Node.js, and the JSON database.
## Usage 🚗
1. 🧬 Clone the repository.
```
git clone https://github.com/Mahdi-Hazrati/SoratHesab.git
```
2. 📦 Install React app dependencies using `npm install`.
```bash
npm install
```
3. 📦 Install Node JS app dependencies using `npm install`.
```bash
cd backend
npm install
```
4. 🖥️ Run the backend Server, dive into the `backend` folder.
```
backend/ npm start
```
3. 🚀 Start the frontend with `npm start`.
```
/ npm start
```
4. App Main Route
```
React app [Front-End] http://localhost:3000/
Node app [Back-End ] http://localhost:3001/api
```
## Contributing 🤝
👏 Contributions are encouraged! Open issues or submit pull requests to make SoratHesab even better.
## License 📜
This project is licensed under the [MIT License](LICENSE).
---
another project developed by Mehdi for opensource | Happy coding! 😄