README.md

Invoice

Generate invoices from the command line.

Text-based User Interface

invoice

Command Line Interface

# Generate an invoice from information.
invoice generate --title "Invoice" \
    --id 2 \
    --logo ./images/logo.png \
    --from "Dream, Inc." \
    --to "Imagine, Inc." \
    --date "June 10, 2023" \
    --due "June 30, 2023" \
    --tax 0.13 \
    --discount 0.15 \
    --currency USD \
    --item "Rubber Duck" \
    --quantity 2 \
    --rate 25 \
    --notes "For debugging purposes."

Save repeated information with environment variables:

export INVOICE_LOGO=/path/to/image.png
export INVOICE_FROM="Dream, Inc."
export INVOICE_TO="Imagine, Inc."
export INVOICE_TAX=0.13
export INVOICE_RATE=25

Generate new invoice:

invoice generate \
    --item "Yellow Rubber Duck" --quantity 5 \
    --item "Special Edition Plaid Rubber Duck" --quantity 1 \
    --notes "For debugging purposes."

Installation

Install with Go:

go install github.com/maaslalani/invoice@main

Or download a binary from the releases.

License

MIT

Feedback

I'd love to hear your feedback on improving invoice.

Feel free to reach out via:


zzz