Skip to main content

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 start or bun run start — then press a for Android or i for iOS, or scan the QR code with Expo Go.

Tech stack

CategoryTechnology
FrameworkExpo 54, React Native 0.81, React 19
AuthClerk (Expo)
PaymentsRevenueCat (react-native-purchases)
Web3Thirdweb
BackendSupabase (client-side JS)
StateZustand
StorageMMKV
UILucide React Native
NavigationExpo Router
PackageBun

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

  1. Clone the repository and run bun install.
  2. Configure environment variables (see environment variables below).
  3. Run bunx expo start.
  4. For development builds: bun run build:dev (EAS) or run with Expo dev client.
The app targets both native and web (responsive) and uses the same backend (d-sports-api) as the PWA for API and checkout flows.

Environment variables

All runtime-accessible variables use the EXPO_PUBLIC_ prefix. Set these in your .env file:
VariableDescription
EXPO_PUBLIC_CLERK_PUBLISHABLE_KEYClerk authentication publishable key
EXPO_PUBLIC_API_URLBase URL for the d-sports-api backend
EXPO_PUBLIC_TW_CLIENT_IDThirdweb client ID for Web3 features
EXPO_PUBLIC_REVENUECAT_API_KEYRevenueCat API key for in-app purchases
EXPO_PUBLIC_REVENUECAT_APPSTORE_IDRevenueCat App Store identifier
EXPO_PUBLIC_REVENUECAT_ENTITLEMENTRevenueCat entitlement name (e.g., premium)
EXPO_PUBLIC_SUPABASE_URLSupabase project URL
EXPO_PUBLIC_SUPABASE_KEYSupabase 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.