← Back to Portfolio Muscle Mania →

🦊 Fox Tranquility Massage

React Native + ASP.NET Core • Booking, Loyalty & Client Retention Platform

Live for clients and staff on the web, iOS and Android

Open Fox Tranquility →

Quick Navigation

✨ Feature Demonstrations

Multi-Step Booking Flow

A guided multi-step appointment booking system that walks clients through service selection, therapist matching, duration customization, add-on enhancements, and time slot selection β€” all with real-time availability checking.
Expo Router React Native Context API date-fns expo-location

Booking Flow

  1. Client selects a service from the business's catalog (massage, chiropractic, tattooing or piercing, depending on the business)
  2. System filters therapists by location and service area (geofencing)
  3. Client picks therapist, adjusts duration, and selects add-on enhancements
  4. Available time slots displayed with real-time availability
  5. Booking confirmation with therapist info and appointment summary
Booking state is managed via a shared Context provider, persisting partial selections across steps. Therapist availability is filtered server-side and validated against geofence boundaries using expo-location coordinates.

Rewards & Loyalty System

A full loyalty engine with points earned on appointments, daily check-in streaks, redeemable rewards with voucher codes, and a complete redemption history β€” designed to drive client retention.
React Native AsyncStorage JWT Auth Zod

Client Rewards Flow

  1. Points earned automatically upon completed appointment
  2. Daily check-in available with streak multiplier bonuses
  3. Client browses reward catalog (credits, discounts, products)
  4. Redemption generates a unique voucher code
  5. Full redemption history and current point balance visible on dashboard
Points ledger and redemption records are stored server-side and synced on app load. The admin panel allows manual point adjustments and creation of new reward offerings with configurable point costs.

Admin Dashboard & Business Management

A full-featured admin portal giving therapists and business owners control over every operational aspect: scheduling, client management, service catalog, therapist profiles, and business analytics.
Expo Router (Admin) RBAC React Native TypeScript

Admin Capabilities

  1. Dashboard overview of upcoming bookings and revenue metrics
  2. Therapist availability management β€” block time, set unavailability
  3. Service catalog management β€” durations, pricing, add-on enhancements
  4. Client management β€” full client list with appointment history
  5. Therapist profiles β€” bio, photos, specialties, service areas
  6. Reviews moderation β€” view and remove inappropriate reviews
  7. Push notification broadcasting to clients or therapists
The admin panel is a separate Expo Router tab group, gated by RBAC roles embedded in the JWT token. Role checks happen on the client at route level and are re-validated server-side on every API request.

Geofencing & Location-Based Availability

Therapist availability is tied to configurable geographic service areas. Clients only see therapists who serve their location, and admins can draw service zones directly in the app.
expo-location Geofencing API TypeScript

Location Flow

  1. App requests location permission on first booking attempt
  2. Client coordinates sent to API for service area matching
  3. Only in-range therapists appear in the booking flow
  4. Admins configure service zones per therapist in the admin panel
Service areas are stored as radius + center-point pairs. The matching logic runs server-side using Haversine distance, keeping coordinate math off the client and enabling future polygon support without app updates.

Push Notifications

Full push notification support for appointment reminders, booking confirmations, cancellations, and admin broadcasts β€” targeting individual clients, therapists, or all users simultaneously.
expo-notifications Expo Push API expo-secure-store

Notification Flow

  1. Push token registered on login and stored server-side per user
  2. Appointment lifecycle events trigger automatic notifications
  3. Admin can broadcast custom messages from the admin dashboard
  4. Clients can opt in/out of notification categories in profile settings
Expo push tokens are stored with the user record server-side. Notification delivery uses the Expo Push Notification API as a managed relay, avoiding the complexity of direct APNs/FCM integration while retaining full targeting control.

Multi-Profession Theme Customization

The app is architected as a white-label platform. Business owners can customize the color scheme, branding, and profession context (massage, chiropractic, tattooing, piercing) entirely from the admin dashboard β€” no app store update required.
React Context (Theme) AsyncStorage TypeScript React Native StyleSheet

Theme Flow

  1. Admin selects profession and primary brand colors in settings
  2. Theme config stored server-side and synced to all active clients on launch
  3. ThemeContext distributes color tokens throughout the component tree
  4. All UI components consume theme tokens β€” no hardcoded colors
A ThemeProvider wraps the entire app, consuming a business config from the API. This makes the codebase deployable for any health/wellness business with zero UI code changes β€” just a new backend config record.

Tattoo & Piercing Shop Workflows

The platform grew beyond massage to serve tattoo and piercing shops, which book differently: a piece often starts as a request with reference photos, gets a quote, and may need several sessions. A shop that does both tattooing and piercing gets per-person service types and a whole-shop schedule.
ASP.NET Core Cloudflare R2 EF Core Expo Router

Tattoo Request Flow

  1. The client describes the piece (placement, size, color and a description) and uploads reference photos
  2. Instant-booking pieces show an estimate and go straight to a time slot; others go to the artist for a quote
  3. The client books a session from the quote; cancelling the only booked session returns the piece to Quoted so it can be rebooked
  4. Consultations and touch-ups are booked as their own service types
  5. Front desk and practitioners see an "Everyone" schedule; practitioners see other people's bookings only as busy time
