VendEase is a production-ready Point of Sale platform with full source code. It includes a Go (Fiber) backend with real-time Server-Sent Events, PostgreSQL database, and a Kotlin Multiplatform POS app for Android, iOS, macOS, Windows, and Linux.

Push to main and the system deploys itself via GitHub Actions CI/CD. First run auto-creates the admin user and default store — zero manual database setup. The backend features real-time sync via SSE with PostgreSQL LISTEN/NOTIFY, multi-store management, stock transfers, employee roles, loyalty programs, coupons, debt tracking, barcode/QR scanning, and financial reporting.

The POS app is built with Compose Multiplatform and Material 3. It works offline with a local Room database and syncs in real-time when connected. Clean architecture throughout — easy to rebrand, extend, and deploy under your own domain.

Live Demo

Tech Stack

Download POS App

POS Application

• Inventory & category management
• Sales & transaction processing
• Multiple payment methods
• Multi-store support with stock transfers
• Financial reports & analytics
• Employee management & role-based access
• Customer & supplier management
• Loyalty programs & fidelity points
• Coupons & discount system
• Debt tracking & payments
• QR / Barcode scanning
• Real-time sync via SSE
• Tax configuration per store
• Offline-capable with local Room database
• Multi-language support (English & French)
• Cross-platform: Android, iOS, macOS, Windows, Linux

Backend & Infrastructure

• First-time setup wizard (auto-creates admin + store)
• Multi-store management with headquarters
• JWT authentication with refresh tokens
• Role-based access control
• Real-time SSE with PostgreSQL LISTEN/NOTIFY triggers
• Audit logs & activity trail
• SMTP email notifications
• Rate limiting & CORS
• Auto database migration on startup
• Docker Compose deployment (dev & production)
• GitHub Actions CI/CD pipeline
• Nginx reverse proxy with security headers
• Health checks & container auto-restart
• Automated seed script for first deploy

What You Get

• Full source code — backend + cross-platform app
• Docker Compose configs (development & production)
• GitHub Actions CI/CD pipeline
• Nginx reverse proxy config
• PostgreSQL with auto-migration & seeding
• Deployment guide & comprehensive documentation

Server / Backend

• VPS or dedicated server (Ubuntu 20.04+ recommended) — e.g. Hetzner, DigitalOcean, AWS
• Docker & Docker Compose installed
• Minimum 1 vCPU, 2 GB RAM, 20 GB storage
• SSH access to the server
• A domain name (optional, IP works for testing)

CI/CD (Optional but included)

• GitHub account with Actions enabled
• GitHub Container Registry (GHCR) — free with GitHub
• SSH key pair for deployment

POS App Development (if modifying source)

• Android Studio Ladybug (2024.2.1) or newer
• JDK 21+
• Kotlin 2.2.10
• Xcode 15+ (for iOS builds, macOS only)

Backend Development (if modifying source)

• Go 1.23+
• PostgreSQL 16+ (or use the included Docker container)

1. Deploy the Backend

1. Push the code to a GitHub repository.
2. Set up a VPS (e.g. Hetzner) with Docker & Docker Compose installed.
3. Generate an SSH key pair and add the public key to the server.
4. In your GitHub repo, go to Settings → Secrets and add:
   • SERVER_SSH_KEY — your private SSH key
   • SERVER_IP — your server IP address
   • PROD_ENV_FILE — your production .env file contents
   • GHCR_TOKEN — GitHub personal access token
5. Push to main — GitHub Actions will automatically build, push the Docker image, and deploy to your server.
6. On first deploy, the seed script auto-creates the admin user and default store.

2. Install the POS App

Download the pre-built app for your platform:

3. Log In

1. Open the POS app and set the Backend URL to your server.
2. Log in with the default admin credentials:
   • Username: admin
   • Password: VendeaseAdmin2026!
3. Change the default password after first login.
4. Create additional stores, employees, products, and start selling.

4. Customize & Rebrand (Optional)

1. Update package names, app name, and logo in the KMP project.
2. Change colors and strings in the theme files.
3. Update the .env file with your own database credentials, JWT secrets, and SMTP settings.
4. Point a domain to your server and configure SSL if needed.
5. Push to main — CI/CD handles the rest.