Kunnworks

A shared language for design and development

Turn recurring interface patterns into tokens, components and guidance used in the product

Sleep care app UX/UI
Sleep care app UX/UI
Sleep care app UX/UI
App planning · UX/UI · onboarding · UX writing▷ Screen preview
Radar-based sleep care app UX/UI designTeam member’s prior planning and design work
IMPLEMENTATION SCOPE

Shared rules for design and code

Define color, spacing and typography tokens and document component states, inputs and accessibility. Connect design changes to code versioning and releases.

What we build
Design tokens · UI components · documentation · acceptance criteria
What we validate
Keyboard access, error/loading/disabled states, responsive and visual regression
Read the architecture, acceptance scenarios and handover details
IN YOUR EVERYDAY WORK

The same action.
A consistent experience.

Before listing features, we define the inputs, decisions and next actions in a real working situation.

An illustrative scenario. Specific processing rules are agreed for the project.

WORKFLOW EXAMPLEILLUSTRATIVE

Save buttons behave differently across screens.

Input
Default · in progress · success · error
Review
Keyboard operation and status messages
NEXT ACTION

Use the same state rules in design and code

When this service helps

When screens behave inconsistently or teams rebuild the same patterns

  1. 1

    Audit interfaces and user journeys

  2. 2

    Define tokens, components and states

  3. 3

    Apply them to the product with guidance

What the project delivers

  • Design tokens and interface rules
  • Agreed design and code components
  • Accessibility and change guidance

Specific features, integrations and operating support are agreed in the project proposal

Technical design and acceptance criteria

Details for technical reviewers. Architecture and acceptance criteria are agreed for the actual environment and project scope.

  • DTCG tokens
  • Figma variables
  • Component contracts
  • Accessibility / Visual regression

Processing flow and exceptions

A reference graph connects primitive values to semantic and component tokens. Themes change the semantic layer while components consume role-based references rather than hardcoded colors.

Design token referencesA reference graph connects primitive values to semantic and component tokens. Themes change the semantic layer while components consume role-based references rather than hardcoded colors.Design token referencesKUNNWORKS · DESIGN EXAMPLEPrimitiveSemantic / themeComponent#C73E2F#3C3C3C#FEFDFBaction.primarysurface.defaultbutton.fillfocus.ringReference a role, not a raw valueAliases for light and dark themesDefault / hover / active /disabledKeyboard navigation stateValidate types and aliases so design tools and code share the same contract
DESIGN SYSTEMS / FROM PRINCIPLES TO PRODUCTSDesign example · Refined against scope and constraints

Architecture summary

  1. Token references — Types, aliases, theme mappings, generated outputs
  2. Component contract — Figma variants ↔ props, states, events
  3. Product adoption — Versions, deprecation, and migration guides
02Acceptance criteria

Implementation and acceptance criteria

Concrete design decisions and acceptance scenarios to agree for the project.

Token references

ImplementationTypes, aliases, theme mappings, generated outputs

ValidationCycles, unresolved references, and theme switching

Component contract

ImplementationFigma variants ↔ props, states, events

ValidationLoading, errors, long content, and keyboard use

Product adoption

ImplementationVersions, deprecation, and migration guides

ValidationIntegration checks on representative product screens

Technology choices and acceptance criteria depend on discovery, integrations, and agreed scope. We define reproducible acceptance scenarios and handover evidence for the operating environment.

03Implementation details

Engineering decisions
in detail

From visible features to failure conditions,
we work through the decisions before launch.

01

Model tokens as a reference graph

Separate primitive, semantic, and component layers with types and aliases for color, spacing, typography, and motion. Assess the DTCG format for interchange and code transformation, validating cycles, unresolved aliases, and invalid types during builds. Express brand and dark-mode variation through semantic mappings rather than scattered screen-level overrides.

02

Align Figma properties with component contracts

Define size, variant, emphasis, disabled, loading, and error behavior as a component contract. Map Figma variants to code props and use composition when combinations become unmanageable. Documentation environments such as Storybook describe constraints, events, long content, and responsive behavior alongside examples, making the package usable by teams beyond its original authors.

03

Validate accessibility and regression at component level

Specify keyboard order, focus behavior, accessible names, roles, states, and error associations by pattern. Manually exercise behaviors that automated checks cannot establish, such as dialog focus restoration or combobox navigation. Use selected states, viewports, and themes as visual-regression baselines, with a review process that distinguishes intended changes from defects.

04

Govern adoption and the cost of change

Maintain package versions, changelogs, deprecation notices, and migration guides. Distinguish token-renaming impact from component API changes and adopt high-use patterns incrementally in existing products. Assign responsibility for proposals, design review, code review, and release so teams have a supported contribution path rather than maintaining disconnected copies.

04Handover

Detailed deliverables

  • Design principles, token definitions, themes, and naming rules
  • Figma library, agreed code components, and documentation
  • Pilot screens, state and accessibility checks, and governance and migration guides
05Before implementation

Questions before implementation

  • Target products and existing Figma and frontend assets
  • Supported frameworks, brands, themes, and languages
  • Initial shared screens and the future library owners

How your project moves forward

01

Discover

Understand your goals, workflows, and operating environment.

02

Define

Define features, priorities, and integration requirements.

03

Build

Build the agreed scope and review progress together.

04

Launch & Operate

Prepare testing, deployment, and operational handover.

Let’s discuss your project

Tell us what you want to build or improve
Our team will review your request and reply by email

Discuss your project