NextReceipt/README.md
cclohmar f0c576c543 feat: transform NextExpense into NextReceipt — receipt saver for warranty & returns
- Replace events+expenses with flat purchases table
- Add warranty_months, return_days, product_name fields
- Remove currency conversion, CSV/PDF reporting, event filing
- Simplify auth (no onboarding/department/profile)
- Update AI extraction prompts for product/warranty info
- Update all branding: templates, install.sh, Makefile, service file
2026-06-21 18:57:29 +00:00

1.4 KiB

NextReceipt

AI-Powered Receipt Saver for Warranty & Returns

Save receipts from private purchases to track warranty coverage and return windows. Upload your receipt, get AI-extracted data, and never lose track of your guarantees again.

Features

  • Passwordless login via email OTP
  • AI receipt extraction (Gemini / OpenAI-compatible)
  • Warranty tracking — save product name, store, price, warranty months, return window
  • Receipt image storage with UUID filenames
  • Mobile-first PWA — camera capture, installable, works offline
  • HTMX-powered UI — no SPA framework, server-driven
  • Pure Go, no CGO — single static binary

Quick Start

cp .env.example .env
# Edit .env with your credentials
go run main.go

Open http://localhost:8080

Tech Stack

  • Go 1.23+ (pure Go, no CGO)
  • SQLite via modernc.org/sqlite
  • HTMX 1.9.10 + vanilla CSS
  • chi v5 router

Configuration

Variable Purpose
AI_PROVIDER gemini or openai
GEMINI_API_KEY Google Gemini API key
OPENAI_API_KEY OpenAI-compatible API key
AI_MODEL Model name (for OpenAI/Ollama)
AI_BASE_URL API base URL
SMTP_HOST/PORT/USER/PASS SMTP credentials (for OTP emails)
PORT Web server port (default 8080)

Install (systemd)

bash install.sh

Updates: bash install.sh -update

License

MIT