Skip to content

Every analytics tool wants a subscription. And your data. I built Twiligent instead. YouTube stats. Instagram stats. One dashboard. Runs locally on your machine.

15.4 KB
Raw Blame

Design Reference

This file records where every visual decision in the Twiligent interface comes from. Structure (layout, proportions, density, component shapes, states, motion) follows a measured reference interface. Skin (colour, typography, logo, accents, copy voice) comes from the Twiligent brand kit in frontend/public/.

Every token in frontend/src/index.css traces to a row in this file.


1. How the reference was measured

  • Source: the ElevenLabs web app, pages Home, Voice Library, Create Voice and Text to Speech, inspected on 2026-10-13 through Chrome DevTools (computed styles read with getComputedStyle, positions with elementFromPoint).
  • Viewport: 1442 x 788 CSS px at device pixel ratio 1.25, dark theme. Only the dark theme was available in the signed-in session; light values are derived from the brand kit (section 3).
  • Hairlines report as 0.8px because a 1 CSS px border snaps to one device pixel at 1.25 DPR. They are implemented as 1px.
  • Reference screenshots were captured to docs/screenshots/reference/ for side-by-side checks. That folder is git-ignored: it contains third-party branding and is never shipped or redistributed.
  • No ElevenLabs logos, illustrations, names, copy or assets are used in the product.

2. Measured reference values

Application shell

Element Measured value Twiligent token or class
Page ground (dark) #0F0F10 Brand dusk #140E10 used instead (skin)
Sidebar width 256px including a 1px right hairline --sidebar-w: 16rem
Sidebar ground #171717, one step lighter than the page --surface-sidebar dark #1A1214 (brand-tinted lift)
Sidebar edge 1px, foreground at 7.5% --line (ink at 8%)
Top bar height 50px, bottom hairline at 7.5% --topbar-h: 3.125rem
Top bar title 14px / 20px, weight 500 text-small font-medium breadcrumb
Content gutter from sidebar 20px sm:px-5 on the content column
Content top padding 23px below the top bar py-6

Navigation

Element Measured value Token or class
Row height 32px --nav-row-h: 2rem
Row inset from sidebar edge 12px SidebarContent px-1 plus group padding
Row padding / gap 0 8px / 8px px-2 gap-2
Row radius 10px --radius-row: 10px
Label 14px / 20px, weight 500 text-sm font-medium
Inactive label colour foreground at 64% --ink-muted
Active label colour foreground at 98% --ink
Active row fill foreground at 4.3% --surface-selected (ink at 6%, tuned for the warmer ground)
Icon 18px [&_svg]:size-[18px], Lucide at 1.75 stroke (brand)
Group heading 14px / 20px, weight 500, muted SidebarGroupLabel text-sm font-medium text-ink-muted
Hover transition 150ms cubic-bezier(0.4, 0, 0.2, 1) --duration-base, --ease-standard

Typography scale

Role Measured Twiligent
Home headline 28px / 36px, weight 400, -0.21px --text-display: 1.75rem / 2.25rem, Sora 600 (brand display face)
Page title 24px / 30px, weight 400, -0.15px --text-page-title: 1.5rem / 1.875rem, Sora 600
Section heading 16px / 24px, weight 550, -0.2px --text-section: 1rem / 1.5rem, Sora 600
Body and controls 14px / 20px --text-body: 0.875rem / 1.25rem, Manrope
Row metadata 13px / 19.5px, muted --text-small: 0.8125rem / 1.21875rem
Hints 12px / 16px, muted --text-caption: 0.75rem / 1rem
Editor text 16px / 24px text-base in the publish caption editor

Controls

