Skip to main content

Installing Race Platform

Race Platform ships from a single Flutter codebase. You can run it either as a native desktop app (macOS / Windows / Linux) or in your browser (Chrome, Edge, Firefox, Safari).

The browser build is our verified primary dev experience right now.

  1. Bring up the local stack (see Local Development for docker-compose details).
  2. Open http://localhost:6166.
  3. Log in with the seeded demo credentials (demo@race.local / demo / demo-racing).

The browser build supports:

  • Engineer and admin layouts
  • All current feature surfaces (Run Sheet, Strategy Overview, Board, Plugin Runner, etc.)
  • Authentication via Bearer JWT
  • Plugin invocation through the server adapter

It does not yet support:

  • Embedded plugin execution (uses the server adapter on web). Native targets will get in-process QuickJS execution via flutter_js.
  • Offline mode (planned via Drift + Automerge)

Flutter desktop (macOS / Windows / Linux)​

  1. Install Flutter 3.24+.

  2. Clone the repo.

  3. From the repo root:

    cd apps/client
    flutter pub get
    flutter run -d macos    # or -d windows / -d linux / -d chrome

  4. On first launch, point the client at your API host (the default is http://localhost:6161, configurable in apps/client/lib/src/config.dart).

macOS CocoaPods caveat

If flutter run -d macos fails with a CocoaPods / ffi gem error, you've hit a known Homebrew Ruby 4.x incompatibility. Workarounds are documented in docs/running-the-app.md in the repo: install Ruby 3.3 via mise, then gem install cocoapods. The web build is unaffected and is the verified path until this is fixed.

iPad / Android​

iPad and Android builds compile but are not yet packaged for distribution. Pilot teams interested in the iPad cockpit layout should let us know — we'll ship a TestFlight build on request.

cd apps/client
flutter run -d ipad     # requires a paired iPad and Xcode setup
flutter run -d android  # requires Android Studio + ADB

What's coming​

  • Signed macOS .app and .dmg distributions
  • Windows MSIX installer
  • TestFlight iPad build
  • Google Play closed beta
  • Auto-update channel (similar to HH-DM's auto-update)

In the meantime, every release will document the exact Flutter commit and dependency versions, so you can build from source reproducibly.