Receipt Tracking

Retreat

Never lose your receipts again. Automated receipt tracking and warranty management with email forwarding, smart reminders, and effortless organization.

React
Go
PostgreSQL
Docker
Redis
Clerk Auth

Core Features

Email Forwarding

Forward purchase emails to save@retreat-app.tech and let the system automatically extract receipt information, warranty details, and expiry dates.

PDF Upload

Manual receipt uploads supported. Upload PDF receipts and the system will parse them automatically with intelligent data extraction.

Smart Reminders

Receive timely notifications before warranties expire. Never miss a warranty claim or return window again.

Sponsor Benefits

Free tier: 5 receipts. Sponsor for $5/month: 50 receipts, data export, priority support. Built with Buy Me a Coffee since Stripe isn't available yet.

Security First

JWT authentication via Clerk, rate limiting, CORS protection, SQL injection prevention, and security headers. Docker containers with read-only filesystems.

Cross-Platform

Web app with responsive design. Android WebView support in progress. Built with React, TypeScript, and Tailwind CSS.

Technical Implementation

Architecture

  • Frontend: React + TypeScript + Tailwind CSS + Vite
  • Backend: Go + Fiber framework for high-performance API
  • Database: PostgreSQL with prepared statements for security
  • Cache & Rate Limiting: Redis (100 req/min default)
  • Authentication: Clerk (JWT tokens)
  • Deployment: Docker Compose with security best practices

How It Works

  1. Email Forwarding: Forward purchase emails to save@retreat-app.tech
  2. Auto-Extraction: Backend parses emails and PDFs to extract store name, purchase amount, date, warranty info
  3. Storage: Receipt data stored in PostgreSQL with photo attachments
  4. Reminders: System sends notifications before warranty expiration
  5. Dashboard: View all receipts, search, filter, and manage warranties in one place

Security Features

  • Authentication via Clerk with JWT tokens
  • Rate limiting to prevent abuse (configurable)
  • CORS protection (frontend domain only)
  • Security headers (XSS protection, etc.)
  • SQL injection protection with prepared statements
  • Input validation on all API endpoints
  • Docker containers with read-only filesystems
  • Graceful shutdown for in-flight requests

Development Status

Email forwarding & parsing
PDF upload & extraction
Dashboard & receipt management
Warranty tracking & reminders
Sponsor system via Buy Me a Coffee
Android mobile app (WebView)
Mail forwarding optimization

Latest README

Never lose your receipts again. Forward purchase emails to save@retreat-app.tech and we'll automatically extract receipt and warranty information. Mobile is work in progress.

View README on GitHub