Control Measured value Token or class
Primary button 36px tall, 10px radius, 0 12px, 14px weight 500 Button default: h-(--control-h) 36px, rounded-control 10px
Small button (top bar) 32px tall, 10px radius, 0 10px, 13px weight 500 size="sm": --control-h-sm 32px
Large control (search, filters, full-width actions) 40px tall, 12px radius, 0 16px size="lg" and fields: --control-h-lg 40px, --radius-field 12px
Secondary button border 1px, foreground at 10% --line-control (ink at 12%)
Search field 40px, 12px radius, 1px border, 14px text, focus border full foreground SearchField
Filter chip 40px, 12px radius, 1px border at 10%, 0 12px, 14px weight 500 FilterChips (36px for denser filter rows)
Inline suggestion chip 32px, 8px radius, 13px weight 500 size="sm" outline buttons
Control transition 75ms cubic-bezier(0.4, 0, 0.2, 1), colour only --duration-fast: 75ms

Tabs

Element Measured value Token or class
Style Underline tabs on a row with a 1px hairline TabsList default variant
Tab height 42px, padding 4px 0 10px h-[2.625rem]
Label 14px weight 500, inactive at 64% text-sm font-medium text-ink-muted
Active indicator 1px underline, foreground at 80% 2px underline in --brand (brand accent marks the active state)
Gap between tabs 6px to 14px gap-4

Surfaces and cards

Element Measured value Token or class
Creation choice card foreground wash at 4.3%, no border, 24px radius, 20px padding ChoiceCard: bg-surface-wash rounded-panel p-5
Choice card title / body 16px weight 500 / 14px muted text-base font-medium / text-sm text-ink-muted
Choice grid gap 20px rows, 12px columns gap-x-3 gap-y-5
Feature and media card 16px radius --radius-card: 16px
Banner panel 24px radius, 1px ring at 10% --radius-panel: 24px
List row title / meta 14px weight 600 / 13px muted ListRow
Avatar in list rows 32px circle AccountAvatar default

Working surface (text-to-speech pattern)

Element Measured value Twiligent
Settings panel 460px wide, right side, separated by a hairline DetailPanel in the Instagram publishing page, lg:w-[28rem]
Panel tabs underline tabs, 42px TabsList default
Field label 14px weight 500 FieldRow label
Field control 40px, 10px radius, 1px border at 10% --control-h-lg
Field hint 12px / 16px muted FieldRow hint

Dialogs and overlays

