Commit 1f53b63

A Porto React Native template.

- [Node.js](https://nodejs.org) (LTS)¹

- [Yarn Classic](https://classic.yarnpkg.com) (v1.22+)¹

- [Expo](https://docs.expo.dev/get-started/installation)

- [EAS CLI](https://docs.expo.dev/build/introduction)

- iOS Requirements (skip if you're not building for iOS):

- Xcode 26.0²

- iOS Simulator 26.0²

- Ruby 3.4.6¹

- Cocoapods 1.16.2¹

- [fastlane](https://github.com/fastlane/fastlane): `brew install fastlane`

- Android Requirements (skip if you're not building for Android):

- Java 21.0.7³

- Gradle 9.0.0³

- Android Studio⁴

- Optional but highly recommended:

- [Expo Orbit](https://docs.expo.dev/build/orbit)

¹ [mise](https://mise.jdx.dev)

- Once you have `ruby` installed with `mise`, use it to install `cocoapods`.

² [xcodes](https://github.com/XcodesOrg/xcodesApp)

³ [sdkman](https://sdkman.io): run `sdk env install` in repo root to auto install Java and Gradle

⁴ [JetBrains Toolbox](https://www.jetbrains.com/toolbox-app).

Once you have Android Studio installed:

- install a newer SDK Platform Tools - I use 36.1 ([demo](https://share.cleanshot.com/KJ6rYZjw))

- install a newer virtual device with Google Play Services enabled - I use Pixel 9 Pro Fold ([demo](https://share.cleanshot.com/LhdhbMlS))

gh repo clone ithacaxyz/porto-react-native

cd porto-react-native

yarn install

When forking this project, update the following fields in `app.config.ts`:

export default (context: ConfigContext): ExpoConfig => ({

// Update these fields:

slug: 'your-app-slug', // Line 8

name: 'Your App Name', // Line 9

scheme: 'your-app-scheme', // Line 10

ios: {

appleTeamId: 'YOUR_TEAM_ID', // Line 16

bundleIdentifier: 'com.yourcompany.yourapp', // Line 17

associatedDomains: ['webcredentials:your-domain.com'], // Line 18

},

android: {

package: 'com.yourcompany.yourapp', // Line 21

},

extra: {

eas: {

projectId: 'your-expo-project-id', // Line 32

},

},

})

1. **Apple Team ID**: Found in [Apple Developer Account](https://developer.apple.com/account) → Membership

2. **Bundle Identifier**: Use reverse domain notation (e.g., `com.yourcompany.yourapp`)

3. **EAS Project ID**: Create project at [expo.dev](https://expo.dev) and copy the project ID

4. **Associated Domain**: Your server domain where you'll host the app verification files

The `./server` directory contains a [Bun](https://bun.sh) server that serves **App Verification Files** required for:

- **Passkey/WebAuthn**: Enables passkey authentication across web and mobile

- **Android App Links**: Verifies your app can handle Android deep links

- **iOS Universal Links**: Verifies your app can handle deep links from your domain

- `/.well-known/apple-app-site-association` - iOS app verification

- `/.well-known/assetlinks.json` - Android app verification

I'm deploying to railway but you can deploy anywhere [./server/index.ts](../server/index.ts) can run.

just deploy-server

To enable Universal Links and passkey authentication:

In `app.config.ts`, set your domain:

ios: {

associatedDomains: ['webcredentials:yourdomain.com'],

}

Update `server/apple-app-site-association`:

{

"webcredentials": {

"apps": [

"YOUR_TEAM_ID.your.bundle.identifier"

]

}

}

Use `eas credentials` and follow [this guide](https://docs.expo.dev/linking/android-app-links/#create-assetlinksjson-file) and update `server/assetlinks.json`.

1. Deploy your server with the updated files

2. Verify files are accessible:

- `https://yourdomain.com/.well-known/apple-app-site-association`

- `https://yourdomain.com/.well-known/assetlinks.json`

3. Test deep links and passkey functionality

rm -fr '$TMPDIR/haste-map-*'

rm -fr '$TMPDIR/metro-cache'

rm -rf ios

rm -rf android

Generate native `ios`/`android` directory, apply plugins and `build-properties`

EXPO_NO_GIT_STATUS=1 yarn expo prebuild --platform='android' --clean

ANDROID_HOME="$HOME/Library/Android/sdk" EAS_BUILD_DISABLE_BUNDLE_JAVASCRIPT_STEP=1 eas build \

--platform='android' \

--non-interactive \

--local

- Android:

Your `.apk` file will have a dfferent number. Locate it in the repository root.

```sh

adb install -r build-1234567890.apk

```

- iOS:

```sh

xcrun simctl install booted build-1234567890.ipa

```

yarn expo start --clear --tunnel --dev-client

- Sign in to Google account on the emulator.

- Make sure [Developer Mode](https://developer.apple.com/documentation/xcode/enabling-developer-mode-on-a-device) is enabled on the device.

- `a` to run on Android. If your physical device is connected, it will automatically select it,

- `shift + a` to view Android options,

- `i` for iOS. Note that passkeys are not supported on iOS Simulator so you need to use an actual device,

- `w` for Web.

s.

When you install / update dependencies, run the following to check dependencies are deduplicated:

yarn expo install --fix && npx expo-doctor --verbose --yarn

If Expo doesn't resolve deduplication, run: `node_modules/.bin/bun scripts/dedupe.ts`

- `just build-ios` - Build iOS

- `just build-android` - Build Android

- `just fmt` - Format code with Biome

- `just dev` - Run the app and launch web, android or ios

- `just doctor` - Fix dependencies and run expo doctor

- `just deploy-server` - Deploy server to Railway

- `just android-device` - Mirror Android device screen

- `just android-cert` - Generate Android debug certificate

- [Expo Documentation](https://docs.expo.dev/)

- [Porto Documentation](https://porto.sh)

- [Apple Associated Domains](https://developer.apple.com/documentation/xcode/supporting-associated-domains)

- [Apple Universal Links](https://developer.apple.com/ios/universal-links/)

- [Android App Links](https://developer.android.com/training/app-links)

- [WebAuthn/Passkeys Guide](https://webauthn.guide/)

run: yarn install --frozen-lockfile