Overview
d-sports-engage-native (package name:engage-native) is the native mobile app for D-Sports. It mirrors the core PWA experience on iOS and Android: wallet, shop, leaderboard, locker room, and profile.
- Run:
bunx expo startorbun run start— then pressafor Android orifor iOS, or scan the QR code with Expo Go.
Tech stack
| Category | Technology |
|---|---|
| Framework | Expo 54, React Native 0.81, React 19 |
| Auth | Clerk (Expo) |
| Payments | RevenueCat (react-native-purchases) |
| Web3 | Thirdweb |
| State | Zustand |
| Storage | MMKV |
| UI | Lucide React Native |
| Navigation | Expo Router |
| Package | Bun |
| Monitoring | Sentry |
Features
- Wallet — Tokens, holdings, pack opening, crypto checkout (via PWA backend)
- Shop — Collectibles, cart, coin bundles, checkout
- Leaderboard — Rankings and filters
- Locker room — Social feed and engagement
- Profile — User profile and settings
- Theme — Dark/light mode (default dark)
Authentication & SSO
The app uses Clerk for authentication with support for:- Apple Sign-in and Google Sign-in via SSO callback handling
continue-sign-upflow — handles missing requirements (phone, username) during social login registrations with real-time username availability checks- User sync — profile data (including phone numbers from Apple Private Relay) syncs to the custom database during sign-up
Getting started
- Clone the repository and run
bun install. - Configure environment (Clerk, RevenueCat, Thirdweb, API base URL) per repo README.
- Run
bunx expo start. - For development builds:
bun run build:dev(EAS) or run with Expo dev client.
Recent changes (v1.7.1)
- Improved API client stability with better error handling for null/empty responses
- Fixed user sync issues for Apple SSO (including Private Relay email handling)
- Resolved onboarding persistence so the tutorial only shows on first login
- Added centralized Sentry logger for production monitoring
Ecosystem overview
See how the native app fits with the PWA, site, and Mic’d Up.