Skip to content

Michael-Obele/tif

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

72 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

πŸ› οΈ Tech Invoice Forge (TIF)

License: MIT Svelte Tailwind CSS Bun Offline First GitHub stars

Tech Invoice Forge is a professional-grade, offline-first invoice and receipt generator designed specifically for tech professionals. Unlike bloated SaaS solutions, TIF runs entirely in your browser, providing instant PDF generation without accounts, subscriptions, or backend dependencies.

Live Demo | Report Bug | Request Feature


Dashboard Preview

πŸ†š Why Tech Invoice Forge?

Feature Tech Invoice Forge Invoice Ninja Wave FreshBooks
Offline-First βœ… 100% Client-Side ❌ Cloud Required ❌ Cloud Only ❌ Cloud Only
Privacy βœ… Local IndexedDB ⚠️ Cloud Storage ⚠️ Cloud Storage ⚠️ Cloud Storage
No Account βœ… Zero Signup ❌ Account Required ❌ Account Required ❌ Account Required
Cost βœ… Free & Open Source πŸ’° Paid Tiers πŸ’° Paid Features πŸ’° Subscription
Instant PDF βœ… Real-time (<100ms) ⚠️ Delayed Generation ⚠️ Delayed Generation ⚠️ Delayed Generation

πŸš€ Key Features

  • ⚑ Real-time Forge: Watch your PDF update instantly as you type.
  • πŸ›‘οΈ Local Persistence: All data stored in your browser's IndexedDB. Zero server tracking.
  • πŸ’° Smart Calculations: Automatic handling of taxes, discounts, and currencies.
  • πŸ“„ Professional PDFs: High-precision vector PDFs powered by pdfmake.
  • πŸ‘₯ Client Management: Save and manage your client roster for one-click billing.
  • πŸ“± Responsive: Built with Tailwind CSS v4 for mobile, tablet, and desktop.
  • πŸŒ™ Dark Mode: "Slate Professional" theme designed for eye comfort.

Invoice History

Invoice History All your invoices are stored locally in your browser.


πŸ—οΈ How It Works

  1. Create Invoice: Fill in client details, line items, and payment terms.
  2. Live Preview: See the PDF update instantly as you type.
  3. Save Locally: Your invoice is auto-saved to your browser.
  4. Export: Download the PDF or JSON data anytime.

🧰 The Tech Stack

Category Technology
Framework Svelte 5 (Runes)
Meta-Framework SvelteKit 2
Styling Tailwind CSS v4
Database Native IndexedDB
Validation Valibot
PDF Engine pdfmake
Iconography Lucide Svelte
Components shadcn-svelte
Utilities Mode Watcher, Svelte Sonner
Runtime Bun

βš™οΈ Getting Started

Prerequisites

  • Bun (Recommended) or Node.js 20+

Installation

# Clone the repository
git clone https://github.com/Michael-Obele/tif.git

# Navigate to the project directory
cd tif

# Install dependencies
bun install

Development

Start the development server with hot-reloading: ❓ Frequently Asked Questions

Is my data really private? Yes! TIF uses IndexedDB which stores data ONLY in your browser. No data is ever transmitted to any server. You have complete control and ownership.
Can I export my data? Absolutely. You can export invoices as PDFs and client data as JSON. Use the Export button in the invoice history view.
Does it work offline? Yes! Once loaded, TIF works completely offline.

πŸ”§ Troubleshooting

Details We welcome contributions! Please see our guidelines below:
  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. eck if your browser is in Private/Incognito mode, which doesn't persist IndexedDB data. Use regular browsing mode.

bun dev

Visit http://localhost:5173 to start forging.


πŸ—οΈ Architecture

TIF uses a Local-First Architecture. There is no backend API.

  • Storage: All data is persisted in the browser's IndexedDB.
  • Logic: Svelte 5 Runes manage reactive state for sub-100ms UI interactions.
  • Validation: Valibot ensures data integrity before persistence.
  • Rendering: PDF generation is handled in a separate thread/module to maintain 60FPS UI performance.

🀝 Contributing

Contributions are what make the open-source community an amazing place to learn, inspire, and create.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ‘€ Author

Michael Obele


πŸ“„ License

Distributed under the MIT License. See LICENSE for more information.


Built with ❀️ for the Tech Community by Tech Invoice Forge

About

Tech Invoice Forge is a professional-grade, offline-first invoice and receipt generator designed specifically for tech professionals. Unlike bloated SaaS solutions, TIF runs entirely in your browser, providing instant PDF generation without accounts, subscriptions, or backend dependencies.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors