Zenith Monitor RN

A React Native and Expo project for tracking real-time data from atmospheric probes and assisting Zenith members with their duties.

---

📋 Table of Contents

• Technologies
• Getting Started
• Prerequisites
• Installation
• Building the APK
• Additional Configuration
• Testing Bluetooth Retrieval
• Screenshots
• Contributing
• License

---

💻 Technologies

• React Native
• Expo
• TypeScript
• React Native Paper
• React Native Maps
• Bluetooth

---

Getting Started

Follow these steps to set up and run the project locally.

Prerequisites

Make sure you have the following tools installed:

• Git
• Node.js (LTS recommended)
• npm (comes with Node.js)
• Optional: Android Studio for emulator and SDK management

---

Installation

Clone the repository:

git clone [email protected]:zenitheesc/zenith-monitor-rn.git
cd zenith-monitor-rn

Install dependencies:

npm install

Start the project:

npx expo start

Once the command runs, a QR code will appear in your terminal.

Run on a physical device:

1. Install the Expo Go app from Google Play or the App Store.
2. Scan the QR code with Expo Go to open the app.

⚠️ Note on restricted networks: Expo Go uses your local Wi-Fi network to connect to your computer. Some corporate or university networks (like USP’s) may block this connection.

Solution: If you face issues, build the app locally and install it via USB (see below).

---

📲 Building the APK

To generate an installable .apk and test it directly on your Android device (no network required):

Enable USB Debugging

1. Go to Settings > About phone
2. Tap Build number seven times to unlock Developer options
3. Enable USB Debugging

Build the app

npx expo run:android

💡 Tip: For a production build:

npx expo run:android --variant release

(Optional) Manual APK build

After running npx expo prebuild, an android folder will be created. You can generate the APK manually with Gradle:

cd android
./gradlew assembleRelease

The APK will be located at:

android/app/build/outputs/apk/release/

---

🔧 Additional Configuration

Some features may require API keys (e.g., Google Maps).

1. Create a .env file in the project root based on .env.example (if available).
2. Ask the project maintainers for the necessary keys and fill them in.

---

🧪 Testing Bluetooth Retrieval

You can test data retrieval using an ESP32 microcontroller configured to send data via Bluetooth.

Expected message format:

SignalStrengthRSSI;ID;Latitude;Longitude;Altitude;Time

Example:

-60;42;-23.550516;-46.633308;760.50;"16:05:08"

---

Screenshots

Here are some screens of the app in action, showcasing the main features and interface flow.

_{📡 Home and Tracker screen}

_{🌍 Mission history and trajectory}

---

🔔 Notes

• Keep your project up to date — always check version compatibility between Expo, React Native, and Android SDK.
• Watch for dependency updates to ensure security and stability.

---

🤝 Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.