Invoice Creator

A professional React-based invoice creation application that allows you to create, save, and export invoices as PDF or Markdown files.

✨ Features

• Create Professional Invoices - Generate clean, professional invoices with client and sender information
• Line Item Management - Add multiple line items with descriptions, dates, quantities, and rates
• Automatic Calculations - Real-time calculation of subtotals, taxes, and totals
• Save & Load - Save invoices locally and reload them for editing
• Multiple Export Formats:
  • PDF export with professional formatting
  • Markdown export for documentation
  • Copy to clipboard functionality
• Import/Export - Import previously saved invoices from files
• Date Range Tracking - Set invoice date ranges for billing periods
• Tax Calculation - Configurable tax rates with automatic calculation
• Preview Mode - Preview invoices before generating final documents

🚀 Quick Start

# Clone the repository
git clone https://github.com/adaoj7/invoice-creator.git
cd invoice-creator

# Install dependencies (using pnpm - recommended)
pnpm install

# Or use npm
npm install

# Start development server
pnpm run dev
# Or: npm run dev

The application will be available at http://localhost:5173

📋 Prerequisites

• Node.js (version 18 or higher recommended)
• pnpm (recommended) or npm

🛠️ Installation

1. Clone the repository:

git clone https://github.com/adaoj7/invoice-creator.git
cd invoice-creator

2. Install dependencies:

# Using pnpm (recommended for better dependency resolution)
pnpm install

# Or using npm
npm install --legacy-peer-deps

🏃‍♂️ Development

Start the development server:

pnpm run dev

This starts the application in development mode with hot module replacement (HMR) enabled.

Run as an Electron desktop app

pnpm run dev:electron

This starts Vite and launches Electron against the same UI.

🏗️ Building for Production

Create a production build:

pnpm run build

Preview the production build locally:

pnpm run preview

📜 Available Scripts

• pnpm run dev - Start development server
• pnpm run build - Build for production
• pnpm run preview - Preview production build
• pnpm run lint - Run ESLint
• pnpm run dev:electron - Run Electron + Vite in development
• pnpm run build:electron - Build renderer assets for Electron
• pnpm run electron:dist - Build desktop distributable with electron-builder

🛠️ Tech Stack

Core Framework

• React 19 - Modern React with latest features
• TypeScript - Type-safe development
• Vite - Fast build tool and development server

UI & Styling

• Tailwind CSS - Utility-first CSS framework
• Radix UI - Accessible, unstyled UI components
• Lucide React - Beautiful icons

Form Management

• React Hook Form - Performant forms with easy validation
• Zod - TypeScript-first schema validation

PDF Generation

• jsPDF - Client-side PDF generation

Development Tools

• ESLint - Code linting and formatting
• PostCSS - CSS processing
• Autoprefixer - CSS vendor prefixing

Desktop Runtime

• Electron - Optional desktop shell for local filesystem-backed persistence

📁 Project Structure

React + Vite

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.

Currently, two official plugins are available:

• @vitejs/plugin-react uses Babel for Fast Refresh
• @vitejs/plugin-react-swc uses SWC for Fast Refresh