kunal-gswm/LocalInvoice
Folders and files
| Name | Name | Last commit date | ||
|---|---|---|---|---|
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)
========================================