Roadmap

What is in progress, what is next and what has shipped. Finished items also get a changelog entry.

Planned

10
  • Revisit the fill color

    fill (neutral-100) reads heavy on white. The docs site uses it at 30% on panels for now.

    Foundations
  • Light-mode contrast

    ink-subtle is 2.8:1 on bg (ink-muted now passes at 5.7:1); line-strong borders on controls are faint.

    Foundations
  • Icon sizes against the 24px grid

    Icon size tokens (13 / 16 / 20) predate the Figma set.

    Foundations
  • A menu icon

    The phone menu button borrows more.

    Foundations
  • Primary and secondary role names

    Consider renaming accent / accent-2. A token rename plus a CSS sweep.

    Foundations
  • Visual refinement pass

    Bring each component in line with Figma, one category at a time.

    Components
  • Tokenise fixed sizes

    Toggle, checkbox, ring and map pin keep their own sizes.

    Components
  • Product guidance

    Component Markdown bodies are placeholders; the generated spec carries the pages.

    Components
  • Components in Figma

    Component sets bound to the variables, mirroring system/components.

    Figma
  • Flutter port of tokens and components

    velio_tokens.dart is generated; widgets follow docs/handoff-flutter.md.

    Handoff

Ongoing

2
  • Docs site frame in Figma

    Keep the site frame (Social → System → overview) in step with the live sidebar and pages.

    Figma
  • Dark theme review

    Every role has a dark value; accent tints, status tints and inverse surfaces need design review.

    Foundations

Done

10
  • Changelog, roadmap and contribution guide
    Docs site
  • Docs site quality pass

    Sidebar keeps its place, outlined surfaces, view transitions, motion.

    Docs site
  • Docs site shell from Figma
    Docs site
  • Icons from Figma

    43 fill icons; Lucide removed.

    Foundations
  • Elevation and motion
    Foundations
  • Space, radius and size
    Foundations
  • Type roles

    Mirrored to Figma variables and text styles.

    Foundations
  • Color roles and palette

    Mirrored to Figma variables with Light and Dark modes.

    Foundations
  • Primary button from Figma
    Components
  • Gen UI merged into the design system
    Gen UI