Gogo Invoice

A simple, offline-first invoice generator that runs entirely in your browser. No backend, no sign-up, no tracking — your data never leaves your device.

▶ Live app: https://hallucinogen.github.io/gogo-invoice/

Inspired by react-invoice-generator, rebuilt from scratch with multi-company support, an invoice history you can revisit and copy from, and JSON backup/restore.

---

Features

• ✍️ Fill it in place (WYSIWYG) — the app opens directly on a ready-to-fill invoice. Click anything on the page — company name, logo, address, line items, dates, tax, notes — and edit it inline. What you see is exactly what the PDF prints.
• 🏢 Multiple companies / headers — starts with a default "Personal" company so there's zero setup. Add more sender profiles (logo, address, tax ID, bank details, default currency and their own invoice-number series) and switch per invoice. Only the company name is required — everything else is optional.
• 🧾 Full invoices — line items, percentage or fixed discount, configurable tax (label + rate), shipping, notes and terms, plus draft / sent / paid status.
• 🧩 Line-item templates for common trades — software/IT (incl. pass-through infrastructure), design, accounting & tax, finance & advisory, and general services. Insert a starter set of rows in one click, then fill the amounts.
• 🌍 Country picker on both the sender and Bill To, plus example placeholders that show exactly what to fill in.
• 🔢 Auto invoice numbering per company with a custom prefix and zero-padding — always overridable per invoice.
• 💱 Per-invoice currency — defaults to USD, switch any invoice to one of 24+ currencies with correct symbols and formatting.
• 🕘 History — every invoice is saved locally, searchable and filterable by company. Re-open, edit, or duplicate an old one to start a new invoice in seconds.
• 📄 PDF export — download a clean, print-ready A4 PDF generated entirely in the browser (via @react-pdf/renderer).
• 💾 Backup & restore — export all your data to a single JSON file and import it on another browser or computer.
• 🌙 Dark mode — light / dark / follow-system.
• 📦 Offline-first PWA — installable, works with no internet connection after the first load.

Privacy & how data is stored

There is no server. All companies and invoices are stored in your browser's localStorage on the device you're using. That means:

• Your data is private to that browser profile.
• Clearing your browser data will erase your invoices — use Backup → Export to keep a copy.
• To move between devices/browsers, Export a backup on one and Import it on the other.

Tech stack

• Vite + React 18 + TypeScript
• @react-pdf/renderer for client-side PDF generation (lazy-loaded, so it doesn't bloat the initial load)
• Zod for validating stored and imported data
• vite-plugin-pwa for offline support
• Hand-written CSS (no UI framework), with light/dark theming via CSS variables

Running locally

Requires Node 18+ and pnpm.

pnpm install
pnpm dev        # start the dev server
pnpm build      # type-check + production build into dist/
pnpm preview    # preview the production build
pnpm verify     # headless smoke test (totals math, zod round-trip, PDF render)

Deployment

Pushing to main triggers a GitHub Actions workflow (.github/workflows/deploy.yml) that builds the app and deploys dist/ to GitHub Pages.

If you fork this under a different repo name, update base in vite.config.ts (and the start_url/scope in the PWA manifest) to match /<your-repo-name>/, then enable Pages → "GitHub Actions" in repo settings.

Project structure

src/
  lib/        calculations, currency/date formatting, factories, ids
  store/      localStorage persistence (validated, resilient) + React store
  pdf/        the @react-pdf/renderer document + lazy download helper
  components/ layout, inline-editable fields, theme toggle, icons
  pages/      Editor (the WYSIWYG invoice), History, Companies, Backup

Automation API (for agents / Claude Code)

The app exposes a small global, window.gogoInvoice, so an agent driving the page (e.g. Claude Code via the Chrome extension) can read and create invoices without filling the form by hand. Run window.gogoInvoice.help() in the console for usage.

// Create + save an invoice (appears in History immediately, persisted locally)
window.gogoInvoice.createInvoice({
  company: 'Gogo Coaching Service', // matched by name; created if missing
  number: 'INTV-FAS-002',
  client: { name: 'Braid Research, Inc.', country: 'United States' },
  currency: 'USD',
  items: [
    { description: 'Coaching session', quantity: 4, unitPrice: 250 },
    { description: 'Cloud hosting (pass-through)', quantity: 1, unitPrice: 48 },
  ],
  taxRate: 0,
  notes: 'Thank you!',
})

window.gogoInvoice.listInvoices() // read everything
window.gogoInvoice.exportData()   // full backup object
window.gogoInvoice.importData(backupJsonOrObject)

// One call: create an invoice AND download its PDF (lands in ~/Downloads)
await window.gogoInvoice.createAndDownload({
  company: 'Gogo Coaching Service',
  client: { name: 'Acme Inc.' },
  items: [{ description: 'Coaching session', quantity: 4, unitPrice: 250 }],
})

// One call: create AND get the PDF bytes (to email/attach on the agent side)
const { invoice, filename, base64 } = await window.gogoInvoice.createAndGetPdf({ /* … */ })

// Or operate on an existing invoice by id/number:
await window.gogoInvoice.downloadPdf('INTV-FAS-002')        // browser download
const pdf = await window.gogoInvoice.getPdfBase64('INTV-FAS-002') // { filename, base64 }

Everything is plain localStorage under the key gogo-invoice:v1 (validated with Zod), so you can also export/import the JSON backup directly.

License

MIT © 2026 hallucinogen