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 |
| Backend | Supabase (client-side JS) |
| State | Zustand |
| Storage | MMKV |
| UI | Lucide React Native |
| Navigation | Expo Router |
| Package | Bun |
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)
Getting started
- Clone the repository and run
bun install. - Configure environment variables (see environment variables below).
- Run
bunx expo start. - For development builds:
bun run build:dev(EAS) or run with Expo dev client.
Environment variables
All runtime-accessible variables use theEXPO_PUBLIC_ prefix. Set these in your .env file:
| Variable | Description |
|---|---|
EXPO_PUBLIC_CLERK_PUBLISHABLE_KEY | Clerk authentication publishable key |
EXPO_PUBLIC_API_URL | Base URL for the d-sports-api backend |
EXPO_PUBLIC_TW_CLIENT_ID | Thirdweb client ID for Web3 features |
EXPO_PUBLIC_REVENUECAT_API_KEY | RevenueCat API key for in-app purchases |
EXPO_PUBLIC_REVENUECAT_APPSTORE_ID | RevenueCat App Store identifier |
EXPO_PUBLIC_REVENUECAT_ENTITLEMENT | RevenueCat entitlement name (e.g., premium) |
EXPO_PUBLIC_SUPABASE_URL | Supabase project URL |
EXPO_PUBLIC_SUPABASE_KEY | Supabase publishable (anon) key |
The Supabase client is used for client-side features only — it does not connect directly to the database. The Supabase client is initialized in
lib/supabase.ts.Ecosystem overview
See how the native app fits with the PWA, site, and Mic’d Up.
