Django Invoicing App Template with PostgreSQL

A free, open-source invoicing app for freelancers and small businesses, built with Django 5.2 LTS, Python 3.12, PostgreSQL, htmx and Tailwind CSS. It covers quotes clients accept online, VAT invoices with a rate per line in ten currencies, a signed client page with an A4 PDF, bank details and optional Stripe card payment, part payments, credit notes, recurring invoices, aged receivables and CSV exports for your accountant.

by Light CloudInvoicing and finance

Build an invoicing app with Django and PostgreSQL

Dashboard with outstanding, overdue and paid this month in euros, pounds and dollars kept apart, overdue invoices, aged receivables and cash per month
Dashboard with outstanding, overdue and paid this month in euros, pounds and dollars kept apart, overdue invoices, aged receivables and cash per month, on a phone

Features

  • Invoices with saved items, a discount and VAT rate per line (Irish 23%, 13.5%, 9% and 0%, reverse charge and outside the scope) and VAT per rate
  • Numbers such as INV-2026-0042 given only when a document is sent, under a row lock so there are no gaps, and sent invoices voided or credited, never edited
  • Quotes clients accept or decline from their link, then turn into a draft invoice in one click
  • A signed client page per document with the amount due, bank details and an A4 PDF drawn with fpdf2 with its font embedded
  • Pay by card through Stripe Checkout once STRIPE_SECRET_KEY is set, recorded once when the client returns or by webhook
  • Part payments that can never exceed what is owed, credit notes from an invoice, and monthly or quarterly recurring drafts with month-end handling
  • Dashboard per currency with outstanding, overdue and paid totals, aged receivables in 30-day bands and cash per month, plus CSV for a month, VAT period or year
  • A Galway Video Production demo with 21 clients, 55 invoices and 43 payments, removed in one click, and WCAG 2.2 AA in light and dark

Tech stack

What you need

  • A paid plan: deploying creates a PostgreSQL database, which the Free plan does not include
  • To run it locally: Python 3.12 with pip, and Docker for a local PostgreSQL; the CSS build downloads the Tailwind CLI once
  • No API keys: it starts with nothing to configure, and clients pay by bank transfer from their invoice link
  • Optional: STRIPE_SECRET_KEY for Pay by card, and STRIPE_WEBHOOK_SECRET to record payments when the client closes the tab
  • Optional: RESEND_API_KEY and EMAIL_FROM to email invoices and quotes with the PDF attached, and overdue reminders

About

Business and bank details, numbering and VAT rates are set in the app under Settings, currencies are in invoicing/money.py, and the wording of documents, PDFs and emails is in templates/invoicing/partials/paper.html, invoicing/pdf.py and invoicing/mail.py. Money is stored as whole cents and statuses such as overdue or part paid are worked out from dates and payments each time, so nothing runs overnight; recurring drafts are made when someone opens the dashboard, invoices or recurring pages, not by a scheduler, and they are never sent automatically. Stripe's webhook signature check and recording a payment once are tested, but creating a Checkout session has never been called against Stripe's live API, and email through Resend has not been tested with a real key. The VAT rates and reverse-charge wording are a starting point, not legal or tax advice, and it does not prepare VAT returns: export the CSV for your accountant. Whoever signs up first becomes the owner of the demo and the Django admin, and after that sign-up needs an invitation, so create the owner account straight after deploying; client links and emails use APP_URL, which Light Cloud sets at each deploy.

FAQ

Is there a free, open-source invoicing app built with Django?

Yes. This one is MIT licensed and built with Django 5.2 LTS, PostgreSQL and htmx. Without any keys every invoicing feature works: clients pay by bank transfer from their link and you send the link yourself.

How do I generate invoice PDFs in Django?

This template draws them on the server with fpdf2 in invoicing/pdf.py, from the same view model as the web page, so the PDF and the page always agree. The font is embedded, so euro and pound signs and Irish fadas print correctly.

How do clients pay an invoice online with Stripe?

Set STRIPE_SECRET_KEY and every unpaid invoice's client page shows Pay by card, which opens Stripe Checkout for what is still owed. The session is read back from Stripe when the client returns and the payment is recorded once; add STRIPE_WEBHOOK_SECRET to record it even if they close the tab.

Does it handle Irish and EU VAT, credit notes and numbering?

Yes. Each line has a VAT rate, VAT is shown per rate, both VAT numbers are printed, reverse charge and outside-the-scope wording is added, numbers run per year without gaps, and mistakes are fixed with a void or a credit note. It does not file VAT returns, and its wording is not tax advice.

Can it send recurring invoices automatically?

Not by itself. A monthly or quarterly schedule makes a draft on the right date, including month ends such as 28 February, for you to check and send. Drafts appear when someone opens the dashboard, invoices or recurring pages, and you can pause, resume or delete each schedule.

Price
Free
Framework
Django · Python
Updated

Variables

  • DJANGO_SECRET_KEYGenerated