https://github.com/anooppandikashala/invoiso
Create professional PDF invoices, manage clients and products, and run your billing entirely offline on Windows, Linux & macOS - no subscription, no cloud, no account needed.
https://github.com/anooppandikashala/invoiso
apple dart flutter- flutter-desktop free gst invoice invoice-generator invoice-generator-app invoicing-application invoicing-software linux macos material-design offline open-source pdf-generator upi-qr-code windows
Last synced: 11 days ago
JSON representation
Create professional PDF invoices, manage clients and products, and run your billing entirely offline on Windows, Linux & macOS - no subscription, no cloud, no account needed.
- Host: GitHub
- URL: https://github.com/anooppandikashala/invoiso
- Owner: Anooppandikashala
- License: mit
- Created: 2025-07-15T15:49:54.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-05-15T05:41:45.000Z (17 days ago)
- Last Synced: 2026-05-15T07:39:29.662Z (17 days ago)
- Topics: apple, dart, flutter-, flutter-desktop, free, gst, invoice, invoice-generator, invoice-generator-app, invoicing-application, invoicing-software, linux, macos, material-design, offline, open-source, pdf-generator, upi-qr-code, windows
- Language: Dart
- Homepage: https://invoiso.co.in/
- Size: 10 MB
- Stars: 8
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
Invoiso
Free offline invoice & billing software for Windows, Linux & macOS
Create professional PDF invoices, track payments, manage customers, products and inventory — entirely offline. Built for small businesses, shops and freelancers. No subscription, no cloud, no account needed.
🌐 Website ·
⬇️ Download ·
❓ FAQ ·
🐛 Report a Bug
---
## ✨ Features
### Invoicing
- **100% Offline** — All data stored locally in SQLite. No internet required, ever.
- **PDF Invoice Generation** — One-click professional PDFs in Classic, Modern, or Minimal templates.
- **Invoice & Quotation** — Create both invoice and quotation documents with colour-coded status tracking.
- **Invoice Cloning** — Duplicate any invoice or quotation in one click.
- **Bulk Actions** — Multi-select invoices to bulk export CSV, generate PDFs, or move to trash.
- **Soft Delete / Trash** — Deleted invoices go to a recoverable Trash view.
- **CSV Export** — Export invoice data to CSV for spreadsheets or accounting software.
### Payment Tracking
- **Payment Recording** — Record multiple partial or full payments against any invoice.
- **Payment Status** — Automatic Unpaid / Partial / Paid tracking with colour-coded chips.
- **Payment Receipts** — Download a professional PDF receipt for every payment.
- **Outstanding Balance** — Running balance calculated and shown across all views.
- **PDF Payment Summary** — Invoice PDFs show Amount Paid, Amount Due, and a PAID IN FULL stamp.
### Finance & Compliance
- **Multi-Currency** — INR, USD, EUR, GBP, JPY, AED, SGD, AUD, CAD — stored per invoice.
- **GST Ready** — GSTIN fields, HSN codes, per-item or global tax rates for Indian businesses.
- **UPI Payment QR** — Embed a scannable UPI QR code in every PDF (GPay, PhonePe, Paytm).
### Data Management
- **Customer Management** — Full CRUD with search, sort, and pagination.
- **Product & Inventory Management** — Full CRUD with search, sort, and pagination.
- **Backup & Restore** — One-click database backup to any location on your machine.
### Security & Access Control
- **Multi-User Login** — Username and password authentication with session timeout.
- **Role-Based Access** — Admin and standard user roles with separate permissions.
- **Admin-Only Actions** — Company settings, PDF settings, backup/restore, and all deletes restricted to admins.
- **Forced Password Change** — New users must change their password on first login.
### General
- **No Registration** — No account, no email, no cloud sync required.
- **Free Forever** — MIT licensed, open source.
---
## 📸 Screenshots
| Dashboard | Create Invoice | Invoice PDF |
|:---------:|:--------------:|:-----------:|
|  |  |  |
| Classic Template | Modern Template | Minimal Template |
|:---------------:|:---------------:|:----------------:|
|  |  |  |
---
## 🔐 Default Login
| Username | Password |
|----------|----------|
| `admin` | `admin` |
> You will be prompted to change the password on first login.
---
## ⬇️ Download
**Latest version: v3.4.2**
| Platform | Format | Link |
|----------|--------|------|
| **Windows** | `.exe` Installer | [Download v3.4.2](https://invoiso.co.in/download.html) |
| **Linux** | `.AppImage` (portable) | [Download v3.4.2](https://invoiso.co.in/download.html) |
| **Linux** | `.deb` Package | [Download v3.4.2](https://invoiso.co.in/download.html) |
| **macOS** | `.dmg` Installer | [GitHub Releases](https://github.com/Anooppandikashala/invoiso/releases/latest) |
### Linux Quick Install
Use the DEB option for Ubuntu 22.04 or 24.04:
```bash
curl -fsSL https://invoiso.co.in/install.sh | bash -s -- --deb
```
Use the AppImage option for other Linux distributions or when you want a portable app:
```bash
curl -fsSL https://invoiso.co.in/install.sh | bash -s -- --appimage
```
The quick-install script downloads the latest release from GitHub. DEB installs through `apt-get`; AppImage is saved to `~/Applications`.
> Always download from the [official website](https://invoiso.co.in/download.html) or the [GitHub releases page](https://github.com/Anooppandikashala/invoiso/releases/latest).
---
## 🛠️ Build from Source
### Prerequisites
- [Flutter SDK](https://flutter.dev/docs/get-started/install) `>=3.3.3 <4.0.0`
- Linux: `clang`, `cmake`, `ninja-build`, `libgtk-3-dev`
- Windows: Visual Studio 2022 with "Desktop development with C++" workload
- macOS: Xcode 14+, CocoaPods
### Steps
```bash
# 1. Clone the repository
git clone https://github.com/Anooppandikashala/invoiso.git
cd invoiso
# 2. Install dependencies
flutter pub get
# 3. Run in debug mode
flutter run -d linux # Linux
flutter run -d windows # Windows
flutter run -d macos # macOS
# 4. Build a release binary
flutter build linux --release # Linux
flutter build windows --release # Windows
flutter build macos --release # macOS
```
Output locations:
- **Linux:** `build/linux/x64/release/bundle/`
- **Windows:** `build/windows/x64/runner/Release/`
- **macOS:** `build/macos/Build/Products/Release/invoiso.app`
---
## 🏗️ Tech Stack
| Layer | Technology |
|-------|-----------|
| Framework | [Flutter](https://flutter.dev) 3.x (Dart) |
| Database | SQLite via [sqflite](https://pub.dev/packages/sqflite) + [sqflite_common_ffi](https://pub.dev/packages/sqflite_common_ffi) |
| PDF Generation | [pdf](https://pub.dev/packages/pdf) + [printing](https://pub.dev/packages/printing) |
| PDF Preview | [syncfusion_flutter_pdfviewer](https://pub.dev/packages/syncfusion_flutter_pdfviewer) |
| QR Codes | [qr](https://pub.dev/packages/qr) |
| State Management | [flutter_riverpod](https://pub.dev/packages/flutter_riverpod) |
| File Picker | [file_picker](https://pub.dev/packages/file_picker) |
| CSV Export | [csv](https://pub.dev/packages/csv) |
| File Sharing | [share_plus](https://pub.dev/packages/share_plus) |
| Image Processing | [image](https://pub.dev/packages/image) |
| Window Management | [window_manager](https://pub.dev/packages/window_manager) |
| Security | [crypto](https://pub.dev/packages/crypto) |
---
## 📁 Project Structure
```
lib/
├── main.dart # App entry point and window setup
├── common.dart # Shared enums, extensions, data classes
├── constants.dart # UI constants, spacing, font sizes
├── invoiso_colors.dart # App colour palette
├── backup/ # Backup and restore logic
├── database/ # SQLite init, migrations, CRUD services
├── models/ # Invoice, payment, customer, product, user models
├── providers/ # Riverpod state providers
├── screens/ # Login, dashboard, invoice, settings, admin screens
├── services/ # PDF, receipt, export, update services
├── utils/ # Logging, formatting, passwords, sessions, errors
└── widgets/ # Shared dialogs, buttons, update UI
```
---
## 🤝 Contributing
Contributions, bug reports, and feature requests are welcome.
1. **Fork** the repository
2. **Create** a feature branch: `git checkout -b feature/your-feature`
3. **Commit** your changes: `git commit -m "Add your feature"`
4. **Push** to the branch: `git push origin feature/your-feature`
5. **Open a Pull Request**
For bug reports and feature requests, please use [GitHub Issues](https://github.com/Anooppandikashala/invoiso/issues).
---
## 📄 License
Invoiso is released under the [MIT License](LICENSE).
Copyright © 2025 [Anoop Pandikashala](https://github.com/Anooppandikashala)
---
If Invoiso saves you time, consider supporting its development.
[](https://www.buymeacoffee.com/anoopp)