Element Measured value Token or class
Dialog radius 24px --radius-dialog: 24px
Dialog padding 32px p-8
Dialog title 24px / 30px weight 500 text-lg Sora 600 (denser dialogs in this product)
Full-width dialog action 40px, 12px radius size="lg"
Scrim neutral at 30%, no blur bg-[#0C0809]/40 (dusk-tinted)
Open and close 200ms --duration-overlay: 200ms

3. Brand kit inventory

Source folder: frontend/public/.

Logos (Logos/)

File Use
twiligent-lockup-horizontal.svg Primary lockup, colour mark plus dusk wordmark. Light theme sidebar.
twiligent-lockup-horizontal-reversed.svg Colour mark plus white wordmark. Dark theme sidebar.
twiligent-lockup-horizontal-dusk.svg, -white.svg Single-ink versions. Not used in the app.
twiligent-lockup-stacked.svg, -stacked-reversed.svg Square spaces. Used on the sign-in page.
twiligent-mark-color.svg The ribbon alone. Collapsed sidebar.
twiligent-mark-red.svg, -dusk.svg, -white.svg Single-colour marks for sizes under 24px.
twiligent-wordmark-*.svg Name alone. Not used.
twiligent-mark-original.png 1921 x 1663 master artwork. Not used at runtime.

All lockups are 4090 x 1000 (4.09:1). At the brand minimum of 24px tall the lockup is 98px wide.

App icons (App icons/)

File Use
twiligent-favicon.svg, twiligent-favicon-32.png Browser tab icon (red mark on dusk)
twiligent-app-icon-dusk-180.png Apple touch icon
twiligent-app-icon-dusk/paper/red at 32, 180, 512 and SVG Available for future install manifests

Fonts (fonts/, SIL OFL 1.1, self-hosted)

Family Weights included Role
Sora 600, 700 Display: page titles, section headings, metric values
Manrope 400, 500, 600, 700 Everything people read
JetBrains Mono 400, 500 Ranks, IDs, keyboard hints

Manrope 400, 500, 600 and Sora 600 are preloaded in index.html and declared with font-display: swap.

Guidelines applied (brand-guidelines.md)

  • Sentence case for headings, buttons and menus. No exclamation marks in product UI.
  • Red as text is brand-text, never the raw brand red on dusk.
  • Errors share the brand red, so every error carries an icon and a word.
  • Lucide icons at 1.75px stroke, taking the colour of adjacent text.
  • fold-gradient only for brand bands, never behind paragraphs. Used once, on the sign-in panel.
  • Keyboard focus: 2px solid ring, 2px offset, in focus-ring.

4. Structure versus skin decisions

Area Reference says Brand says Decision
Button shape 10 to 12px rounded rectangles Capsules for buttons and badges Buttons, inputs and chips follow the measured radii (structure). Badges and status tags keep the brand capsule as the ribbon echo.
Primary action fill Inverse (white on dark) Twiligent red Brand red (--brand), the signature accent.
Active tab Foreground underline Accent marks selection 2px brand underline.
Page ground #0F0F10 neutral Dusk #140E10 warm Dusk, with neutrals tinted toward brand ink.
Display face Proprietary display serif-sans Sora SemiBold Sora 600 at the measured sizes.
Hover timing 75ms controls, 150ms navigation 150ms colour changes Measured values (motion is structure). The 220ms fold entrance stays as the brand moment.
Nav icon size 18px 20px 18px to match the 32px row; 1.75 stroke from the brand.

5. Token table

Each colour pair that carries text was checked for WCAG AA (4.5:1 for text, 3:1 for UI boundaries and chart marks). Ratios were computed with the WCAG relative luminance formula.

Colour

Token Light Dark Source Check
--surface #F7F3EF #140E10 Brand surface
--surface-raised #FFFFFF #1F1719 Brand surface-raised
--surface-sunken #EFE8E3 #0C0809 Brand surface-sunken
--surface-sidebar #F3EEE9 #1A1214 Derived: midpoint between sunken and surface (light), lifted toward raised (dark) as measured ink 16.6:1 / 16.2:1, muted 6.4:1 / 8.3:1
--surface-hover ink 4% ink 4% Measured wash
--surface-selected ink 6% ink 6% Measured active row (4.3%), lifted for the warm ground on sidebar: ink 14.7:1 / 14.1:1, muted 5.7:1 / 7.3:1
--surface-wash ink 4.3% ink 4.3% Measured choice card fill
--line ink 8% over surface ink 8% over surface Measured hairline (7.5%) decorative
--line-control ink 12% over surface ink 12% over surface Measured control border (10%) decorative, paired with fill
--line-strong #8C7E83 #86777C Brand line-strong, text input borders 3.5:1 / 4.5:1 on surface
--ink #140E10 #F5EFEB Brand ink 17.3:1 / 16.8:1 on surface
--ink-muted #5F5357 #B8ABAF Brand ink-muted 6.7:1 / 8.6:1 on surface
--ink-faint #6A6565 #97918F Derived: ink mixed into surface at 62% / 58% 5.2:1 / 6.2:1 on surface, 5.0:1 / 5.9:1 on sidebar
--ink-inverse #FFFFFF #140E10 Brand ink-inverse 19.1:1 / 16.8:1 on ink
--brand #C11F2F #C11F2F Brand accent white on it 6.0:1
--brand-hover #9A1423 #D93444 Brand accent-hover white on it 8.4:1 / 4.6:1
--brand-soft #FBE7E8 #3A1419 Brand accent-soft
--brand-text #B01C2B #FF7A82 Brand accent-text 6.2:1 / 7.6:1 on surface, 5.8:1 / 6.5:1 on brand-soft
--success / -soft #1E7349 / #E2F3E9 #5FCB95 / #12301F Brand 5.1:1 / 7.1:1 text on soft
--warning / -soft #7F4C00 / #FCEFD9 #F2B65E / #3A2A12 Brand afterglow-text / afterglow-soft 6.3:1 / 7.7:1
--danger / -soft #B01C2B / #FBE7E8 #FF7A82 / #3A1419 Brand danger (shares accent-text) 5.8:1 / 6.5:1
--info / -soft #2C5A99 / #E5EDF8 #8DB3EC / #16243A Brand 5.9:1 / 7.3:1
--focus-ring #C11F2F #FF7A82 Brand focus-ring 5.4:1 / 7.6:1 on surface

Data visualisation

Series order follows the brand rule: red, ink-muted, afterglow, info, oxblood.

Token Light Dark Source Contrast on surface
--chart-1 #C11F2F #D93444 Brand red; dark uses brand accent-hover 5.4:1 / 4.1:1
--chart-2 #5F5357 #B8ABAF Brand ink-muted 6.7:1 / 8.6:1
--chart-3 #B5761A #E8A33D Brand afterglow; light derived darker because #E8A33D is 2.0:1 on paper 3.4:1 / 8.9:1
--chart-4 #2C5A99 #8DB3EC Brand info 6.3:1 / 8.9:1
--chart-5 #5E0B14 #B4626E Brand oxblood; dark derived lighter because oxblood is 1.4:1 on dusk 12.4:1 / 4.5:1

Platforms map to series: YouTube chart-1, Instagram chart-3, categories chart-2. Platform is always also named in a label or legend, never shown by colour alone.

Type, space, shape, elevation, motion

Token Value Source
--font-heading, --font-display Sora Brand
--font-sans Manrope Brand
--font-mono JetBrains Mono Brand
--text-display 28px / 36px, -0.02em Measured size, brand tracking
--text-page-title 24px / 30px, -0.015em Measured
--text-section 16px / 24px, -0.01em Measured
--text-body 14px / 20px Measured
--text-small 13px / 19.5px Measured
--text-caption 12px / 16px Measured
Spacing 4px base (Tailwind scale) Brand space-*
--radius-row 10px Measured
--radius-control 10px Measured
--radius-field 12px Measured
--radius-card 16px Measured, matches brand radius-lg
--radius-panel, --radius-dialog 24px Measured, matches brand radius-xl
--radius-pill 999px Brand capsule (badges)
--control-h-sm / --control-h / --control-h-lg 32 / 36 / 40px Measured
--nav-row-h 32px Measured
--topbar-h 50px Measured
--sidebar-w 256px Measured
--shadow-sm/md/lg Brand values Brand (borders before shadows)
--duration-fast 75ms Measured control transitions
--duration-base 150ms Measured navigation transitions
--duration-overlay 200ms Measured dialog transition
--duration-fold 220ms Brand fold entrance
--ease-standard cubic-bezier(0.4, 0, 0.2, 1) Measured
--ease-fold cubic-bezier(0.2, 0.8, 0.2, 1) Brand

6. Differences from the October 2026 baseline

Baseline Measured Note
Ground around #0F0F10 #0F0F10 Confirmed
Hairlines about 0.8px at 7.5 to 10% 1px CSS (0.8px at 1.25 DPR), 7.5% structural, 10% on controls Confirmed; the 0.8px is a DPR artefact
Sidebar about 255px 255.2px plus 0.8px edge Confirmed
32px navigation rows, 8px radius 32px rows; the active wash is 10px, the inner element 8px Radius is 10px for the visible fill
Controls 36 to 40px, 10 to 12px radius 32, 36 and 40px; 10px buttons, 12px fields and chips Adds a 32px tier for top-bar and inline actions
Underline tabs Underline tabs; the active tab also carries a faint bordered pill The pill is not reproduced; underline only
Large choice cards 24px radius, borderless wash, 20px padding Confirmed
Sidebar ground Not in baseline Sidebar is lighter than the page (#171717 vs #0F0F10)