Icarus — Valorant Strategies & Line ups

A Flutter desktop app for creating interactive Valorant game strategies. See README.md for features and architecture.

Cursor Cloud specific instructions

Services

Key caveats

• FVM is required. Flutter is pinned to 3.38.4 via .fvmrc. Always prefix Flutter/Dart commands with fvm (e.g. fvm flutter run, fvm dart run).
• Cloud is still dev-build only. The cloud backend has not shipped publicly yet, so backwards compatibility with existing dev cloud data is not automatically required. If a change breaks cloud data/API compatibility, explicitly tell the user first and let them decide whether to wipe/migrate the dev database or take another action.
• xdg-user-dirs must be initialized. The path_provider plugin needs XDG user directories. Run sudo apt-get install -y xdg-user-dirs && xdg-user-dirs-update if the app crashes with MissingPlatformDirectoryException.
• Linux build deps. clang cmake ninja-build pkg-config libgtk-3-dev liblzma-dev libstdc++-14-dev must be installed for Linux desktop builds.
• Code generation. After changing Hive models, Riverpod providers, or JSON-serializable classes, regenerate with: fvm flutter pub run build_runner build --delete-conflicting-outputs.
• No automated tests exist in this codebase. flutter test will find nothing.
• Lint. fvm flutter analyze — expect ~70 pre-existing warnings/infos (unused imports, deprecated APIs). No errors.
• Build. fvm flutter build linux --debug produces the binary at build/linux/x64/debug/bundle/icarus.

This project uses Convex as its backend.

When working on Convex code, always read convex/_generated/ai/guidelines.md first for important guidelines on how to correctly use Convex APIs and patterns. The file contains rules that override what you may have learned about Convex from training data.

Convex agent skills for common tasks can be installed by running npx convex ai-files install.