Tattoo pricing has a single source of truth on the server: the estimate shown to the client and the price enforced at booking come from the same code, so prices sent by the app are display-only. Instant-booking drafts that are never booked are cleaned up along with their uploaded photos.

Automated Client Retention & Aftercare

Retention is handled automatically: aftercare messages after a tattoo, win-back messages for clients who haven't been back, follow-ups on open quotes, and a daily digest of messages waiting for approval. A ranked list shows the artist which past clients are most worth a personal message, and why.
Background Services PostgreSQL Row Locking Time Zones Approval Queues

Retention Pipeline

  1. When a tattoo session is completed, an aftercare sequence is planned for that piece
  2. Every hour, care messages due in the next 48 hours are written and queued for approval or sending, per the business's rule for that message type
  3. Once per business-local day, win-back, quote follow-up and approval-digest messages are planned
  4. The dispatcher sends due messages within the business's local send window and its marketing frequency cap
  5. Nudges that no longer apply, because the client already acted, are dropped
The outreach dispatcher claims rows with FOR UPDATE SKIP LOCKED, so a second server instance can never send the same message, and rows stuck mid-send after a crash are released after a while. The opportunity ranking is deterministic on purpose, with plain-language reasons, so artists can see why someone is listed.

AI-Written Messages with Privacy Guardrails

Retention and aftercare messages can be written by OpenAI so they read like a personal note from the artist or therapist, while templates take over whenever AI is off, unconfigured, over its daily limit or fails.
OpenAI Template Fallback Data Minimization

What the Model Sees

  1. Only non-sensitive facts: the client's first name, the business and artist names, and the tattoo's characteristics
  2. Never email, phone, birthday, intake or health answers, or free-text notes
  3. The type of the client's last visit, so a piercing client isn't invited back for "their next tattoo"
  4. Drafts can require approval before sending, depending on the business's settings
Keeping personal and health data out of the prompt by design, rather than by filtering afterwards, means the AI feature never needs access to the data a wellness business is most careful with.

Memberships with PayPal Subscriptions

Businesses can sell memberships with their own plans. Clients subscribe through PayPal from their profile, and benefits follow the subscription's status automatically.
PayPal Subscriptions Webhooks Hosted Services

Membership Lifecycle

  1. Admins define membership plans; clients subscribe through PayPal
  2. Webhooks handle subscription updates, cancellations, expirations and failed payments
  3. Events for unknown subscriptions are acknowledged and ignored, so one PayPal app can serve several products
  4. A self-cancelled membership keeps its benefits until the end of the period already paid for
A background sweeper ends self-cancelled memberships once their paid period is over. It is a safety net independent of PayPal's webhooks, which can be missed or delayed, and it is what actually makes "benefits end at period end" true.

SMS, Email & Push Messaging

Appointment messages reach clients the way they prefer: push notifications, email through Resend, or text messages through Twilio. Clients can reply to a text, and the business gets the reply by email.
Twilio Resend Expo Push Webhook Signatures

Messaging Rules

  1. Transactional texts only go to clients who opted in to texts from that business
  2. Inbound texts are verified with Twilio's request signature before anything else happens
  3. STOP and START keywords opt a phone number out and back in
  4. Any other reply is forwarded to the business by email
  5. Messages that fail aren't marked as sent, so the dispatcher retries them on its next cycle
Wording adapts to the business: at a tattoo shop, a piercing client hears from their "piercer", not their "artist". SMS sending stays behind a switch until the sending number's toll-free / A2P verification is approved.

Multi-Business Onboarding & Client Records

One backend serves many businesses. New businesses are invited and set up from profession templates, owners invite their own team, and each business gets intake forms, client notes and a printable booking QR code.
Invites & Seats Profession Templates QRCoder SOAP Notes

Setting Up a Business

  1. A super admin sends a new-business invite that sets the plan and practitioner seats
  2. Redeeming it creates the business from a template (services, prices, durations, enhancements, rewards and theme) for massage, chiropractic, tattooing or piercing
  3. Admins invite teammates as front desk or practitioners, scoped to their own business
  4. Clients fill in intake forms specific to the profession; therapists keep SOAP notes per client
  5. The booking link is available as a QR code to print or share
Self-serve setup never copies the real identity fields (names, bios, contact info) from a template; only the super-admin seeder can use them. Intake endpoints accept both the old fixed-field format and the new per-profession answers, so older app builds keep working.

πŸ“‹ Professional Summary

Full-Stack Booking & Retention Platform β€” React Native / Expo / ASP.NET Core Fox Tranquility Massage is a production-grade booking and client management platform, first built for a Denver-based massage therapy business and since grown into a multi-business platform that also serves chiropractors and tattoo and piercing shops. The app spans two distinct user experiences: a polished client-facing flow for discovery, booking, and loyalty engagement, and a comprehensive admin portal for scheduling, business operations, and client relationship management.

