Creating strategies
Create a new strategy
Click “New Strategy” and provide a name. A new strategy is created with:
- A unique ID
- One default page (“Page 1”)
- The Ascent map selected by default
- Current timestamp for creation and last edited dates
Multi-page strategies
Each strategy can contain multiple pages to break down complex setups:Adding pages
Navigating pages
Switch between pages using:- Arrow keys - Navigate forward/backward through pages
- Page list - Click directly on the page you want to view
- Keyboard shortcuts - Use configured hotkeys for quick navigation
Pages are ordered by their
sortIndex. You can reorder pages by dragging them in the page list.Page transitions
When switching pages, Icarus animates the transition:- Elements that move show smooth position changes
- New elements fade in
- Removed elements fade out
- Unchanged elements remain visible during the transition
Auto-save
Icarus automatically saves your work:- Save timer - Triggered after a configurable delay (default: a few seconds after edits)
- Save indicator - Shows “Saving…” while the save is in progress
- Debouncing - Multiple rapid edits are coalesced into a single save
Manual save
You can force an immediate save:- Use the Save button in the toolbar
- Press the save keyboard shortcut
- Export the strategy to a file
Importing strategies
Icarus supports importing from.ica files:
Select import method
- File picker - Browse and select an
.icafile - Drag and drop - Drop files directly onto the app window
- File path - Provide a direct path (useful for automation)
Load strategy data
Icarus reads the file and extracts:
- Strategy metadata (name, map, creation date)
- All pages with their content
- Embedded images (if the file is a ZIP)
- Version information for migration
ZIP-based
.ica files (created by newer versions) include embedded images. Legacy JSON-only files will try to load images from a separate folder.Exporting strategies
Export your strategies to share with teammates:Single strategy export
Folder export
You can export an entire folder:- All strategies in the folder are exported
- Subfolders are included recursively
- A single ZIP file contains the folder hierarchy
Strategy operations
Renaming
Change the strategy name anytime. The internal ID remains the same, ensuring references stay valid.Duplicating
Deleting
Deleting a strategy:- Removes it from the Hive database
- Deletes the strategy’s storage folder (including images)
- Cannot be undone
Version migration
Icarus includes automatic migration for older strategy files:Legacy data migration
Strategies created before multi-page support are converted:- Old flat data structure is wrapped into a single page
- All drawings, agents, abilities, and text are moved to “Page 1”
- Version number is updated to current
World coordinate migration
Older strategies used 1.24:1 aspect ratio. Modern strategies use 16:9:- All positions are shifted horizontally to center the map
- Drawings, agents, abilities, utilities, and lineups are adjusted
- Bounding boxes are recalculated
Migration happens automatically when loading or switching pages. The updated strategy is saved immediately.
Storage structure
Strategies are stored in two places:Hive database
The main strategy data (metadata, pages, element positions) is stored in a local Hive database:- Fast access for listing strategies
- Efficient querying for folder organization
- Atomic updates for reliability
File system
Images and large media are stored in the application support directory:Best practices
Organization
- Group related strategies in folders
- Use consistent naming conventions
- Export important strategies regularly as backups
- Delete unused strategies to keep the library clean
Performance
- Strategies with many pages may take longer to switch
- Large images increase file size
- Clean up unused lineups and images periodically