A personal purchase and warranty tracking application with receipt/file management.
Track your purchases, manage warranties, and analyze spending patterns. Upload receipts, manuals, and photos with automatic deduplication storage.
| Frontend | Backend | Storage |
|---|---|---|
| Vite + Alpine.js | FastAPI + SQLAlchemy | SQLite (dev) / PostgreSQL (prod) |
| Bootstrap 5 | Pydantic | Hash-sharded files |
| Chart.js | Uvicorn | Reference counting |
- Documentation Hub - Complete documentation collection
- API Documentation - Complete REST API reference
- System Architecture - Architecture overview and design
- Development Plan - Roadmap and development phases
- Security Policy - Security guidelines and vulnerability reporting
- Architecture Diagram - Visual system architecture
- Backend Documentation - Backend-specific implementation details
For security vulnerabilities, please report to oss@mailite.com or create a private GitHub security advisory.
- Node.js 16+
- Python 3.10+
# Install frontend dependencies
npm install
# Install backend dependenciescd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cd ..Default ports are 3030 (frontend) and 3031 (backend). To customize, edit the .env files:
.env (frontend):
VITE_PORT=3030VITE_API_URL=http://localhost:3031backend/.env (backend):
PORT=3031FRONTEND_URL=http://localhost:3030Terminal 1 - Frontend:
npm run dev -- --host 0.0.0.0Terminal 2 - Backend:
cd backend
source venv/bin/activate
uvicorn app.main:app --reload --host 0.0.0.0 --port 3031| Service | Default URL |
|---|---|
| Frontend | http://localhost:3030 |
| Backend API | http://localhost:3031/api |
| API Docs | http://localhost:3031/docs |
- Purchase Tracking: Product details, price, retailer, brand
- File Management: Upload receipts, manuals, photos with deduplication
- Warranty Tracking: Auto-expiry detection
- Analytics: Spending trends, retailer/brand distribution
- Data Import/Export: JSON and CSV support
spends/
├── src-modern/ # Frontend source (Vite + Alpine.js)
│ ├── scripts/ # Alpine.js components
│ └── styles/scss/ # SCSS styles
├── backend/ # FastAPI backend
│ ├── app/ # Routes, models, schemas
│ └── migrations/ # Alembic migrations
├── dist-modern/ # Production build (auto-generated)
└── uploads/ # File storage (hash-sharded)
# Frontend
npm run dev # Development server
npm run build # Production build# Backendcd backend
alembic upgrade head # Run database migrations
uvicorn app.main:app --reload --host 0.0.0.0 --port 3031
# Testing
pytest # Run backend testsMIT