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.5, React 19.1
AuthClerk (Expo 2.19)
PaymentsRevenueCat (react-native-purchases 1.26)
Web3Thirdweb 5.118
StateZustand 5.0
StorageMMKV 4.1
UILucide React Native
NavigationExpo Router 6.0
AnimationsReanimated 4.1
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)

Architecture

The app follows a modular architecture pattern:
  • Screen files (wallet.tsx, shop.tsx) contain only JSX—all state, effects, and handlers live in dedicated hooks (use-wallet-screen.ts, use-shop-screen.ts)
  • Extracted sub-components in components/wallet/ and components/shop/ with barrel exports
  • Centralized types and constants in types/ and constants/ directories
  • API client layer in lib/api/ with MMKV cache fallback
  • PWA-ready with responsive desktop layout and web hover states

Getting started

  1. Clone the repository and run bun install.
  2. Configure environment (Clerk, RevenueCat, Thirdweb, API base URL) per repo README.
  3. Run bunx expo start.
  4. For development builds: bun run build:dev (EAS) or run with Expo dev client.
  5. Run bun tsc --noEmit to check TypeScript types.
The app targets both native and web (responsive) and uses the same backend (d-sports-api) as the PWA for API and checkout flows.

Ecosystem overview

See how the native app fits with the PWA, site, and Mic’d Up.