VectorFlair is a reusable, local-first prompt-to-SVG and sprite-animation platform. A prompt becomes a versioned, editable scene; every animation frame is evaluated from that shared scene; exports need no generator or AI runtime.
Requires the .NET 9 SDK.
dotnet build VectorFlair.sln
dotnet test VectorFlair.sln
dotnet run --project src/VectorFlair.Cli -- generate --prompt "Original amber warning robot" --output art
dotnet run --project src/VectorFlair.Cli -- spritesheet art/scene.json --animation idle --layout horizontal --output art/sprites
dotnet run --project src/VectorFlair.Api --urls http://127.0.0.1:5188Open http://127.0.0.1:5188 for VectorFlair Studio. The default deterministic mock provider works offline. To opt into OpenAI generation, set VECTORFLAIR_PROVIDER=openai and OPENAI_API_KEY; optionally set VECTORFLAIR_MODEL. Keys are read only from the host environment.
On Windows, double-click the VectorFlair Studio desktop shortcut (or run Start-VectorFlair.ps1) to start the local server in the background and open Studio without keeping a terminal window open.
The offline provider is prompt-aware for common icon subjects, named colors, style presets, and seeds. Configure the OpenAI provider when you need unrestricted natural-language scene generation.
| Package | Responsibility |
|---|---|
VectorFlair.Schema |
Versioned scene and animation contracts |
VectorFlair.Core |
Validation, limits, stable issues, style registry |
VectorFlair.Generator |
Prompt safety, provider abstraction, repair and validation pipeline |
VectorFlair.Svg |
Deterministic scene serialization and SVG sanitization |
VectorFlair.Animation |
Independent keyframe evaluation and compatible path morphing |
VectorFlair.Raster |
Replaceable ISvgRasterizer and Skia-backed PNG output |
VectorFlair.SpritePacking |
Horizontal, vertical, grid, and square packing plus runtime metadata |
VectorFlair.Sdk |
Framework-independent facade used by every host |
VectorFlair.Cli |
Build-pipeline commands |
VectorFlair.Api |
Local/hosted REST API and reference Studio |
See SDK, REST API, scene format, animation, security, integration examples, and the Codex integration work order.