Building from Source

Building from Source

Getman is a Flutter app. The full, authoritative build guide lives in the repo at docs/BUILD.md — this page is a quick orientation.

Prerequisites

• Flutter 3.41.6, pinned via .fvmrc. Use FVM so your toolchain matches CI exactly.
• A platform toolchain for whatever you build: Xcode (macOS), Visual Studio 2022 + "Desktop development with C++" (Windows), or clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev (Linux).

Quick start

git clone https://github.com/thiagomiranda3/Getman
cd Getman
fvm install            # first time only
fvm flutter pub get
fvm flutter run -d macos      # or -d windows / -d linux / -d chrome

Generated Hive adapters are committed, so a clean checkout runs without codegen. After changing an @HiveType/@HiveField, run:

dart run build_runner build --delete-conflicting-outputs

Release builds

fvm flutter build macos --release     # build/macos/Build/Products/Release/getman.app
fvm flutter build windows --release   # build\windows\x64\runner\Release\
fvm flutter build linux --release     # build/linux/x64/release/bundle/
fvm flutter build web --release       # build/web/

You can only build the binary for the OS you're on — Flutter desktop builds are host-locked. To produce all platforms at once, push a v*.*.* tag and let CI build macOS/Windows/Linux/web and publish a GitHub Release. See docs/BUILD.md and the repo's Releasing section.

Verify

fvm flutter analyze     # expect: No issues found!
fvm flutter test        # expect: all green

Contributing

The codebase follows Clean Architecture (domain → data → presentation) with flutter_bloc, get_it, hive, and dio. Architectural rules and feature invariants are documented in CLAUDE.md. Issues and PRs welcome.