Skip to main content

HermitX

HermitX is the official mobile client for the Hermit project, providing a high-performance, native-feeling experience for Spacebar on Android and iOS.

Key Features​

  • Cross-Platform: Built with Flutter for consistent behavior across Android and iOS.
  • Real-time Connectivity: Uses WebSockets for instantaneous messaging and updates.
  • Multi-Instance Support: Allows users to connect to and switch between multiple Spacebar instances seamlessly.
  • Rich Media Rendering: High-performance rendering of GIFs, Stickers, and custom Emotes.
  • Deep Integration: Supports local notifications, file picking, and secure URL launching.
  • Personalization: Full support for system-wide light and dark themes.

Technical Stack​

  • Framework: Flutter
  • Language: Dart
  • Networking: Dio
  • State Management: Provider
  • Icons: Lucide (via flutter_lucide)

Installation (Android)​

The easiest way to install and keep HermitX updated on Android is via Obtainium.

  1. Add this link to Obtainium: https://git.disroot.org/hermit/mobile
  2. Select Forgejo as the Source Override
  3. Click add and wait.
  4. Click install and wait.
  5. Open and enjoy.

Why Obtainium?​

Obtainium allows you to install and update apps directly from their source (in this case, our Git repository) without needing a third-party app store. This ensures you always have the latest version as soon as it's released.

Developer Setup​

Prerequisites​

  • Flutter SDK (>= 3.11.1)
  • Dart SDK

Installation​

  1. Clone the repository.
  2. Fetch dependencies: 
    flutter pub get
  3. Run on a connected device: 
    flutter run