Documentation Index
Fetch the complete documentation index at: https://mintlify.com/martiigarcia/gesdeportiva/llms.txt
Use this file to discover all available pages before exploring further.
gesDeportiva targets Android and iOS from a single React Native codebase. Each platform requires its own native toolchain. Follow the section for your target platform — you can set up both if you want to run on Android and iOS.
iOS development requires macOS. You cannot build or run the iOS target on Windows or Linux.
Install Android Studio
Download and install Android Studio. During installation, make sure the following components are selected:
- Android SDK
- Android SDK Platform
- Android Virtual Device (AVD)
gesDeportiva targets API level 31 or higher. In Android Studio, open SDK Manager (via Settings > Languages & Frameworks > Android SDK) and install:
- Android SDK Platform 31 (or higher)
- Intel x86 Atom_64 System Image or Google APIs Intel x86 Atom System Image (for the emulator)
Set the ANDROID_HOME environment variable
React Native CLI needs to know where the SDK is installed. Add the following to your shell profile (~/.bashrc, ~/.zshrc, etc.):export ANDROID_HOME=$HOME/Library/Android/sdk # macOS
# export ANDROID_HOME=$HOME/Android/Sdk # Linux
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
source ~/.zshrc # or source ~/.bashrc
Create and start an emulator
In Android Studio, open Virtual Device Manager and create a new device. Choose a hardware profile (e.g. Pixel 6) and a system image at API 31 or above. Start the emulator before running the app.Run on Android
With the emulator running, execute:This runs react-native run-android, which builds the app and installs it on the emulator. The Android package is registered as com.gesdeportiva (see android/app/src/main/AndroidManifest.xml).You can also run on a physical Android device. Enable Developer options and USB debugging on the device, then connect it via USB. It will appear as a target automatically.
iOS development requires macOS. This tab does not apply on Windows or Linux.
Install Xcode
Install Xcode from the Mac App Store. After installation, open it once to accept the license agreement, then install the command-line tools:Install CocoaPods
CocoaPods manages the native iOS dependencies. The project includes a .ruby-version file that pins Ruby to 2.7.5 for compatibility with CocoaPods.The .ruby-version file in the project root pins Ruby to 2.7.5. If you use a Ruby version manager (rbenv, rvm, or asdf), make sure that version is installed before installing CocoaPods.
Install iOS pods
Navigate to the ios directory and run pod install:This resolves and links the native dependencies required by React Native and its libraries.Run on iOS
From the project root, execute:This runs react-native run-ios, which builds the app and launches it in the iOS simulator.To run on a physical iPhone or iPad, open ios/gesDeportiva.xcworkspace in Xcode, select your device as the build target, and press Run. You will need an Apple Developer account to sign the app.
Verify your setup
After completing platform setup, confirm everything works end to end:
Install JavaScript dependencies
Launch the app
In a separate terminal, run the platform command:The app should open with two bottom tabs: Login and Menu.