Fidelio — Loyalty Platform for Local Shops (PWA)

Modern PWA for collecting points, redeeming rewards, and exploring nearby shops.

---

🚀 Overview

Fidelio is a modern loyalty platform designed for local shops.
Customers can collect points, redeem rewards, and explore nearby stores — all through a fast, installable PWA built with Next.js 14.

The platform includes:

• Customer PWA
• QR-based reward system
• Wallet with personal QR
• Map with nearby shops
• Rewards & gift cards
• Email OTP authentication

---

✨ Features

• Email OTP login (no password required)
• QR code scanner for point collection
• Customer wallet with personal QR
• Rewards & gift cards
• Interactive map with Leaflet
• Offline-ready PWA
• Fast UI with Tailwind CSS
• State management with Zustand
• Data fetching with React Query

---

🧱 Tech Stack

• Next.js 14 (App Router)
• React 18
• TypeScript
• Tailwind CSS
• Zustand
• React Query
• next-pwa
• Leaflet
• jsQR

---

🌐 Live Website

👉 https://getfidelio.com

---

📦 Installation

npm install
npm run dev

---

🗂 Project Structure

/app
  /auth
  /wallet
  /rewards
  /map
/components
/hooks
/lib
/public

---

🔐 Authentication

Fidelio uses email-based OTP authentication for a frictionless login experience.

---

📱 PWA Support

• Installable on iOS, Android, Desktop
• Offline caching
• Manifest + service worker
• Optimized Lighthouse score

---

📸 QR Scanner

The app includes a built-in QR scanner using:

• jsQR for decoding
• Camera stream via browser APIs
• Real-time validation

---

🗺 Map Integration

Built with Leaflet, showing:

• Nearby shops
• Shop details
• Reward availability

---

📄 License

Private project — all rights reserved.

---

👤 Author

Antonio
Founder of Fidelio