mabandla.
··:··
BUILD · 0112026webLIVE
Mobile-first occupational health, end-to-end

HCApp—WorkforceHealth&WellnessPlatform

A PWA that runs full-day corporate wellness events — pre-registration, QR wristbands, multi-station screenings, live analytics and PDF reports.

HCApp is a production wellness-event platform used to run corporate health screening days at scale. Nurses, counsellors and admins move attendees through multiple clinical stations (BP, BMI, HIV, lipids, hearing, eye, lung, oral, stress, TB), capture results on tablets, and generate per-attendee journey cards and event-level utilisation reports. The system is designed mobile-first, works offline-tolerant as a PWA, and ships with role-based access, QR-code wristband inventory, real-time dashboards and AI-generated executive summaries.

ROLE
Lead engineer & product designer
TIMELINE
2 MO
TEAM
2
STATUS
LIVE
HCApp dashboard showing wellness event statistics and station progress

Problem

Corporate wellness days were being run on paper forms and ad-hoc spreadsheets. Attendees got lost between stations, results were inconsistent, referrals slipped through the cracks, and the post-event report took days to compile. The client needed a single mobile-first system that worked on cheap Android tablets, handled hundreds of attendees per event, and produced clinical-grade documentation the same day.

Approach

I designed and built the full stack as the lead engineer:

  • Event lifecycle: Admins create events, configure which clinical stations are enabled, and bulk-import wristband inventory by scanning or pasting codes.
  • Pre-registration & check-in: Attendees pre-register via a public link or are walked in on the day. The app auto-allocates the next available wristband from inventory (with a TEMP fallback that gets reconciled later).
  • Station flow: Each station has a dedicated form (BP, BMI, HIV, lipids, hearing, eye, lung function, oral health, stress, TB screening) with validation, signature capture for consent, and referral flagging.
  • Live analytics: A real-time dashboard (Supabase Realtime + Recharts) shows attendees checked in, fully complete, with referrals, and average completion %. A separate Live Analytics screen drives the on-site TV.
  • Reports: Per-attendee Journey Cards and event-level Utilisation Reports render to PDF via @react-pdf/renderer. An edge function calls an LLM to draft an executive summary from the aggregated data.
  • Roles & security: Roles (admin, nurse, counsellor, subcontractor) are stored in a dedicated user_roles table with a has_role security-definer function, and all tables are protected by RLS policies.
  • Mobile UX: Built as an installable PWA with large touch targets, haptic feedback on scans, camera-based QR scanning via html5-qrcode, and optimistic UI throughout.

Outcome

  • Runs full corporate wellness days end-to-end: hundreds of attendees, 10+ clinical stations, real-time dashboards, same-day PDF reports.
  • Reduced post-event reporting time from days to minutes.
  • Eliminated paper forms across all live events.
  • Live in production at healthcareapp.co.za.
  • Hardened over real events: race-safe wristband allocation, RLS gap fixes for anon flows, bulk operations for staff invites, and offline-tolerant scanning.
← PREVIOUS BUILD
Aura Assist
NEXT BUILD →
Therapy On The Go — Mobile Healthcare Marketing Site