Skip to content

IamRamgarhia/Free-GST-Billing-Software

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

53 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Free GST Billing Software — 100% Free, No Subscription, No Limits

The only GST invoicing software you'll never have to pay for.

License: MIT Platform Version GitHub Stars

Create GST-compliant invoices, file GSTR-1 & GSTR-3B, track expenses, manage inventory — all without paying a single rupee. Ever.

Your data never leaves your computer. No cloud. No signup. No tracking. No limits.

Download Now  |  View Demo  |  Report Bug  |  Request Feature


Why Choose Free GST Billing Software?

Most billing software in India — Zoho Invoice, Vyapar, Tally, myBillBook — charges you monthly, stores your financial data on their servers, and locks you in. Free GST Billing Software is the open-source alternative that changes everything.

  • Completely free — no subscription, no premium tier, no hidden charges, no "free trial" that expires
  • 100% offline — runs on localhost, works without internet after installation
  • Your data stays on YOUR computer — invoices, GSTIN, bank details, client records stored as local JSON files. No cloud, no third-party servers
  • GST compliant — auto-calculates CGST/SGST/IGST, generates GSTR-1 & GSTR-3B data, exports JSON for GST portal upload
  • Self-file your GST returns — built-in step-by-step filing guide so you don't need a CA for basic filing
  • Install once, use forever — MIT licensed, open-source, community-driven

If you're paying for billing software, you can stop now.


Key Features

🧾 Invoicing & Billing

Feature Details
5 Invoice Types Tax Invoice, Proforma/Estimate, Bill of Supply, Credit Note, Delivery Challan
Auto GST Calculation CGST + SGST for intra-state, IGST for inter-state — calculated automatically from state codes
HSN/SAC Codes Add HSN or SAC codes per line item with correct tax rates
UPI QR Code Auto-generated QR code on every invoice from your UPI ID
Multi-Currency Bill in INR, USD, EUR, GBP, AUD, CAD, SGD, AED with proper formatting
3 PDF Styles Professional, high-quality multi-page PDF export with customizable layout
Amount in Words Indian format (Crore, Lakh) for INR, international format (Million, Thousand) for foreign currencies
Quotation to Invoice Convert any Proforma/Estimate to Tax Invoice in one click
Auto-Save Invoice data auto-saves as you type — never lose work mid-invoice
Custom Invoice Numbers Branded prefix, separator style, financial year, zero-padded digits
Private Internal Notes Add notes only you can see (not printed on the PDF)
Rich-Text Extra Pages Attach formatted content (tables, lists, scope of work) as additional PDF pages

📋 GST Compliance & Filing

Feature Details
GSTR-1 Data B2B invoices (with GSTIN), B2C aggregated by tax rate, HSN summary, Credit Notes, Document Summary (Table 13)
GSTR-3B Computation Output tax liability, Input Tax Credit from expenses, net tax payable — ready to copy into GST portal
GSTR-1 JSON Export Download NIC-format JSON file and upload directly to gst.gov.in
CSV Exports Download B2B, B2C, and HSN reports as CSV for your CA or portal upload
Step-by-Step Filing Guide Interactive walkthrough for filing GSTR-1 and GSTR-3B on the GST portal
NIL Return Guide Auto-detects zero-activity periods with instructions for filing NIL returns
E-Way Bill JSON Download NIC-format JSON for e-way bill portal upload (goods > Rs.50,000)
Filing Checklist Interactive checklist with progress tracking, deadlines, and penalty info

💼 Business Management

Feature Details
Client Ledger Save clients with GSTIN, track outstanding amounts, view payment history
Product Catalog Save products with HSN/SAC, rate, GST %, unit, stock quantity — auto-fills during invoicing
Stock Management Auto-deducts stock on invoice creation, restores on deletion, low stock tracking
Expense Tracker Record expenses with category, vendor, GST % for automatic ITC calculation
Recurring Invoices Templates for retainer clients — weekly, monthly, quarterly, yearly with auto-advance
Payment Receipts & Vouchers Generate payment receipts linked to invoices with amount in words
Purchase Bills Record purchase invoices for ITC tracking and expense management
Multi-Business Profiles Switch between multiple businesses with separate GSTIN, bank details, logo, signature

📊 Reports & Analytics

Feature Details
Profit & Loss Statement Revenue vs. expenses breakdown (excluding GST) with net profit/loss and margin %
Monthly P&L Breakdown Month-by-month financial performance
Outstanding & Aging Track unpaid invoices with auto-overdue detection and days overdue counter
Low Stock Alerts Monitor inventory levels across your product catalog
GST Return Summaries GSTR-1, GSTR-3B, HSN summaries auto-generated from your invoices and expenses
Dashboard Stats Total revenue, tax collected, invoice count, outstanding amount at a glance

📤 Sharing & Export

