Froono: customer loyalty platform

Overview

Froono is a customer loyalty platform for retail chains. Companies, their stores and their customers each have their own scope. Staff run loyalty cards, reward rules, lucky draws and marketing from a web admin. Customers use an Expo mobile app and a web PWA that talk to one REST API. It has been in continuous development since 2023.

The challenge

Give each company and store control over its own cards, rules, draws and campaigns without any of it leaking across tenants, and check customer purchases without a till integration: customers upload a bill, the system reads it, and an admin accepts or rejects it. On top of that sit scheduled draws, scheduled marketing and messaging, and paid subscriptions. All of it has to run reliably in the background.

What we built

1. Multi-tenant web admin (Company, Store, Customer) with superuser, company admin and store admin roles, and a reusable company/store scope picker used across forms
2. Loyalty setup: card issuance programs with several card-number formats, card families (points, discount or visit-based), tiers with spending thresholds, reward plans and date-bound reward rules
3. Purchase flow: customers upload a bill, OCR reads it, a scoring step checks store, product group, invoice number, amount, date and duplicates, and an admin accepts or rejects the purchase
4. On acceptance: reward balance and ledger updates, visit-progress tracking, tier upgrades and a spin wheel unlocked by visits
5. Lucky draws: schemes, participants (manual or automatic from accepted purchases), scheduled draw execution, winners, and winner banners generated and published on a schedule
6. Marketing material designer with PDF and image export, scheduled posting to Facebook and Instagram pages, and a shared media library
7. WhatsApp Cloud API campaigns, templates, conversations and webhook handling, with one unified schedule model and a calendar planner for marketing, messages and draws
8. AI image generation jobs billed against wallets with a ledger, and a social-post flow that builds posts from public calendar events
9. Subscriptions and online payments for company sign-up, discount coupons, and loyalty reports
10. A customer REST API under /api/v1/ with token refresh, plus push notifications to browsers and to iOS and Android devices
11. An Expo/React Native mobile app and a Vite/React PWA built in one pnpm and Turbo monorepo, sharing a typed API client and Zod validation schemas
12. Celery workers and scheduled tasks for draws, posting, messaging and recovery of lost schedules; the PWA is delivered to AWS from a CI pipeline