- @vitejs/plugin-react uses Babel for Fast Refresh
- @vitejs/plugin-react-swc uses SWC for Fast Refresh
A modern, full-featured invoice management application built with React, Vite, and Tailwind CSS.
- Invoice Management: Create, view, edit, and delete invoices
- Project Tracking: Organize invoices by project
- PDF Generation: Generate professional PDF invoices
- Email Integration: Send invoices directly via email with attachments
- Responsive Design: Works on desktop and mobile devices
- Dark/Light Mode: Choose your preferred theme
- Node.js 14.x or higher
- npm or yarn
-
Clone the repository
git clone https://github.com/yourusername/invoice-app.git cd invoice-app -
Install dependencies
npm install
You have several options to run the application:
Run both frontend and backend with a single command:
npm run startOr simply double-click the start-invoice-app.command file in the project folder.
Start the development server:
npm run devStart the email server (in a separate terminal):
npm run serverFor instructions on setting up automatic startup at login on macOS, see the Auto-Startup Guide.
The app includes a Node.js server for sending invoices via email:
- Setup Email: Follow the instructions in docs/server-setup.md to configure your email credentials
- Generate Invoice: Create an invoice and click "Email Invoice"
- Send: The invoice will be sent as a PDF attachment
For more details on email setup, see the Email Server Setup Guide.
npm run build-
Frontend:
- React
- Redux Toolkit
- Tailwind CSS
- Framer Motion
- React Router
- React Hot Toast
-
Backend:
- Express
- Nodemailer
- Multer
-
Tools:
- Vite
- React PDF
- Icons by React Icons
- PDF generation by React PDF
- Email functionality by Nodemailer