Feature 02 · Token Library

The team shared motion vocabulary - browsable, searchable, and always in sync.

Overview

The token library is the home screen of Tokn. It shows every token in the workspace as a card grid - name, category, key values, and a visual timeline preview. It is where team members quickly discover what tokens exist, what they feel like, and how to use them. It is always live, never a static doc that goes stale.

User flow

WhatHow it worksWhy it matters
Land on Library tabGrid of all tokens loads instantly from cache. 12 token cards in 3 columns.First impression sets the bar. Must feel fast and complete with no loading spinners.
Filter by categoryClick Enter, Exit, Spring, or Feedback category pills. Grid filters instantly.Developers usually know the category they need first. Reduce noise immediately.
Search by nameType in search bar. Cards filter in real time by matching token name.Developers type to find. Search must work on partial matches, for example def -> enter.default.
Preview animationEach card shows colored timeline bars. Hover card to see a subtle animation indicator.Visual preview lets developers evaluate feel without clicking into each token.
Open token detailClick any card to open the token detail panel with that token selected.Library is read-oriented discovery while detail view is editing and operations.
Copy from libraryEach card has a copy action that copies the Framer Motion export for that token.Power users copy directly from the library without entering a full editor flow.
Share the libraryShare library button in the top bar copies a public preview URL.The same data can be shared in a read-only format for fast async reviews.

Token card anatomy

  • Top left: token name in mono style.
  • Top right: category badge using category color mapping.
  • Middle: animation preview area with hover-triggered motion replay.
  • Bottom left: primary value such as duration + easing or spring values.
  • Bottom right: quick actions including open and copy.
  • Hover state: border accent appears for faster scanning.
  • Deprecated token: should display with strike styling and a deprecated badge.

Default token set - auto-created on workspace creation

Every new workspace gets 8 baseline tokens automatically, so teams start with a useful motion vocabulary and customize from there instead of starting from a blank slate.

Token nameDurationEasingY OffsetCategory
enter.fast150msease-out8pxEnter
enter.default300msease-out16pxEnter
enter.slow500msease-in-out24pxEnter
exit.fast120msease-in8pxExit
exit.default200msease-in12pxExit
spring.bouncys:300 d:20spring-Spring
spring.gentles:200 d:30spring-Spring
feedback.success250msspring-Feedback

Success metric

A new team member opens the library, finds the right token, and copies export code without asking for help. Target time-to-copy for a new member: under 60 seconds.

Token Library

Browse, preview, and copy shared motion tokens.

enter

3 tokens
PURPLE
PURPLE
PURPLE

exit

2 tokens
CORAL
CORAL

spring

3 tokens
TEAL
TEAL
TEAL

feedback

4 tokens
AMBER
AMBER
AMBER
AMBER