Skip to content

Update engage-native docs: Expo 55, RN 0.83, R8 minification #294

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
mintlify wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update engage-native docs: Expo 55, RN 0.83, R8 minification #294

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 38 additions & 13 deletions repositories/d-sports-engage-native.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: "d-sports-engage-native"
description: "Native iOS and Android app for D-Sports Engage. Expo 54, React Native, Clerk, RevenueCat, Thirdweb."
description: "Native iOS and Android app for D-Sports Engage. Expo 55, React Native 0.83, Clerk, RevenueCat, Thirdweb."
icon: "smartphone"
---

Expand All @@ -12,17 +12,18 @@ icon: "smartphone"

## 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 |
| Category | Technology |
| -------------- | ------------------------------------------- |
| Framework | Expo 55, React Native 0.83, React 19 |
| Auth | Clerk (Expo) |
| Payments | RevenueCat (react-native-purchases) |
| Web3 | Thirdweb |
| State | Zustand |
| Storage | MMKV |
| UI | Lucide React Native |
| Navigation | Expo Router |
| Monitoring | Sentry, OneSignal |
| Package | Bun |

## Features

Expand All @@ -31,15 +32,37 @@ icon: "smartphone"
- **Leaderboard** — Rankings and filters
- **Locker room** — Social feed and engagement
- **Profile** — User profile and settings
- **Widgets** — iOS and Android home screen widgets (rank/points, live activity)
- **Theme** — Dark/light mode (default dark)

## What changed since last docs sync

- Upgraded to **Expo 55**, **React Native 0.83**, and **TypeScript 5.9**.
- Android release builds now use **R8 minification and resource shrinking** (`enableMinifyInReleaseBuilds` and `enableShrinkResourcesInReleaseBuilds` via `expo-build-properties`). This is a potentially breaking change — test thoroughly after upgrading.
- Team-aware experiences were expanded to align with backend team/favorites behavior.
- Quest and rewards surfaces were updated to support per-team progression and pass-aware eligibility.
- Pack opening and odds disclosure UX were upgraded with safer interactions and clearer status/error handling.
- Settings and account flows were expanded, including in-app account deletion and richer support/data controls.

## Android builds and R8

Android release builds have R8 minification and resource shrinking enabled. This is configured in `app.json` under `expo-build-properties`:

```json
{
"android": {
"kotlinVersion": "2.1.20",
"minSdkVersion": 26,
"enableMinifyInReleaseBuilds": true,
"enableShrinkResourcesInReleaseBuilds": true
}
}
```

<Warning>
R8 can cause runtime crashes if native libraries or reflection-heavy code is not properly kept via ProGuard rules. Test all screens and native modules (crypto, RevenueCat, Sentry, OneSignal) on a release build before shipping.
</Warning>

## Backend integration surfaces

- Primary API source: `d-sports-api` under `/api/*`.
Expand All @@ -65,9 +88,11 @@ icon: "smartphone"
## Getting started

1. Clone the repository and run `bun install`.
2. Configure environment (Clerk, RevenueCat, Thirdweb, API base URL) per repo README.
2. Configure environment variables — you need keys for Clerk, RevenueCat, Thirdweb, Supabase, and the API base URL. Only `EXPO_PUBLIC_*` keys are accessible at runtime.
3. Run `bunx expo start`.
4. For development builds: `bun run build:dev` (EAS) or run with Expo dev client.
5. For production builds: `bun run build:prod` (all platforms) or `bun run build:prod:ios` / `bun run build:prod:android`.
6. Run `bun tsc --noEmit` to check 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.

Expand Down