Installation

Get Witflo up and running on your device in minutes.

System Requirements

🍎 macOS

macOS 10.15 (Catalina) or later

🪟 Windows

Windows 10 or later

🐧 Linux

Modern distribution (X11/Wayland)

📱 iOS

iOS 13.0 or later

🤖 Android

Android 5.0 (API 21) or later

---

Download & Install

Desktop Applications

macOS

1. Download the latest .dmg from GitHub Releases
2. Open the DMG file
3. Drag Witflo to your Applications folder
4. Launch from Applications

First Launch

macOS may show a security warning since the app is not yet notarized. Right-click the app and select "Open", then click "Open" in the dialog.

Windows

1. Download Witflo-Setup.exe from GitHub Releases
2. Run the installer
3. Follow the installation wizard
4. Launch from Start Menu or Desktop

Windows Defender

Windows Defender may show a warning since the app is not signed. Click "More info" → "Run anyway" to proceed.

Linux

Ubuntu/Debian (.deb)

wget https://github.com/nativewit/witflo/releases/latest/download/witflo.deb
sudo dpkg -i witflo.deb

Universal (AppImage)

wget https://github.com/nativewit/witflo/releases/latest/download/Witflo.AppImage
chmod +x Witflo.AppImage
./Witflo.AppImage

Required dependencies:

sudo apt-get install libsecret-1-dev libsodium-dev

Mobile Applications

Coming Soon

• iOS: App Store release planned
• Android: Google Play and F-Droid releases planned

Mobile apps are currently in beta. Check GitHub Releases for beta builds.

---

Build from Source

Want to build Witflo yourself? Here's how.

Prerequisites

Required:

• Flutter SDK 3.38+
• FVM (recommended for version management)
• Git

Platform-specific:

• macOS/iOS: Xcode 14+
• Android: Android Studio with SDK
• Linux: Build essentials, GTK 3.0
• Windows: Visual Studio 2019+

Clone & Setup

# Clone repository
git clone https://github.com/nativewit/witflo.git
cd witflo/witflo

# Install Flutter version with FVM
fvm install
fvm use

# Get dependencies
fvm flutter pub get

Run Development Build

# macOS
fvm flutter run -d macos

# Linux
fvm flutter run -d linux

# Windows
fvm flutter run -d windows

# iOS (requires Mac + Xcode)
fvm flutter run -d ios

# Android
fvm flutter run -d android

# Web
fvm flutter run -d chrome

Build Release

# macOS
fvm flutter build macos --release

# Linux
fvm flutter build linux --release

# Windows
fvm flutter build windows --release

# iOS
fvm flutter build ios --release

# Android APK
fvm flutter build apk --release

# Android App Bundle
fvm flutter build appbundle --release

# Web
fvm flutter build web --release

---

Troubleshooting

macOS: "App is damaged"

xattr -cr /Applications/Witflo.app

Linux: Missing Libraries

sudo apt-get install -f

Build Fails

1. Check Flutter version: flutter --version
2. Run diagnostics: flutter doctor
3. Clean and rebuild:

   flutter clean
   flutter pub get
   flutter run

Still Having Issues?

Report an issue on GitHub with:

• Your OS and version
• Flutter version (flutter --version)
• Error logs
• Steps to reproduce

---

Next Steps

🚀 Getting Started

Create your first encrypted workspace

✨ Features

Discover what Witflo can do

🔐 Security

Understand how your data is protected