Configuration Specification
Every layout in GitAscii is represented by theSavedConfiguration interface. This structure defines the canvas dimensions, color tokens, font stack, and the full tree of positioned widgets.
SavedConfiguration
number
required
Schema version identifier (currently
1).number
required
Numeric GitHub user ID (e.g.
583231).string
required
GitHub username handle.
string
required
URL slug for the profile (e.g.
default, light, work).string
required
Active template preset identifier (
terminal, minimal, dracula, etc.).WidgetInstance[]
required
Ordered array of widget instances placed on the canvas.
GlobalStyles
required
Theme tokens applied globally to the canvas and inherited by widgets.
GlobalStyles
Defines the master design tokens for the canvas.
string
default:"#060606"
Hex or RGB color code for the root SVG canvas background.
boolean
default:"false"
When
true, omits the background <rect> tag, allowing the SVG to be transparent.string
default:"#ffffff"
Primary text color token.
string
default:"#c5ff4a"
Signature highlight color (zkPass Signal Lime
#c5ff4a by default).string
default:"#252525"
Hairline border color token.
string
default:"'JetBrains Mono', monospace"
Primary font-family definition string.
number
default:"0"
Corner radius in pixels applied to cards and canvas.
WidgetInstance
Represents an individual widget node positioned on the 2D SVG canvas.
string
required
Unique ID for the widget on the canvas (e.g.
widget_1708281000000_1).string
required
Identifier matching a registered renderer in
WidgetRegistry (e.g. header, stats, ascii-art).{ x: number, y: number }
required
Top-left coordinate in SVG pixels.
{ width: number, height: number }
required
Explicit dimensions in SVG pixels.
Record<string, unknown>
required
Key-value map containing widget-specific properties and options.
boolean
default:"true"
Controls whether this widget is rendered into the final SVG.
number
default:"1"
Determines layer ordering during render loop (lower values render underneath higher values).