Simple invoicing webapplication using HTML templates. The goal of the application is to be an invoice pdf creator, with some minor customer-database features.
I recommend using a virtualenv. See this guide for a great explanation.
Requirements are collected in the requirements.txt file.
pip install -r requirements.txt
You'll also need wkhtmltopdf
, which is used by pdfkit.
apt-get install wkhtmltopdf
or your equivalent packagemanager.
Configuration can be done in the faktura.cfg file, where you can change the sql uri used by sqlalchemy. By default it will use a sqllite database, so you don't have to do anything. Generated pdfs are saved in the pdfs/
folder.
If you're running this on a VPS, you'll likely need xvfb
as a virtual x-server.
Check out Server.md for a short how-to install for debian
To start the http-server as a standalone flask application:
python runserver.py
After you've got the application running, simply navigate to http://127.0.0.1:5000
The PDF is currently created from the render.html template. Change the look of the invoice by editing that document. A proper template editor is a future feature.
See TODO.md. Ideas at IDEAS.md
Thanks to the following frameworks and resources:
- Flask
- flask-sqlalchemy
- flask-login
- pdfkit
- skeleton css framework
- flat circle-icons from elegantthemes.com
- http://pixabay.com for cat pictures under creative commons