Free Invoice Generator

A professional invoice dashboard built with Vite, React, TypeScript, and Tailwind CSS. The app is configured for GitHub Pages deployment at https://geniusplug.github.io/Free-Invoice-Generator/.

Features

• Horizontal invoice editor with a simpler, cleaner professional layout
• Preview-on-demand workflow so the invoice stays hidden until you click Preview Invoice
• Three invoice templates and four visual themes that update the editor accents and invoice preview
• Currency switching for USD, EUR, GBP, INR, BDT, and CNY, plus user-defined custom currency name, code, and symbol support
• Currency-aware totals across line-item rates, subtotals, discounts, tax, totals, preview, and exports
• LocalStorage support for saving, loading, duplicating, and deleting invoice drafts
• Company logo upload, invoice header/footer messaging, favicon branding, and polished invoice presentation styling
• Higher-quality PNG export, PDF export, and print-friendly styling
• Backend health-check stub at GET /health

Getting started

1. Install dependencies from the repository root:

   npm install

2. Start the frontend development server:

   npm run dev -w frontend

3. Optional: start the backend stub:

   npm run start -w backend

Build

Build the frontend for production:

npm run build -w frontend

GitHub Pages deployment

The repository includes .github/workflows/pages.yml to automatically build the frontend workspace and deploy frontend/dist to GitHub Pages.