Secluso Mobile Application

Developer Quick-Start Guide (Android & iOS)

Use this guide to build the Secluso mobile application from source.
Important: Complete all core setup steps in our build your own guide before continuing.

Important: You do not need to build this yourself unless you're a developer. We have published on the iOS App Store and Google Play App Store. Please see below.

iOS Mobile App • Android Mobile App

---

1. Reference Documentation

• Flutter Docs: flutter.dev
• Firebase Setup for Flutter: firebase.google.com/docs/flutter/setup

---

2. Prerequisites

Make sure the following tools are installed:

Tool	Purpose
Flutter SDK (3.x or later)	Cross-platform mobile framework
Rust + rustup	Native library support
Android NDK	Compile Rust code for Android
Visual Studio Code	Recommended IDE
Firebase Account	Required for push notifications

You can verify setup with flutter doctor.

---

3. Project Setup (Step-by-Step)

3.1 Clone the Repository

git clone https://github.com/secluso/secluso.git  
cd secluso

---

3.2 Open the Project in Visual Studio Code

• Launch Visual Studio Code
• Open the secluso/ folder
• Install any recommended extensions (Flutter, Rust, Dart)

---

3.3 Install Flutter Packages

flutter pub get

---

4. Compile Rust Code for Android

From the project root:

cd rust

Add Android build targets:

rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android

Build and export to the Android JNI directory:

cargo ndk -o ../android/app/src/main/jniLibs build

This will generate .so files for each architecture and place them in the appropriate folder.

---

5. Run on a Physical Android Device

1. Plug in your Android device via USB
2. Enable Developer Mode and USB Debugging
3. Ensure the device is recognized in Visual Studio Code (bottom-right status bar)
4. From the project root, run:

flutter run

This will build and launch the app on your connected device.

---

6. Debugging Tips

Problem	Solution
App doesn’t update after flutter run	Run flutter clean first
Rust compilation errors	Ensure targets and NDK are properly set

---

7. Early-Stage Android Reproducible Build

The Android project includes a containerized reproducible-build path under tool/repro.

To compare an official Secluso Android release installed on a phone against a local rebuild:

tool/repro/build_with_docker.sh
tool/repro/pull_device_apk.sh
python3 tool/repro/apkdiff.py \
  build/reproducible/device.apk \
  build/reproducible/app-release-unsigned.apk

For the full reproducible-build workflow, signed-release path, and internal reproducibility test (tool/repro/check_reproducibility.sh), see tool/repro/README.md.

---

Need help or want to contribute? Visit the Secluso GitHub Repository.