Sign up
View stargazers1Sign up
Commits

README.md

Icarus: Valorant Strategies & Line ups

Icarus is an interactive strategy creation tool for Valorant players. It focuses on a robust map drawing system that lets teams create, save, and iterate on strategies locally.

Download: https://apps.microsoft.com/detail/9PBWHHZRQFW6?hl=en-us&gl=US&ocid=pdpshare Dev log: https://youtu.be/dDn2rafvjMQ?si=mm1Sz-XrjvNQiRWE

Features

  • Interactive map drawing and annotations
  • Save, load, and organize strategies locally
  • Agent and ability helpers
  • Desktop-focused UX for planning sessions

Tech Stack

  • Flutter (Dart)
  • Riverpod for state management
  • Hive for local storage

Architecture

  • lib/main.dart bootstraps app startup, initializes Hive, and wires Riverpod.
  • State lives in Riverpod notifiers under lib/providers/.
  • Strategies, folders, and supporting data are stored in Hive boxes defined in lib/const/hive_boxes.dart.
  • Hive adapters are generated from lib/hive/hive_adapters.dart.
  • Core strategy workflow is coordinated by lib/providers/strategy_provider.dart.
  • UI is composed from screens in lib/ and shared components under lib/widgets/.

Requirements

  • Flutter SDK (Dart >= 3.4.3)

Getting Started

bash
1flutter pub get
2flutter run

Windows dev OAuth callbacks

Discord OAuth redirects back into the desktop app through the icarus://auth/callback protocol. On Windows, the installed app normally owns that protocol handler, so a dev build may not receive the browser callback.

For a temporary dev session, run the Windows build with the force protocol registration flag:

powershell
1fvm flutter run -d windows --dart-define=ICARUS_FORCE_PROTOCOL_REGISTER=true

This rewrites the current user's icarus:// handler to the debug executable. After testing OAuth, launch the installed Icarus app once to restore the handler back to the installed build.

Build

bash
1flutter build <platform>

Versioning (Windows MSIX)

There is a helper script for bumping versions across pubspec.yaml and lib/const/settings.dart.

powershell
1powershell -ExecutionPolicy Bypass -File scripts/bump_version.ps1 -Bump patch

Local Prerelease Publish

To test the desktop auto-updater without waiting for the full GitHub Actions build, build and publish the prerelease updater payload locally:

powershell
1powershell -ExecutionPolicy Bypass -File scripts/publish_prerelease_local.ps1

This command:

  • bumps the app version by patch by default
  • builds the desktop prerelease package locally
  • stages the same GitHub Pages content under release/out/gh-pages
  • force-pushes that staged content to the gh-pages branch
  • relies on GitHub Pages serving the gh-pages branch directly

Contributing

If you would like to contribute, please fork the repository and submit a pull request with your proposed changes.

Support

This project is completely free and open source. Your support helps maintain it.