Feature Details
PDF Download High-quality, multi-page PDF with auto page numbering
WhatsApp Sharing Share invoices directly via WhatsApp (desktop app or web, auto-detected)
Email One-click email with invoice summary
Google Drive Auto-Upload PDFs auto-upload to Google Drive after download (optional)
Full Data Backup/Restore Export all data as JSON, import on any machine
CSV Import Bulk import clients and products from CSV files
Mobile Web Share Web Share API attaches PDF to WhatsApp or any app on mobile

⚙️ Customization

Feature Details
15 Invoice Display Toggles Show/hide GST, State, GSTIN, Place of Supply, HSN Code, Discount, Bank Details, UPI QR, Logo, Signature, Terms, Notes, Amount in Words, Due Date, Item Quantity
Custom Invoice Numbering Branded prefix, separator (/ - #), financial year toggle, starting number, digit padding
Terms & Conditions Templates Save and reuse multiple T&C templates
Multi-Business Profiles Separate profiles with different GSTIN, bank details, logo, signature
Dark Mode Full dark theme with automatic persistence
PWA Installable Install as a standalone desktop app via Chrome or Edge — opens instantly, no browser needed

Quick Start / Installation

Prerequisites

  • Node.js 18+ (only needed for developer setup)
  • Windows 10/11 (recommended — includes one-click installer)

Option 1: Windows Installer (Recommended — No Coding Needed)

  1. Download the ZIP from Releases or click here
  2. Extract the folder anywhere on your computer
  3. Double-click Install FreeGSTBill.bat
  4. The app opens automatically in your browser at http://localhost:3001

That's it. No terminal. No commands. The app starts automatically when you turn on your PC. A desktop shortcut and Start Menu entry are created for you.

Option 2: Developer Setup

git clone https://github.com/IamRamgarhia/Free-GST-Billing-Software.git
cd Free-GST-Billing-Software
npm install

# Windows
npm run dev:win

# macOS / Linux
npm run dev

Dev server: http://localhost:5173 | API: http://localhost:3001

Production build:

npm run build && npm start

Install as Desktop App (PWA)

  1. Open http://localhost:3001 in Chrome or Edge
  2. Click the Install App banner (or the install icon in the address bar)
  3. Done — the app opens in its own window, no browser tab needed

How to Self-File GST Returns

Free GST Billing Software auto-generates all the data you need for GSTR-1 and GSTR-3B filing. Here's the workflow:

Step 1 ──► Enter invoices throughout the month as you normally would
              │
Step 2 ──► Go to GST Returns page → Review GSTR-1 data (B2B, B2C, HSN, Credit Notes)
              │
Step 3 ──► Export GSTR-1 JSON → Upload directly to gst.gov.in
              │
Step 4 ──► Review GSTR-3B summary → Copy figures into the GST portal and file
              │
Step 5 ──► Mark the return as filed to track your compliance status

The app includes a step-by-step interactive filing guide with screenshots and tips for both GSTR-1 and GSTR-3B. It even covers NIL return filing for months with no activity.

No CA needed for basic GST filing. The app does all the calculations — you just upload and confirm.


Tech Stack

Layer Technology
Frontend React 19, Vite 7
Backend Express 5 (Node.js)
PDF Generation jsPDF + html2canvas
Icons Lucide React
QR Codes qrcode
Security DOMPurify (XSS protection)
Storage File-based JSON — no database needed
Offline PWA with service worker caching

No database. No Docker. No cloud setup. Clone, install, run. Your data lives in a simple data/ folder as plain JSON files.


Roadmap

🚀 Coming Soon (Next Release)

  • WhatsApp Business API integration — send invoices directly via WhatsApp
  • POS / Thermal printer billing mode
  • Barcode scanning for products
  • Multi-user access with roles (admin, billing, view-only)

📆 Planned Features

  • E-Invoicing (IRN) — generate Invoice Reference Number via IRP portal
  • Direct GST Filing — file GSTR-1 and GSTR-3B from the app without visiting the portal
  • GSTR-2A/2B Reconciliation — match purchase invoices with supplier-filed data
  • Bank Statement Import — import and reconcile bank transactions
  • Automatic Payment Reminders — SMS + WhatsApp reminders for overdue invoices
  • Android & iOS Mobile App — native apps for billing on the go
  • Tally Data Import/Export — migrate from Tally seamlessly
  • Multi-Language Support — Hindi, Tamil, Telugu, Gujarati, Marathi
  • AI-Powered Expense Categorization — auto-classify expenses using AI
  • Shopify / WooCommerce Integration — sync orders and generate invoices
  • Customer Self-Service Portal — shareable link for clients to view and pay invoices
  • Bulk E-Invoicing — generate IRN for multiple invoices at once
  • Advanced Inventory — batch tracking, expiry dates, warehouse management
  • Payroll & Salary Management — employee salary processing with TDS
  • Balance Sheet & Cash Flow Reports — complete financial reporting

💡 Community Requested

  • Party-wise discount settings
  • Multiple price lists (wholesale / retail)
  • Sales order & purchase order workflows
  • Item size / color variants
  • Digital signature on invoices (DSC integration)
  • Industry-specific templates (medical, retail, restaurant, construction)
  • Multi-GSTIN support (multiple GST registrations)
  • Branch-wise reporting

Want a feature? Open an issue and let us know.


Who Is This For?

Who How They Use It
Freelancers & Consultants Invoice clients for projects, retainers, hourly work. Bill international clients in USD/EUR/GBP.
Small Shops & Retail Stores Quick bill generation with UPI QR code for instant payment. Stock tracking and low-stock alerts.
Service Businesses (IT, consulting, design) Professional tax invoices with HSN/SAC codes. Recurring invoices for retainer clients.
Manufacturers & Traders GST tax invoices with HSN codes, delivery challans, e-way bill JSON, stock management.
Startups & New Businesses Zero-cost billing from day one. No commitment, no vendor lock-in.
CAs & Tax Consultants Generate invoices for advisory fees. Use GST filing tools and CSV exports for clients.
Exporters Multi-currency invoices with GST toggles for export billing.
Anyone Who Wants to Self-File GST Built-in filing guide replaces the need for a CA for basic GSTR-1 and GSTR-3B filing.

Why Is This Free?

Free GST Billing Software is built and maintained by DiceCodes. It is:

  • Open-source under the MIT license — fork it, modify it, use it commercially
  • Community-driven — features are built based on what users actually need
  • No hidden charges — no premium tier, no ads, no data collection, no signup wall
  • No vendor lock-in — your data is plain JSON files. Take them anywhere, anytime

We believe every business in India deserves professional billing software without paying monthly fees.


Data Privacy & Security

Question Answer
Where is my data stored? In a data/ folder on your computer as plain JSON files. No server, no cloud, no database.
Can anyone access my invoices? No. The app runs on localhost — not accessible from the internet or other computers.
What if I uninstall? Your data/ folder stays untouched. Reinstall anytime and everything is still there.
Do I need internet? Only for the first install (npm install). After that, everything works offline.
How do I backup? Settings → Export Data → save JSON file. Import on any machine.

Contributing

We welcome contributions from the community. Here's how you can help:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

You can also contribute by:

  • Reporting bugs via GitHub Issues
  • Suggesting features
  • Improving documentation
  • Sharing the project with other businesses

Google Drive Setup (Optional)

  1. Go to Google Cloud Console and create a project
  2. Enable the Google Drive API
  3. Create an OAuth 2.0 Client ID (Web application) under Credentials
  4. Add origin: http://localhost:5173
  5. Copy the Client ID into Settings in the app
  6. Click Connect Google Drive and authorize

PDFs will auto-upload to your Google Drive after every download.


Project Structure

Free-GST-Billing-Software/
├── server.js                     # Express API server (port 3001)
├── src/
│   ├── App.jsx                   # Root layout, sidebar navigation, dark mode
│   ├── store.js                  # API client for all data operations
│   ├── utils.js                  # Currency formatting, number-to-words, GST helpers
│   ├── components/
│   │   ├── Dashboard.jsx         # Invoice list, filters, stats, payment tracking
│   │   ├── InvoiceGenerator.jsx  # Create/edit invoices with live preview
│   │   ├── InvoicePreview.jsx    # Invoice PDF template
│   │   ├── ClientsView.jsx      # Client ledger & management
│   │   ├── InventoryView.jsx    # Product catalog & stock management
│   │   ├── ExpenseTracker.jsx   # Business expense tracking with ITC
│   │   ├── RecurringInvoices.jsx # Recurring invoice templates
│   │   ├── ReceiptVoucher.jsx   # Payment receipt generation
│   │   ├── ReportsView.jsx      # P&L reports & analytics
│   │   ├── GSTReturns.jsx       # GSTR-1, GSTR-3B, HSN reports, filing guide
│   │   ├── SettingsView.jsx     # Profile, templates, multi-business, backup
│   │   └── Toast.jsx            # Notification system
│   └── services/
│       └── googleDrive.js       # Google Drive OAuth & upload
└── data/                        # Local JSON storage (gitignored)

Contact & Support


License

This project is licensed under the MIT License — free to use, modify, and distribute.


Free GST Billing Software by DiceCodes

Free GST billing software India | GSTR-1 GSTR-3B filing software | Free invoice generator with GST | Offline billing software | No subscription billing app | GST invoice software for small business | Free billing app India | GST compliant invoice maker | Self-file GST returns software | Open source billing software India | Free alternative to Tally Vyapar Zoho | HSN SAC code invoice generator | CGST SGST IGST calculator | E-way bill software free | Credit note debit note software

Made in India 🇮🇳

About

Free GST Billing Software — Free, open-source GST invoice & billing software. Tax Invoice, Proforma, Credit Note, Bill of Supply. CGST/SGST/IGST. Multi-currency. 100% offline, no signup. PWA installable.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors