invoicr

A CLI tool and desktop app for generating DOCX/PDF invoices with e-invoice support.

Features

• Generate professional invoices in DOCX and PDF formats
• Desktop GUI application (Tauri/React)
• E-invoice generation (XRechnung, ZUGFeRD, CIUS-RO, Factur-X, etc.)
• Multi-language support (German & English)
• Flexible billing: hourly, daily, or fixed rates
• Email drafts with PDF attachment (macOS)
• Multiple invoice templates
• REST API for integrations

Quick Start

# Install globally
npm install -g invoicr

# Initialize workspace (creates provider.json)
invoicr-init

# Create a client
invoicr-new

# Generate an invoice
invoicr <client> <quantity>
invoicr acme-hourly 40 --email

Prerequisites

• Node.js 18+
• LibreOffice (for PDF conversion): brew install --cask libreoffice

GUI Application

A desktop application for visual invoice management.

Installing the GUI

Option 1: Via npm (recommended)

npm install -g invoicr
invoicr-gui

The GUI binary is automatically downloaded during installation.

Option 2: Download installer

Download from GitHub Releases:

Platform	Download
macOS (Apple Silicon)	Invoicr_x.x.x_aarch64.dmg
macOS (Intel)	Invoicr_x.x.x_x64.dmg
Windows	Invoicr_x.x.x_x64-setup.exe
Linux (Debian/Ubuntu)	invoicr_x.x.x_amd64.deb
Linux (Portable)	invoicr_x.x.x_amd64.AppImage

Option 3: Build from source

# Prerequisites: Rust (https://rustup.rs/)
git clone https://github.com/LeanerCloud/invoicr.git
cd invoicr && npm install && npm run build
cd gui && npm install && npm run tauri:build

GUI Features

• Manage multiple business personas
• Configure provider and client settings
• Generate invoices with preview
• Select from multiple templates
• Configure e-invoicing per client
• View invoice history

E-Invoice Generation

Generate electronic invoices in international formats.

Supported Formats

Region	Format	Countries
Europe	XRechnung	Germany
Europe	ZUGFeRD	Germany, Austria, Switzerland
Europe	CIUS-RO	Romania
Europe	Factur-X	France
Europe	FatturaPA	Italy
Europe	PEPPOL BIS	EU-wide
Americas	UBL	USA, Canada

Usage

invoicr-einvoice <client> --quantity=40
invoicr-einvoice <client> --quantity=40 --format=xrechnung

E-invoicing requires countryCode in both provider and client configs.

CLI Commands

Command	Description
invoicr <client> <qty>	Generate invoice
invoicr-init	Initialize workspace
invoicr-new	Create new client
invoicr-list	List clients
invoicr-bulk	Bulk generation
invoicr-export	Export history
invoicr-einvoice	Generate e-invoice
invoicr-server	Start API server
invoicr-gui	Launch desktop app

Common Options

Option	Description
--month=MM-YYYY	Billing month
--email	Create email draft
--dry-run	Preview only
--template=NAME	Use specific template

API Server

REST API for programmatic access.

invoicr-server  # Starts on http://localhost:3456

Key endpoints:

• GET /api/personas/:persona/clients - List clients
• POST /api/personas/:persona/invoice/generate - Generate invoice
• GET /api/einvoice/formats - List e-invoice formats

Configuration

See examples/ for complete client configuration templates:

• acme-hourly.json - Hourly billing
• acme-daily.json - Daily billing with translations
• acme-fixed.json - Fixed amount
• acme-romania.json - Romanian e-invoice (CIUS-RO)
• acme-xrechnung.json - German e-invoice (XRechnung)

Development

npm run build      # Compile TypeScript
npm test           # Run tests (700+ tests)
npm run dev        # Run with tsx
npm run api-server # Start API server

License

MIT

About

Built by LeanerCloud. We help companies reduce AWS costs.

Freelancer with AWS clients? Refer them to us and get 50% of our first invoice. Get in touch!