https://github.com/streamlit/example-app-invoice-generator

https://github.com/streamlit/example-app-invoice-generator

Last synced: 2 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/streamlit/example-app-invoice-generator
• Owner: streamlit
• License: apache-2.0
• Created: 2022-03-30T13:43:49.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2022-03-31T10:25:59.000Z (over 3 years ago)
• Last Synced: 2025-04-05T05:33:31.254Z (3 months ago)
• Language: HTML
• Size: 12.7 KB
• Stars: 18
• Watchers: 10
• Forks: 12
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 💰 Invoice Generator

A Streamlit app to show how you can easily use Streamlit to generate invoices as PDFs.

[![Streamlit App](https://static.streamlit.io/badges/streamlit_badge_black_white.svg)](https://share.streamlit.io/streamlit/example-app-invoice-generator/main)

    

        App screenshot

        Invoice template

    

    

        

        

        

        

    

### How to run this demo

The demo has been deployed using Python 3.7. **We suggest creating a new virtual environment**, then running:

```

git clone https://github.com/streamlit/example-app-invoice-generator.git

cd example-app-invoice-generator

pip install -r requirements.txt

streamlit run streamlit_app.py

```

### About the app

- Code is powered by  Streamlit 🎈 and deployed on [Streamlit Cloud](https://streamlit.io/cloud) ☁️

- It is super compact: only 50 lines of code. Check it out in [`streamlit_app.py`](https://github.com/streamlit/example-app-invoice-generator/blob/main/streamlit_app.py)

### About the template

   

- Template must be an HTML file with {{ my_variable }} variable placeholders as supported by [jinja](https://jinja.palletsprojects.com/en/3.1.x/). 

- Our example template here is [`invoice_template.html`](https://github.com/streamlit/example-app-invoice-generator/blob/main/invoice_template.html) and you can see placeholders e.g. [here](https://github.com/streamlit/example-app-invoice-generator/blob/main/invoice_template.html#L329).

   

🪄 Tip: if you're not an HTML expert (or if you're lazy, or both) just kick-off your template using Google Docs at docs.new and then export it as HTML using File > Download > Web page (.html, zipped). For example, this is our original  template in Google Docs!


### Questions? Comments?

Please ask in the [Streamlit community](https://discuss.streamlit.io).