easy-invoice-pdf/README.md
2025-07-25 18:44:24 +02:00

77 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# [EasyInvoicePDF](https://easyinvoicepdf.com)
[EasyInvoicePDF](https://easyinvoicepdf.com) Free & Open-Source Invoice Generator | Live Preview, No Sign-Up, Runs in Your Browser.
❤️ Love EasyInvoicePDF? Help keep it free and open-source! [Buy me a coffee](https://buymeacoffee.com/vladsazon) to support new features, better templates, and continued maintenance. Even a small contribution makes a big difference. Thank you for being part of this journey! ✨
<img src=".github/screenshots/default-template.png" height="800" width="1200" alt="EasyInvoicePDF Default Template Screenshot" />
## Features
- **Live Preview**: See your invoice update in real-time as you make changes, ensuring it looks exactly how you want.
- **Shareable Links**: Generate links to share your invoices directly with clients without sending attachments.
- **Instant Download**: Download your invoice as a PDF file with one click, ready to be sent or printed.
- **Browser Only**: Runs entirely in your browser—no server-side processing or data storage. Your data stays private and secure.
- **Multiple Languages & Currencies**: Create invoices in multiple languages with support for all major currencies and automatic formatting.
- **European VAT Support**: Automatically calculate European VAT rates and totals for your invoices.
## Demo Video 🎥
Watch a quick demo of EasyInvoicePDF in action to see how easy it is to create professional invoices in seconds. The video demonstrates key features like live preview, instant PDF download, and customization options.
https://github.com/user-attachments/assets/9e3194e0-3072-4c95-ae99-e66db1301dc6
## Screenshots
<details open>
<summary>View Screenshots</summary>
<img src=".github/screenshots/default-template.png" width="1200" height="800"/>
<img src=".github/screenshots/stripe-template.png" width="1200" height="800"/>
<img src=".github/screenshots/default-invoice.png" width="1200" height="800"/>
<img src=".github/screenshots/stripe-invoice.png" width="1200" height="800"/>
</details>
## Tech Stack
- [React](https://react.dev/)
- [TypeScript](https://www.typescriptlang.org/)
- [Next.js](https://nextjs.org/)
- [TailwindCSS](https://tailwindcss.com/)
- [shadcn/ui](https://ui.shadcn.com/)
- [Origin UI](https://originui.com/)
- [@react-pdf/renderer](https://github.com/diegomura/react-pdf)
## Other Tools & Services
- Generate beautiful OG images: https://og.new
- Analytics: https://umami.is/
## Quick Start
- Run `pnpm i`
- Copy `.env.example to .env.local` (`cp .env.example .env.local`)
- Run `pnpm run dev`
For the full app experience, youll need to obtain and set values from the following services:
- [Resend](https://resend.com/)
- [Upstash](https://upstash.com/)
- [Google Drive API](https://developers.google.com/workspace/drive/api/quickstart/js)
- [Telegram Bot API](https://core.telegram.org/bots)
## License
This project is dual-licensed:
- **AGPL-3.0** (for open-source or compliant use): [GNU AGPL v3](https://www.gnu.org/licenses/agpl-3.0.html)
- **Commercial license** (for proprietary use): contact [vlad@mail.easyinvoicepdf.com](mailto:vlad@mail.easyinvoicepdf.com)
By using this software, you agree to the terms of the applicable license.
## GitAds Sponsored
<!-- GitAds-Verify: JHXPD28PWARXHPOAHBA7ZTVRIFBKGZPE -->
Ads help support this project 🙏
[![Sponsored by GitAds](https://gitads.dev/v1/ad-serve?source=vladsez/easy-invoice-pdf@github)](https://gitads.dev/v1/ad-track?source=vladsez/easy-invoice-pdf@github)