Infrastructure

    Invoicing that stays in your browser.

    Make GST invoices and keep simple books for your business, entirely inside your own browser.

    Dashboard
    01Overview

    What it is.

    Invoice is a free, offline-first invoicing and light-accounting app for Indian businesses.

    It makes GST invoices, tracks who owes you money, records purchases and stock, and prepares working papers for your accountant. There is no server and no account: your data stays in your browser.

    Built with
    • React 19
    • TypeScript
    • Vite 8
    • Zustand
    • CSS Modules
    • html-to-image
    • jsPDF
    LicenceMr. Chartist Non-Commercial Source License
    03Get it running

    Get it running.

    Let an AI do it for you

    Claude

    Best when you want architecture explanation, codebase understanding, and a clean implementation plan before edits.

    You need: Repo access, README context, Terminal if using Claude Code.

    How to use: Paste the prompt with the GitHub link. Ask Claude to read the README, map modules, list risks, and produce a practical plan before using Claude Code or another agent to implement.

    You are my setup assistant. Install and run "Invoice" on my computer, then confirm it works. I am not a developer, so explain every step in simple English.
    
    Repository: https://github.com/MrChartist/Invoice
    What it is: Make GST invoices and keep simple books for your business, entirely inside your own browser.
    Built with: React 19 + TypeScript + Vite 8 + Zustand + CSS Modules + html-to-image + jsPDF
    
    Rules
    1. Ask which operating system I use (Windows, macOS or Linux) and give commands for that system only.
    2. Check what is already installed (Git, Node.js or Python versions) before installing anything. If something is missing, tell me where to download it and wait.
    3. Ask me before installing anything globally or changing system settings.
    4. Never ask me to paste passwords or API keys into this chat. If a key is needed, tell me which file to put it in.
    5. Do not edit the project's source code unless I ask.
    6. Read the README first. If it disagrees with the steps below, follow the README and tell me why.
    
    Steps from the guide
    1. Install Node.js 22 or higher (nodejs.org). Older versions will not run the test suite.
    2. Clone: git clone https://github.com/MrChartist/Invoice.git && cd Invoice
    3. Install: npm install
    4. Start the dev server: npm run dev, then open http://localhost:5173.
    5. On first visit, choose a name and a PIN. Then open Settings and add your business profile: GSTIN, address, bank and UPI ID.
    6. Create your first invoice and use Preview to download the PDF. Optionally load the sample data from the Dashboard to explore, and remove it later.
    7. Open Settings, then Data & backup, and download a backup or connect a folder for automatic backups. Browser data is lost if you clear site data.
    8. Before changing code, run: npm run typecheck && npm run lint && npm test && npm run build.
    
    When the steps are done
    - Start the app and tell me the exact address to open. Expected address: http://localhost:5173
    - If an error appears, read it, fix the cause and retry. After three failed attempts, stop and explain the problem simply.
    - Finish with five short lines: what the app does, how to start it again, how to stop it, where its data is stored, and one thing I can try first.
    - This is an information tool. It is not investment advice.
    
    If you can run a terminal (Claude Code), do it yourself. If you are chat only, give me one command block at a time and wait for me to reply before the next.

    Or run it yourself

    You need Node.js 22 or higher; git; about 3 minutes; internet only for the first install.

    Open a terminal and run
    git clone https://github.com/MrChartist/Invoice.gitcd Invoicenpm installnpm run dev
    Then open http://localhost:5173 in your browser.
    04FAQ

    Questions about Invoice.

    Best next step

    Run it, then read the code.

    Run npm run dev, load the sample data, create one invoice and download the PDF. Then ask an AI to explain src/lib/invoice-calc.ts before touching any GST logic.

    Privacy settings

    Essential sign-in storage and your saved preferences stay enabled. Analytics is optional, and you can change your choice anytime.

    Turning analytics off clears our analytics cookies and local assistant metrics. The page reloads to stop a previously loaded analytics service. Your account and learning progress stay saved.

    Read the Privacy Policy