The platform was architected with white-label reusability in mind β€” a ThemeContext-driven design system, profession templates, and a server-driven business config make it deployable across businesses without code changes. Core engineering challenges included multi-step booking state management across Expo Router screens, geofence-based availability filtering, a full loyalty ledger with streak mechanics, quote-based tattoo booking, and real-time appointment notifications.

The client is TypeScript with Zod-validated API boundaries, JWT authentication with secure token storage via expo-secure-store, and React Context for global Auth, Theme, Business, and Toast state. It runs on a dedicated ASP.NET Core 9 API with EF Core and PostgreSQL, deployed with Docker on Railway, which adds PayPal membership subscriptions, Twilio SMS, Resend email, Cloudflare R2 media storage, privacy-safe AI-written messages with OpenAI, and background services for reminders, aftercare, win-back outreach and membership expiry.

🎯 Most Marketable Skills

Mobile Development

  • React Native 0.81 with Expo 54
  • Expo Router (file-based routing)
  • Tab and stack navigation patterns
  • TypeScript 5.9 throughout
  • Responsive layouts with StyleSheet

Auth & Security

  • JWT token-based authentication
  • expo-secure-store for token persistence
  • Zod schema validation on all API boundaries
  • RBAC role gating (client / therapist / admin)
  • Secure account deletion flow

Business Logic

  • Multi-step booking state machine
  • Loyalty points ledger with streak mechanics
  • Geofence-based availability filtering
  • Reward catalog and voucher generation
  • Service area management (radius + center)

UX & Architecture

  • White-label ThemeContext design system
  • Server-driven business config
  • Multi-profession branding (no code changes)
  • AsyncStorage for offline persistence
  • Toast/notification UX patterns

Backend & Integrations

  • ASP.NET Core 9 with EF Core and PostgreSQL
  • PayPal subscriptions and webhooks
  • Twilio SMS with signature validation
  • OpenAI messages with privacy guardrails
  • Multi-instance-safe background jobs

πŸ—οΈ Architecture

Client App

  • React Native / Expo 54
  • Expo Router (file-based)
  • TypeScript 5.9
  • Tab + stack navigation
  • StyleSheet theme tokens

State & Context

  • AuthContext (JWT + user role)
  • ThemeContext (brand config)
  • BusinessContext (biz info)
  • ToastContext (global alerts)
  • AsyncStorage persistence

API & Validation

  • REST API via fetch
  • Zod schema validation
  • JWT auth headers
  • date-fns for date handling
  • Server-driven availability

Device Services

  • expo-notifications (push)
  • expo-location (geofencing)
  • expo-secure-store (tokens)
  • expo-image-picker (profiles)
  • AsyncStorage (cache)

Admin Portal

  • Separate Expo Router group
  • RBAC role-gated routes
  • Service & availability mgmt
  • Push notification broadcast
  • Theme & business config

Backend API

  • ASP.NET Core 9 (Tranq API)
  • EF Core + PostgreSQL
  • JWT + BCrypt auth
  • Availability search
  • Server-side tattoo pricing

Jobs & Integrations

  • Notification dispatcher
  • Outreach dispatcher + retention planner
  • Membership sweeper
  • PayPal, Twilio, Resend, OpenAI
  • Cloudflare R2 media

πŸ† Key Achievements

πŸ“…

Full Booking Engine

Multi-step flow with service selection, therapist matching, duration, add-ons, and geofenced availability β€” all in a single cohesive UX.

🎁

Loyalty & Rewards System

Complete points ledger, streak check-ins, redeemable catalog, voucher codes, and full redemption history β€” driving repeat bookings.

πŸ—ΊοΈ

Geofence Scheduling

Location-based therapist availability using expo-location and server-side Haversine matching β€” clients only see in-range therapists.

🎨

White-Label Theming

Server-driven ThemeContext architecture makes the app deployable for any wellness business with no UI code changes β€” just a new config.

πŸ”

Secure Auth & RBAC

JWT tokens with expo-secure-store, Zod-validated boundaries, and role-based routing across client, therapist, and admin experiences.

πŸ””

Push Notifications

Full lifecycle notifications via Expo Push API β€” confirmations, reminders, cancellations, and admin broadcasts with per-user opt-out.

πŸ–‹οΈ

Tattoo & Piercing Support

Quote-based and instant tattoo booking with reference photos, server-enforced pricing, and a whole-shop schedule for front desk and practitioners.

πŸ”

Automated Retention

Aftercare sequences, win-back and quote follow-ups, sent inside each business's send window, and never twice thanks to row-locked dispatch.

πŸ›‘οΈ

Privacy-Safe AI & Billing

AI drafts that never see contact or health data, plus PayPal memberships whose period-end behavior holds even when webhooks are missed.

βš™οΈ Full Tech Stack

React Native 0.81 Expo 54 TypeScript 5.9 Expo Router 6 Context API JWT Authentication expo-secure-store expo-notifications expo-location Zod 3.23 date-fns 3.6 AsyncStorage 2.2 RBAC Geofencing Expo Push API REST API C# / .NET 9 ASP.NET Core EF Core 9 PostgreSQL PayPal Subscriptions Twilio SMS Resend OpenAI Cloudflare R2 QRCoder Docker Railway
← Back to Portfolio