invoice-generator

# Invoice Generator Generate PDF invoices from structured JSON data. ## Setup 1. Install Node.js dependencies: ```bash cd invoice-generator && npm install ``` 2. Set `INVOICE_DIR` environment variable (or in `skills.entries.invoice-generator.env`): ```bash export INVOICE_DIR="/path/to/your/invoices" ``` This creates the directory structure: ``` $INVOICE_DIR/ ├── configs/ # Optional: saved invoice configs └── invoices/ # Generated PDF output ``` ## Usage ```bash # From stdin (on-the-fly) cat invoice-data.json | {baseDir}/scripts/generate.sh # From a full file path {baseDir}/scripts/generate.sh /path/to/invoice-data.json # From a saved config (looks in $INVOICE_DIR/configs/) {baseDir}/scripts/generate.sh client-template # Loads: $INVOICE_DIR/configs/client-template.json # Output goes to: $INVOICE_DIR/invoices/invoice-{number}.pdf (auto-versions if exists) ``` ## Input Data Format The JSON input must contain these fields: ```json { "company": { "name": "Your Company", "address": "123 Main St", "cityStateZip": "City, State, 12345", "country": "Country" }, "client": { "name": "Client Name", "address": "456 Client Ave", "cityStateZip": "City, State, 67890", "country": "Country", "taxId": "TAX123" }, "invoice": { "number": "INV-2025.01", "date": "Jan 15 2025", "dueDate": "Jan 30 2025" }, "items": [ { "description": "Service description", "rate": "1000.00", "currency": "USD" } ], "totals": { "currency": "USD", "total": "1,000.00" } } ``` See [references/data-schema.md](references/data-schema.md) for complete field documentation. ## Output The script outputs the path to the generated PDF file on success: ``` $INVOICE_DIR/invoices/invoice-INV-2025.01.pdf # If that filename already exists, the script will write: # $INVOICE_DIR/invoices/invoice-INV-2025.01-2.pdf (then -3, etc.) ``` ## Error Handling - Exits with code 1 if JSON is invalid or missing required fields - Exits with code 2 if weasyprint fails to generate PDF - Error messages are written to stderr