Get started

Download

Get the .dmg from the latest release. Open it, then drag the app to the Applications folder on your disk.

macOS install notes

Unsigned builds may show Gatekeeper warnings.

• Right-click the app and choose Open.
• Or go to System Settings → Privacy & Security → Open Anyway.

Install from Terminal

Optional: if you prefer Terminal (or need to troubleshoot), these are common commands after downloading via.dmg.

Note: the mounted volume might be /Volumes/Via or /Volumes/Via 1.

• Verify the file and (optionally) checksum

  ls -lh ~/Downloads/via.dmg
  shasum -a 256 ~/Downloads/via.dmg

• Mount (without opening Finder)

  hdiutil attach -nobrowse ~/Downloads/via.dmg

• Inspect the mounted volume (name may be Via, Via 1, etc.)

  ls /Volumes
  ls "/Volumes/Via"

• Install via Terminal (copy app into /Applications)

  sudo ditto "/Volumes/Via/Via.app" "/Applications/Via.app"

• Remove quarantine flag (if Gatekeeper blocks it)

  xattr -dr com.apple.quarantine "/Applications/Via.app"

• Verify signing / Gatekeeper assessment

  codesign --verify --deep --strict --verbose=2 "/Applications/Via.app"
  spctl --assess --type execute --verbose "/Applications/Via.app"

• Unmount / eject

  hdiutil detach "/Volumes/Via"

• Delete the downloaded DMG (optional cleanup)

  rm -f ~/Downloads/via.dmg

Open

Open from Applications or ⌘ + Space.

Browse

Type a URL or search in the address bar. Press Enter.

Shortcuts

For developers

Clone the repo, install dependencies, and launch.

• Clone and setup

  git clone https://github.com/palmshed/via.git
  cd via
  flutter pub get
  cp .env.example .env

• Configure Firebase

  flutterfire configure --platforms macos
  git checkout -- lib/firebase_options.dart

• Run the app

  flutter run -d macos

Do not commit .env; it contains private Firebase keys.