Files

T

xavierkandCommandCodeBot ffe717dda6 Document the Linux -> Windows NSIS cross-compile setup

Adds notes for hosts without an nsis package: sourcing makensis, pointing
it at a full NSIS 3.11 data directory, and pre-seeding Tauri's NSIS plugin cache.

Co-authored-by: CommandCodeBot <noreply@commandcode.ai>

2026-10-03 23:34:54 +05:30

4.9 KiB

Raw Blame History

Voiced

An offline-first desktop invoicing app for Test Vendor, built by Bongbetic.

Voiced turns a few details into a clean, GST-ready PDF invoice. It keeps a running invoice-number series in a local database, remembers your vendor and bank details, and exports print-ready PDFs — no account, no network required.

Features

Automatic invoice numbering — a persistent series (e.g. INV/2026-001) that keeps counting up, with a one-click "start a new series" that resets the counter.
Guided first-run setup — your name, address, contact, PAN, GSTIN, logo, signature and bank details, pre-filled from your existing invoice and editable at any time.
Two line-item modes — a fixed amount, or a rate × quantity where the unit can be per second / minute / hour / session / unit (e.g. 10 sessions × ₹2,500).
GST support — toggle taxes on/off and split as CGST + SGST (within state) or IGST (inter-state), with live totals and Indian amount-in-words.
Signatures — attach a PNG/JPEG per invoice, or omit it and the invoice notes that it is computer-generated and needs no signature.
PDF export — a print-ready A4 invoice styled to match the original format.pdf.
Saved clients, invoice history with re-export, and light/dark (Carbon g10/g100) themes.
Input validation for PAN, IFSC, GSTIN, email and phone.

Tech stack

Layer	Choice
Shell	Tauri v2 (Rust core, WebView2 on Windows)
UI	React + TypeScript + IBM Carbon Design System (`@carbon/react`)
Fonts	IBM Plex, self-hosted (works offline)
Storage	SQLite via `rusqlite` (bundled)
PDF	`@react-pdf/renderer` with bundled IBM Plex

Prerequisites

Node.js 20+ and npm
Rust (stable) via rustup
Linux dev only: WebKitGTK 4.1, libsoup3, GTK3, librsvg, pkg-config, clang/llvm/lld

Development

npm install
npm run app:dev        # launches the desktop app with hot reload

Other scripts:

npm run build          # type-check + build the web frontend
npm run app:build      # package the app for the current platform

Building for Windows (cross-compile from Linux/macOS)

Tauri only supports the MSVC target. Cross-compiling uses cargo-xwin and produces an NSIS installer plus a portable .exe. A .msi still requires a real Windows host.

# one-time setup
rustup target add x86_64-pc-windows-msvc
cargo install --locked cargo-xwin
# plus NSIS (makensis), LLVM/LLD and clang on the host

npm run app:build:windows

Output lands in src-tauri/target/x86_64-pc-windows-msvc/release/bundle/nsis/ and the portable binary in the sibling release/ folder.

Notes for Linux hosts without an `nsis` package

makensis is required for the installer, and Tauri also fetches a small NSIS plugin. On distributions that don't package NSIS (e.g. Void Linux):

Provide makensis (e.g. extract it from your distribution's or an upstream package) and put it on PATH.
Point makensis at a full NSIS data directory (3.11 recommended, for Win/RestartManager.nsh); it looks in the directory compiled into the binary unless NSISDIR is set.

Pre-seed Tauri's plugin cache so it does not have to download it:

mkdir -p ~/.cache/tauri/NSIS/Plugins/x86-unicode/additional
# nsis_tauri_utils.dll (SHA1 75197fee3c6a814fe035788d1c34ead39349b860)
#   from https://github.com/tauri-apps/nsis-tauri-utils/releases

With those in place, npm run app:build:windows produces the NSIS -setup.exe and the portable voiced.exe.

Where data lives

What	Location
Database	`<app-data>/voiced.db` — on Windows `%APPDATA%\com.bongbetic.voiced\`
Logos & signatures	`<app-data>/assets/`

Project layout

src/                 React + Carbon frontend
  views/             Onboarding · NewInvoice · InvoiceHistory · SeriesSettings · AppSettings
  components/        AppShell · InvoicePreview · ImagePicker
  pdf/               InvoiceDocument (react-pdf template)
  lib/               api · types · invoice · numberToWords · validators · format · pdf
src-tauri/           Rust backend (Tauri commands, SQLite schema, asset store)
public/brand/        Bongbetic + vendor brand assets
public/fonts/        IBM Plex (woff/woff2)

4.9 KiB Raw Blame History Unescape Escape