Skip to main content

Alessandros's Blog - Build with freedom. Share with purpose

Study Case 1 - FidelityApp

## LocalCard Solutions - Digital Loyalty Cards App

⚠️ Important Note: LocalCard Solutions is a fictional company created for this case study. This project was developed for learning purposes and technical skills demonstration.

# FidelityApp Solutions MVP

A modern solution for digitalizing paper loyalty cards for small businesses. Designed to deliver simplicity, functionality, and aesthetics.


# About the Project

What is FidelityApp by LocalCard Solutions?
FidelityApp by Local Solutions is an iOS mobile application that allows consumers to digitalize their paper loyalty cards. It solves the problem of losing physical cards while providing a modern and intuitive user experience for small business customers.

This project transforms the traditional loyalty card experience by offering a customizable digital stamp system, enabling users to collect points at their favorite merchants without the risk of losing their cards.


# Role & Responsibilities

Role Contribution
iOS Developer UX/UI Design & SwiftUI Development
Key Focus Areas User Interface, iOS Architecture
Timeframe 4 weeks (80 hours)
Tools Figma, SwiftUI, Xcode
Deliverable Functional TestFlight version

# Objectives

The 5 main MVP objectives:

  • Digitalize the traditional paper card stamp system
  • Simplify card addition via QR code or business search
  • Customize display with each merchant’s visual identity
  • Secure in-store validation with unique QR codes and PIN codes
  • Ensure fast usage (under 10 seconds in-store)

# Process

## ✏️ Research Phase - Business Requirements Analysis

During our initial discussions with LocalCard Solutions, they shared comprehensive market insights from their existing merchant network and customer feedback data.

Key findings from LocalCard’s business intelligence:

  • Customer pain points: Their merchant partners consistently reported that 60% of customers forget their loyalty cards, leading to lost engagement opportunities
  • Merchant operational costs: Small businesses were spending €200-400 annually on card printing and frequently running out of stock during peak periods
  • Usage patterns: Data showed customers typically carry multiple loyalty cards (3-8) but actively use only 2-3, indicating choice fatigue

LocalCard’s market positioning insights:

  • 70% of their merchant base uses stamp systems (cafés, bakeries, salons)
  • Target demographic (25-65 years) values simplicity over complex features
  • Critical success factor: in-store usage must be under 10 seconds to avoid disrupting customer flow
  • Interface benchmarking: customers trust banking app aesthetics for financial-adjacent services

Strategic direction confirmed: Based on LocalCard’s data and merchant feedback, we validated that the MVP should focus on replicating the familiar stamp card experience digitally, rather than introducing new loyalty concepts. The goal was to solve existing friction points while maintaining the behavioral patterns customers already understood.

Key Insights:

  • 70% of merchants use the stamp system
  • Interface must be clean and professional (reference: banking apps)
  • Critical usage time: maximum 10 seconds in-store

## 📐 Design

Dual design strategy: general interface in LocalCard colors (Royal Blue #4169E1, Emerald Green #50C878) but individual cards 100% customized with merchant’s identity.

Design Decisions:

  • Minimal animations for fluidity
  • Large, visible buttons for all ages
  • Readable and accessible typography
  • Clean style inspired by banking applications

Figma File

## 🔧 Development

SwiftUI architecture with connection to existing LocalCard REST API. Implementation of dual validation system (QR code + PIN) with offline management for card display.

Tech Stack:

  • SwiftUI for native iOS interface
  • LocalCard Solutions REST API (existing backend) (MockedUP for the Exercice)
  • QR code generation with specific format
  • Local storage for history and cache

GitHub Repository


# MVP Features

## Implemented Core Features

Loyalty card management

  • Addition via QR code or business search
  • Customized display with merchant’s design
  • Visual stamp system (MVP focus)

In-store validation

  • Unique QR code generation per transaction
  • Support for 1 to 5 stamps per transaction
  • 6-digit PIN code alternative (5 min validity)
  • Immediate visual confirmation

Local history

  • Progress towards rewards
  • Completed card archiving
  • Visit history

User interface

  • Intuitive navigation without connection
  • Simulated login for MVP
  • Basic settings page

# Technical Challenges

## Card Lifecycle Management

Implementation of automatic renewal logic: completed card → reward → archiving → new active card.

## Secure Validation System

QR code generation with specific URL format:

https://api.localcard.com/validate/{card_id}-{timestamp}-{security_token}

## Performance and Offline

Balance between offline features (card display) and online (validation), with strict constraint of maximum 10 seconds in-store.


# Outcome

Users can now manage their loyalty cards without risk of loss, with a familiar interface reproducing the paper card experience while bringing digital advantages.


# Learnings

## Technical Discoveries

  • Complex offline/online state management in SwiftUI
  • Secure QR code generation and validation
  • Modular architecture for merchant customization

## Challenges Overcome

  • Time constraint: MVP prioritization (stamps only) vs complete version
  • Multi-generational UX: Accessible interface for 25-65 years old
  • Critical performance: Store usage requires immediate response

## Impact on Future Projects

  • Importance of upfront user research
  • Value of focused MVPs vs complete solutions
  • Need for real-world testing (store environment)

Main Interface In-Store Validation
Main interface with customized cards
Home screen showing loyalty cards list
In-store validation system
QR Code to validate the fidelity card
Stamp Progress Cards History
Stamp system progress display
Card details with stamp progression
Completed cards history
Historic of collected card and stamp of a specific card

Interested in a similar project?
📩 Get in touch


# Project Information

Sector: B2B Service for small businesses
Target Audience: End consumers (25-65 years old)
Platform: iOS (SwiftUI)
Duration: 4 weeks - 80 hours
Status: MVP delivered - TestFlight version available