Loading…
Loading…
Parameter reference
/api/studio/illustrateOne route, eight endpoint types, 84 valid slugs. Static glyphs, 27 universal UI icons, ornaments for any brand; animated scenes that play in any <img> tag without JavaScript. Every scene supports ?static=1 for reduced-motion and OG/print contexts. Astrology-native out of the box — domain-agnostic at the core. Every URL returns the same bytes forever. 1-day browser cache, 1-week CDN cache, open CORS.
GET only. All params go in the query string.type and slug.200, image/svg+xml, body is raw SVG including<?xml ?> header.public, max-age=86400, s-maxage=604800, immutable.Access-Control-Allow-Origin: *. Safe to embed from any site.400 on invalid params, 500 on internal dispatch bug. Body is JSON { error: string }./api/studio/illustrate/catalog.Type · zodiac · planet · aspect
Hand-drawn paths rendered in a 24 × 24 viewBox. Scales crisp at any size.
ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspiscessunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorth-nodesouth-nodelilithchironconjunctionoppositiontrinesquaresextile| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Stroke / fill colour. Accepts #hex, rgb()/hsl(), or named CSS colours. Anything with < > " ' ; ` is rejected. |
size | integer · 12-512 | 48 | Rendered viewBox width and height in pixels. |
stroke | number · 0.5-4 | 1.2 | Line thickness (before SVG scaling). |
Type · icon · universal UI
The minimum iconography every SaaS, e-commerce, dashboard, and blog needs — navigation, actions, states, media, commerce. Stroke-based so color and stroke params work identically to the astrology glyphs. Same 24 × 24 viewBox; drop-in replacement for Heroicons / Lucide / Feather on any non-brand-specific surface.
chevron-upchevron-downchevron-leftchevron-rightarrow-uparrow-rightarrow-downarrow-leftexternal-linkplusminuscheckclosesearchmenuheartstaruserbellsettingsinfoplaypausecarthomedownloadupload| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Stroke / fill colour. Accepts #hex, rgb()/hsl(), or named CSS colours. Anything with < > " ' ; ` is rejected. |
size | integer · 12-512 | 48 | Rendered viewBox width and height in pixels. |
stroke | number · 0.5-4 | 1.2 | Line thickness (before SVG scaling). |
<!-- Nav -->
<img src="/api/studio/illustrate?type=icon&slug=chevron-right&size=16&color=%23666"
width="16" height="16" alt="" />
<!-- Action button -->
<img src="/api/studio/illustrate?type=icon&slug=download&size=20&stroke=2"
width="20" height="20" alt="Download" />
<!-- All 26 via the sprite -->
<svg style="position:absolute;width:0;height:0">
<use href="/api/studio/illustrate/sprite?set=icon" />
</svg>
<svg width="24" height="24" viewBox="0 0 24 24"><use href="#play" /></svg>Type · viz · data-driven
Dashboard primitives rendered from URL-encoded data — sparkline, progress-arc, donut, and bar chart. No client JavaScript, no Chart.js, no ECharts. Feed values via the query string, tune the look with a few params, drop into any <img>.
sparklineprogress-arcdonutbarheatmapdiverging-barslug=sparkline · metric-tile inline chart| Param | Type | Default | Notes |
|---|---|---|---|
values | comma-separated numbers | (required) | 1-200 entries. Digits, minus, decimal point, commas only. |
color | css colour | #d4a550 | Stroke + dot + fill colour. |
width | integer · 40-800 | 160 | Width in px. |
height | integer · 16-240 | 48 | Height in px. |
strokeWidth | number · 0.5-4 | 1.6 | Line thickness. |
fill | boolean | true | Area fill under the line. |
endDot | boolean | true | Dot at the last (current) value. |
smooth | boolean | true | Smooth cubic-bezier interpolation vs straight segments. |
slug=progress-arc · circular progress| Param | Type | Default | Notes |
|---|---|---|---|
percent | number · 0-100 | (required) | Progress fraction. |
color | css colour | #d4a550 | Progress stroke. |
size | integer · 40-480 | 160 | Render dimensions. |
strokeWidth | number · 1-40 | size × 0.08 | Ring thickness. |
label | boolean | true | Show the percent number in the centre. |
trackColor | css colour | muted brass | Background ring colour. |
labelColor | css colour | = color | Centre label colour. |
slug=donut · proportional ring chart| Param | Type | Default | Notes |
|---|---|---|---|
values | comma-separated numbers ≥ 0 | (required) | Segment proportions. |
colors | comma-separated css colours | observatory palette | Max 12; cycled if shorter than values. |
size | integer · 60-480 | 200 | Render dimensions. |
hole | number · 0-0.9 | 0.55 | Inner-radius fraction. 0 = pie. |
gap | number · 0-10 | 2 | Gap between segments in degrees. |
slug=bar · vertical or horizontal bars| Param | Type | Default | Notes |
|---|---|---|---|
values | comma-separated numbers ≥ 0 | (required) | One bar per value. |
color | css colour | #d4a550 | Bar fill. |
width | integer · 40-1200 | 240 | Chart width. |
height | integer · 30-480 | 100 | Chart height. |
direction | "vertical" | "horizontal" | vertical | Bar orientation. |
gap | number · 0-0.5 | 0.15 | Gap between bars as slot fraction. |
radius | number · 0-20 | 3 | Corner radius per bar. |
<!-- KPI tile sparkline -->
<img src="/api/studio/illustrate?type=viz&slug=sparkline&values=3,5,2,8,6,9,7,10,8,12&width=200&height=48" />
<!-- Progress ring -->
<img src="/api/studio/illustrate?type=viz&slug=progress-arc&percent=68&size=140" />
<!-- Revenue donut -->
<img src="/api/studio/illustrate?type=viz&slug=donut&values=40,30,20,10&colors=%23d4a550,%233a2a5b,%238a5a2a,%231a2338" />
<!-- Weekly activity bars -->
<img src="/api/studio/illustrate?type=viz&slug=bar&values=3,5,8,2,6,9,4&width=280&height=80" />Type · pattern
Chart-circle compositions with apex dots, aspect-kind stroke styling, and optional A / B / C labels.
t-squaregrand-trineyodkitemystic-rectanglegrand-crossstellium| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Stroke / fill colour. Accepts #hex, rgb()/hsl(), or named CSS colours. Anything with < > " ' ; ` is rejected. |
size | integer · 12-512 | 48 | Rendered viewBox width and height in pixels. |
stroke | number · 0.5-4 | 1.2 | Line thickness (before SVG scaling). |
labels | boolean | true | Show the A / B / C apex letters (pass 0 or false to hide). |
ticks | boolean | true | Show twelve 30° house ticks on the outer ring. |
ringOpacity | number · 0-1 | 0.35 | Outer-ring stroke opacity. |
bodies | comma-separated planet slugs | (none) | Renders the matching planet glyph at each apex instead of a letter. e.g. bodies=sun,saturn,pluto for a T-square. |
Type · ornament
Non-glyph compositions — each takes a different parameter surface.
slug=compass-rose| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Stroke / fill colour. Accepts #hex, rgb()/hsl(), or named CSS colours. Anything with < > " ' ; ` is rejected. |
size | integer · 12-512 | 48 | Rendered viewBox width and height in pixels. |
stroke | number · 0.5-4 | 1.2 | Line thickness (before SVG scaling). |
points | 4 | 8 | 16 | 8 | Number of petals on the rose. |
cardinals | boolean | true | Show N / E / S / W labels (pass 0 or false to hide). |
slug=blob · organic shape (any brand)Parametric blob with smooth cubic-bezier curves around a seeded circle. Fully deterministic (seed → byte-identical output) and optionally animated: when animated=1, the blob morphs between three shapes via SMIL <animate> on the path d attribute, with spline easing so interpolation stays smooth.
| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Fill (default) or stroke colour. |
size | integer · 60-800 | 240 | Render dimensions. |
seed | string (≤ 64 chars) | blob | Layout seed. Same seed → same blob. |
points | integer · 6-16 | 8 | Control points around the base circle. |
roughness | number · 0-0.6 | 0.22 | Radius jitter as fraction of base radius. |
fill | boolean | true | Filled (default) vs stroked blob. |
fillOpacity | number · 0-1 | 1 | Fill opacity. |
stroke | number · 0.5-10 | 1.5 | Stroke width (when fill=0). |
animated | boolean | false | Morph between 3 shapes via SMIL. |
morphDuration | number · 2-60 | 10 | Seconds per morph cycle. |
slug=chart-ringEmpty natal-style zodiac wheel — 12 sign glyphs at 30° intervals on an outer ring. The canonical editorial backdrop.
| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Stroke / fill colour. Accepts #hex, rgb()/hsl(), or named CSS colours. Anything with < > " ' ; ` is rejected. |
size | integer · 12-512 | 48 | Rendered viewBox width and height in pixels. |
stroke | number · 0.5-4 | 1.2 | Line thickness (before SVG scaling). |
houses | boolean | true | Show the 12 × 30° house-division lines. |
innerRing | boolean | true | Show the inner sign-boundary ring. |
slug=moon-phaseAccepted phase names: new, waxing-crescent, first-quarter, waxing-gibbous, full, waning-gibbous, last-quarter, waning-crescent.
| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Stroke / fill colour. Accepts #hex, rgb()/hsl(), or named CSS colours. Anything with < > " ' ; ` is rejected. |
size | integer · 12-512 | 48 | Rendered viewBox width and height in pixels. |
phase | number · 0-1 | 0.5 | Lunation fraction. 0 = new, 0.5 = full. Takes precedence over phaseName. |
phaseName | "new" | "waxing-crescent" | "first-quarter" | "waxing-gibbous" | "full" | "waning-gibbous" | "last-quarter" | "waning-crescent" | (none) | Named preset — maps to a canonical phase value. |
hemisphere | "north" | "south" | north | Flip the illuminated side horizontally. |
darkColor | css colour | transparent | Fill behind the dark side of the disc. |
ringOpacity | number · 0-1 | 0.55 | Outline opacity of the moon disc. |
slug=brass-divider| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Stroke / fill colour. Accepts #hex, rgb()/hsl(), or named CSS colours. Anything with < > " ' ; ` is rejected. |
stroke | number · 0.5-4 | 1.2 | Line thickness (before SVG scaling). |
width | integer · 24-1200 | 320 | Total SVG width in pixels. Height is fixed at 32. |
variant | "star" | "sun" | "hairline" | "diamond" | star | Centre-mark glyph. Ignored when a label is provided. |
label | string (≤ 40 chars) | (none) | Custom centre text. Letters, numbers, spaces, and basic punctuation only. |
slug=corner-mark| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Stroke / fill colour. Accepts #hex, rgb()/hsl(), or named CSS colours. Anything with < > " ' ; ` is rejected. |
size | integer · 12-512 | 48 | Rendered viewBox width and height in pixels. |
stroke | number · 0.5-4 | 1.2 | Line thickness (before SVG scaling). |
corner | "tl" | "tr" | "bl" | "br" | tl | Which corner the L-bracket points into. |
slug=starfield| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Stroke / fill colour. Accepts #hex, rgb()/hsl(), or named CSS colours. Anything with < > " ' ; ` is rejected. |
size | integer · 12-512 | 48 | Rendered viewBox width and height in pixels. |
seed | string (≤ 64 chars) | observatory | Deterministic seed (letters, numbers, dashes, underscores only). Same seed → same stars. |
count | integer · 10-500 | 90 | Number of stars to scatter. |
opacity | number · 0.1-1 | 0.55 | Max star opacity (min is always 0.15). |
Type · scene · animated
Native SMIL animation — no JavaScript, no framework. Drop any scene URL into an <img> tag and it plays in every modern browser. Respects prefers-reduced-motion at the OS level automatically.
staticEvery scene accepts ?static=1, which returns the same SVG but omits all <animate> /<animateTransform> elements. Use for reduced- motion preferences, OG previews, print output, or anywhere a still-frame reads better than motion.
// Client-side — swap the URL based on user preference
const prefersReducedMotion =
window.matchMedia("(prefers-reduced-motion: reduce)").matches;
const url =
`https://insightsbyomkar.com/api/studio/illustrate?` +
`type=scene&slug=pulse&size=120` +
(prefersReducedMotion ? "&static=1" : "");slug=pulse · status indicatorConcentric ring emitter — a dot + N staggered rings expanding and fading. Drop-in for loading states, live status, attention marks, meditation apps, anything that needs to feel alive.
| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Ring + dot colour. |
size | integer · 40-480 | 120 | Render dimensions. |
duration | number · 0.5-10 | 2.4 | Seconds per ring lifetime. |
rings | integer · 1-5 | 3 | Number of staggered rings. |
strokeOnly | boolean | true | Stroked rings (default) vs filled. |
slug=orbit-loader · spinnerN concentric orbital dots with Kepler-like slowdown per outer ring. Alternates direction by default. Fits any tech, SaaS, or product loader surface that deserves better than a CSS spinner.
| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Orbit + dot colour. |
size | integer · 40-480 | 140 | Render dimensions. |
duration | number · 0.5-20 | 2.4 | Seconds for the innermost orbit. |
orbits | integer · 1-5 | 3 | Number of concentric orbits. |
alternate | boolean | true | Flip rotation direction every other orbit. |
slug=wave · audio / time / rhythmHorizontal sine wave with seamless scroll. Multi-layered for a parallax feel. A generic audio / time / rhythm motif — use for progress, presence, waveform backdrops, or anything that signals motion through time.
| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Wave stroke colour. |
width | integer · 120-1600 | 400 | Width in px. Height is 40% of width. |
duration | number · 1-60 | 6 | Seconds per wavelength scroll. |
frequency | number · 0.5-8 | 2 | Number of wavelengths visible. |
amplitude | number · 0.05-0.9 | 0.35 | Wave amplitude as fraction of height. |
layers | integer · 1-4 | 2 | Overlapping layers for parallax depth. |
slug=wordmark-draw · logo reveal (any brand)Custom text rendered as an animated SVG logo — letters enter with staggered opacity + optional vertical drop. Drop-in <img>, plays in every modern browser, zero JS. Use it for the first-fold brand reveal on any landing page.
| Param | Type | Default | Notes |
|---|---|---|---|
text | string (≤ 40 chars) | (required) | Letters, numbers, spaces, basic punctuation only — same filter as the brass-divider label. |
variant | "fade" | "drop" | "wave" | drop | `drop` slides letters down + fades in; `wave` alternates up/down; `fade` is opacity only. |
color | css colour | #d4a550 | Text fill colour. |
fontSize | integer · 16-200 | 64 | Letter size in px. |
duration | number · 0.2-5 | 0.8 | Seconds each letter's entrance takes. |
stagger | number · 0-0.5 | 0.08 | Seconds between consecutive letter starts. |
family | "serif" | "sans" | "mono" | serif | Safe system-font stack. Georgia / system-ui / SF Mono. |
italic | boolean (1/0) | 0 | Italicise the whole wordmark. |
weight | integer · 300-700 | 400 | Font weight. |
tracking | number (em) · -0.1 to 0.5 | 0.01 | letter-spacing in em. |
slug=constellation · alive surfaceSeeded dot field with proximity-based connecting lines and per-node drift. The canonical “alive tech surface” motif — AI product landings, dashboards, onboarding flows, brand accents. Fully deterministic: same seed always produces the same layout.
| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Node + line colour. |
size | integer · 120-800 | 320 | Render dimensions. |
duration | number · 2-60 | 8 | Seconds per drift cycle. |
count | integer · 8-60 | 24 | Number of nodes. |
seed | string (≤ 64 chars) | studio | Deterministic layout seed. |
connect | number · 0.05-0.5 | 0.22 | Max connection distance as a fraction of size. |
slug=moon-cycle · lunar animationFull lunation cycle (new → full → new) as a single SMIL loop. Also works as a decorative animation for anything night / cycle / time themed.
| Param | Type | Default | Notes |
|---|---|---|---|
color | css colour | #d4a550 | Illuminated-side colour. |
size | integer · 80-640 | 200 | Render dimensions. |
duration | number · 2-120 | 12 | Seconds per full cycle. |
hemisphere | "north" | "south" | north | Flip the illuminated side. |
darkColor | css colour | transparent | Fill behind the dark side. |
ringOpacity | number · 0-1 | 0.55 | Moon disc outline opacity. |
Copy, paste, ship
<img
src="https://insightsbyomkar.com/api/studio/illustrate?type=zodiac&slug=leo&size=48"
width="48" height="48" alt="Leo zodiac glyph"
/>export function ZodiacGlyph({ sign, size = 48 }: { sign: string; size?: number }) {
return (
<img
src={`https://insightsbyomkar.com/api/studio/illustrate?type=zodiac&slug=${sign}&size=${size}`}
width={size}
height={size}
alt={`${sign} glyph`}
/>
);
}curl -L "https://insightsbyomkar.com/api/studio/illustrate?type=pattern&slug=grand-trine&size=240" -o grand-trine.svgOne fetch, every glyph
/api/studio/illustrate/sprite returns a single hidden SVG document that defines every glyph as a <symbol>. Drop it in your head once, reference any symbol by id with<use>. Cached one week in the browser, one month on the edge.
set=zodiac · 12 signsset=planet · 14 bodies and pointsset=aspect · 5 aspect glyphsset=icon · 27 universal UI iconsset=all · default — all 58 glyphs + icons in one file| Param | Type | Default | Notes |
|---|---|---|---|
set | "zodiac" | "planet" | "aspect" | "all" | all | Which glyph set to inline as symbols. |
prefix | string (≤ 16 chars) | (none) | Prepends to every symbol id. Useful when multiple sprites live on the same page. |
<!-- Once, somewhere in the page (hidden, zero layout cost) -->
<svg width="0" height="0" style="position:absolute">
<use href="https://insightsbyomkar.com/api/studio/illustrate/sprite?set=zodiac" />
</svg>
<!-- Anywhere after that -->
<svg width="48" height="48" viewBox="0 0 24 24" aria-label="Leo">
<use href="#leo" />
</svg>TypeScript SDK · source-available
Drop lib/studio/illustrate/url-builder.ts into any codebase. One illustrateUrl() function backed by a discriminated TypeScript union of every endpoint — invalid type / slug combinations fail to compile, out-of-range params throw at construction time. No runtime deps. This page’s dogfood grid uses it; so does the playground above.
// Copy-paste the file — 0 runtime deps, TS-only imports.
// Available at: lib/studio/illustrate/url-builder.tsimport { illustrateUrl, spriteUrl, paletteUrl } from "@/lib/studio/illustrate/url-builder";
// Glyph — compile-time guaranteed valid slug.
const leo = illustrateUrl({ type: "zodiac", slug: "leo", size: 64 });
// Pattern with real planet glyphs at each apex.
const tsq = illustrateUrl({
type: "pattern",
slug: "t-square",
bodies: ["sun", "saturn", "pluto"],
labels: false,
});
// Animated scene with a reduced-motion fallback.
const prefersReduced =
window.matchMedia("(prefers-reduced-motion: reduce)").matches;
const pulse = illustrateUrl({
type: "scene",
slug: "pulse",
size: 120,
duration: 2.4,
static: prefersReduced,
});
// Companions.
const sprite = spriteUrl({ set: "zodiac", prefix: "ibo-" });
const css = paletteUrl({ element: "fire", format: "css" });type: "zodiac", slug: "mars" → TS error (mars is not a ZodiacSign).type: "scene", slug: "pulse", frequency: 2 → TS error (frequency belongs to wave, not pulse).type: "ornament", slug: "chart-ring", corner: "tl" → TS error (corner belongs to corner-mark).< > " ' ; `).count: 9999).Companion endpoint
/api/studio/palette returns the four observatory element palettes (fire, earth, air, water) — five named swatches each. JSON by default, or ?format=css for a drop-in[data-element] rule block.
curl -L https://insightsbyomkar.com/api/studio/palette?element=fire<link rel="stylesheet"
href="https://insightsbyomkar.com/api/studio/palette?format=css" />| Param | Type | Default | Notes |
|---|---|---|---|
element | "fire" | "earth" | "air" | "water" | (all) | Filter to a single element. |
format | "json" | "css" | json | `css` emits ready-to-use [data-element=…] rule blocks. |
Try it
Every parameter in these tables is wired into the product page. Tweak the controls, watch the URL rebuild, then paste it wherever.