Skip to content

kunal-gswm/LocalInvoice

Repository files navigation

========================================
  LocalInvoice — GST Billing App
  For Local Stationery Shops in India
========================================

WHAT IS THIS?
  LocalInvoice is a simple billing app that runs
  in your web browser. No internet needed after
  first use. No installation required.

HOW TO START:
  1. Double-click "index.html" to open the app
  2. It will open in your default browser
     (Chrome, Edge, or Firefox recommended)

FIRST TIME SETUP:
  1. Click "Settings" (top-right corner)
  2. Fill in your shop details:
     - Shop Name
     - Shop Address
     - GST Number
     - UPI ID (for QR code payments)
     - Bank Name, Account Number, IFSC
     - Account Holder Name
  3. Click "Save Settings"
  4. These details will auto-fill on every new invoice

HOW TO CREATE AN INVOICE:
  1. Click "New Invoice"
  2. Enter customer name (required)
  3. Enter customer phone (optional)
  4. Add items:
     - Type item name — suggestions will appear
     - Select from suggestions OR type a new item
     - Enter quantity and price (the shelf price)
     - GST is auto-calculated from the price
  5. Click "Save Draft" to save and edit later
     OR click "Finalise & Print" to lock and print

IMPORTANT NOTES:
  - All prices you enter are FINAL prices (GST included)
  - The app calculates base price and GST automatically
  - CGST and SGST are split equally
  - Invoice numbers (LI-0001, LI-0002...) never repeat
  - Final invoices CANNOT be edited
  - Cancelled invoices are kept for records (never deleted)

KEYBOARD SHORTCUTS:
  Ctrl + S  =  Save Draft
  Ctrl + P  =  Print Invoice
  Enter     =  Move to next field / Add new item row
  Tab       =  Move between fields

BACKUP YOUR DATA:
  1. Go to "History" page
  2. Click "Export Backup" — saves a .json file
  3. Keep this file safe (on USB drive, etc.)
  4. To restore: Click "Import Backup" and select the file

WHERE IS MY DATA STORED?
  All data is stored in your browser's local storage.
  It stays on YOUR computer — nothing is sent online.

  WARNING: If you clear your browser data or use a
  different browser, your invoices will not appear.
  Always keep backups!

FILES IN THIS FOLDER:
  index.html  — The app (open this to use)
  items.json  — List of 88 pre-loaded stationery items
                with correct GST rates (reference only)
  README.txt  — This file

NEED HELP?
  - Make sure you are using a modern browser
    (Chrome, Edge, or Firefox)
  - If items are missing, check that you haven't
    cleared your browser data
  - Use "Export Backup" regularly to protect your data

========================================
  GST rates as per 56th GST Council
  meeting (effective September 2025)
========================================

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors