The responsive layout is in early preview. Please report any bugs.
Design Tokens
Paste Design System Tokens package with a number of different formats for Web, Mobile, and Sketch.
Version 7.3.0
The Paste design tokens are available as a NPM package which acts as the central source of truth for Paste. By using this package correctly, you can rely on a well-maintained, up-to-date definition of Twilio's Design Language. A simple way to grab or view the latest files in this package is to visit UNPKG - @twilio-paste/design-tokens.
Paste Design Tokens are supported in the following formats within this package:
- JSON
- Less
- SCSS
- CSS custom properties
- Android XML
- iOS JSON
- JavaScript
- Typescript definitions
- Sketch Palette
Paste supports multiple themes. This is done by exporting the same token formats for each theme. Each file in the root of the design tokens package is exported for each theme with the corresponding values updated for each token. This allows different parts of Twilio to have their own visual styles whilst still maintaining a consistent Twilio feel, coherent component behavior, and preventing Design System bloat.
See our list of Tokens and their corresponding values in the Token List page.
Within themes, we presently have support for:
As you use Paste, you'll likely encounter things that don't seem right. Please reach out with your feedback! Here's some prompts to consider:
- Is this page easy for me to consume?
- Is the information supporting it sufficient / well-described?
- What information is missing?
- How approachable is the documentation? Can a new engineer / PM / designer at Twilio get started with it easily?
Changelog
1c7765ac0#2467 Thanks @andipants12! - [Design tokens] Add a new generic export featuring additional metadata. This can be used in documentation or software tooling.- CommonJS export
tokens.generic.js - complimentary declaration file included
tokens.generic.d.ts - Maps token buckets/categories (e.g. "background-colors") to a list of token objects.
- CommonJS export
ae9dd50f#2466 Thanks @TheSisb! - [All packages] Update our ESBuild version and remove minification of identifiers in our production builds.
9983b52e9#2419 Thanks @gloriliale! - [Combobox, Data grid, Color contrast utils, Customization, Design tokens, Icons, Style props, Token contrast checker, Types, Utils, Website] Consolidate and update lodash dependencies and the way lodash is imported in our files, per lodash's guidance. Details: https://lodash.com/per-method-packages
3482db481#2355 Thanks @TheSisb! - [Design-Tokens] remove the 'Courier New' font from the code font family, falling back to 'Courier' instead.
8e5dfe1e#2298 Thanks @shleewhite! - [Tokens] add i18n font family tokens
27528be7#2286 Thanks @gloriliale! - [Design Tokens] added new background color, box shadow, text color, border color, border radius tokens to support badge styling
73c596919#2269 Thanks @SiTaggart! - Fixed a regression with the compilation script that caused incompatible ESM module importing of JSON files.
0cd424df4#2184 Thanks @loreina! - [design-tokens] Update alias and add new tokens to be accessible in Dark theme- Aliases
- Added a new alias
palette-gray-110
- Added a new alias
- Global: background-color
- Updated
color-background-inverseto gray-90 - Updated
color-background-inverse-strongto gray-80
- Updated
- Global: border color
- Added
color-border-inverse-weakesttoken pointing to gray-90 - Updated
color-border-inverse-weakerto gray-80 - Updated
color-border-inverseto gray-50 - Updated
color-border-inverse-strongto gray-20 - Updated
color-border-inverse-strongerto gray-10 - Neutral
- Updated
color-border-neutral-weakto blue-40
- Updated
- Added
color-border-error-strongertoken pointing to red-90
- Added
- Global: box shadow
- Added
shadow-border-error-strongerpointing to red-90 - Added
shadow-border-inverse-weakestpointing to gray-90 - Updated
shadow-border-inverse-weakerto gray-80 - Updated
shadow-border-inverseto gray-50- Updated
shadow-border-inverse-strongto gray-20 - Updated
shadow-border-inverse-strongerto gray-10
- Updated
- Added
- Dark theme: background color
- Updated
color-backgroundto gray-100 - Updated
color-background-strongto gray-90 - Updated
color-background-strongerto gray-80 - Updated
color-background-inverseto gray-90 - Updated
color-background-inverse-strongto gray-80 - Updated
color-background-bodyto new alias gray-110 - Updated
color-background-overlayto palette-gray-100-transparent-90 - Updated
color-background-row-stripedto gray-100 - Updated
color-background-subaccountto gray-90 - Updated
color-background-trialto green-100 - Brand
- Updated
color-background-brandto gray-100 - Updated
color-background-brand-strongto gray-90
- Updated
- Primary
- Updated
color-background-primary-strongestto blue-10 - Updated
color-background-primary-strongerto blue-20 - Updated
color-background-primary-strongto blue-30 - Updated
color-background-primaryto blue-60 - Updated
color-background-primary-weakto gray-80 - Updated
color-background-primary-weakerto gray-90 - Updated
color-background-primary-weakestto gray-100
- Updated
- Destructive
- Updated
color-background-destructive-strongestto red-10 - Updated
color-background-destructive-strongerto red-20 - Updated
color-background-destructive-strongto red-30 - Updated
color-background-destructiveto red-60 - Updated
color-background-destructive-weakto gray-80 - Updated
color-background-destructive-weakerto gray-90 - Updated
color-background-destructive-weakestto gray-100
- Updated
- Success
- Updated
color-background-successto green-60
- Updated
- Warning
- Updated
color-background-warningto orange-60
- Updated
- Error
- Added
color-background-error-strongerpointing to red-20 - Updated
color-background-error-strongto red-40 - Updated
color-background-errorto red-60
- Added
- Updated
- Dark theme: border color
- Updated
color-border-weakto gray-80 - Updated
color-border-weakerto gray-90 - Inverse
- Removed
color-border-inverse-weaker - Removed
color-border-inverse - Removed
color-border-inverse-strong - Removed
color-border-inverse-stronger - Removed
color-border-inverse-strongest
- Removed
- Primary
- Updated
color-border-primary-strongestto blue-10 - Updated
color-border-primary-strongerto blue-20 - Updated
color-border-primary-strongto blue-30 - Updated
color-border-primaryto blue-60 - Updated
color-border-primary-weakto gray-80 - Updated
color-border-primary-weakerto gray-90 - Updated
color-border-primary-weakestto gray-100
- Updated
- Destructive
- Updated
color-border-destructive-strongestto red-10 - Updated
color-border-destructive-strongerto red-20 - Updated
color-border-destructive-strongto red-30 - Updated
color-border-destructiveto red-60 - Updated
color-border-destructive-weakto gray-80 - Updated
color-border-destructive-weakerto gray-90 - Updated
color-border-destructive-weakestto gray-100
- Updated
- Success
- Updated
color-border-successto green-60 - Updated
color-border-success-weakto green-70
- Updated
- Warning
- Updated
color-border-warningto orange-60 - Updated
color-border-warning-weakto orange-70
- Updated
- Error
- Added
color-border-error-strongerpointing to red-20 - Updated
color-border-error-strongto red-30 - Updated
color-border-errorto red-60 - Updated
color-border-error-weakto red-70
- Added
- Neutral
- Updated
color-border-neutralto blue-60 - Updated
color-border-neutral-weakto blue-70
- Updated
- Updated
- Dark theme: box shadow
- Elevation
- Update
shadow-elevation-10toblack-transparent-40 - Update
shadow-elevation-20toblack-transparent-50 - Update
shadow-elevation-30toblack-transparent-50
- Update
- Focus
- Updated
shadow-focusto gray-60 - Updated
shadow-focus-inverseto gray-50 - Updated
shadow-focus-insetto gray-60
- Updated
- Primary
- Updated
shadow-border-primaryto blue-60
- Updated
- Destructive
- Updated
shadow-border-destructiveto red-60 - Updated
shadow-border-destructive-strongto red-30 - Updated
shadow-border-destructive-strongerto red-20 - Updated
shadow-border-destructive-strongestto red-10
- Updated
- Error
- Updated
shadow-border-errorto red-60 - Updated
shadow-border-error-strongto red-30
- Updated
- Inverse
- Removed
shadow-border-inverse-weaker - Removed
shadow-border-inverse - Removed
shadow-border-inverse-strong - Removed
shadow-border-inverse-stronger - Removed
shadow-border-inverse-strongest
- Removed
- Elevation
- Dark theme: text color
- Updated
color-text-weakto gray-50 - Updated
color-text-weakerto gray-80 - Updated
color-text-weakestto new alias gray-110 - Updated
color-text-inverse-weakerto gray-70 - Link
- Updated
color-text-link-weakto gray-80 - Updated
color-text-link-strongerto gray-0 - Updated color-text-link-destructive-weak to gray-80
- Updated
color-text-link-destructive-strongerto gray-0
- Updated
- Success
- Updated
color-text-successto green-30
- Updated
- Neutral
- Updated
color-text-neutralto blue-20
- Updated
- New
- Updated
color-text-newto purple-20
- Updated
- Icon
- Updated
color-text-iconto gray-50
- Updated
- Updated
- Aliases
c867e3f48#2237 Thanks @SiTaggart! - Updated a build dependency (esbuild) which changes the output of our builds slightly, without materially changing anything about the code.
0a52eeee#2168 Thanks @shleewhite! - [Design Tokens] Deprecated the console theme. The package no longer exports console tokens, the default tokens should be used instead.
04de0d1d#2093 Thanks @TheSisb! - [Design Tokens] Add data-visualization tokens for 10 categorical (sequential) colors. These can be used to accessibly theme chart content, like bars in bar charts or lines in line charts.
97da2b6b7#2028 Thanks @gloriliale! - [design-tokens] Changed the alias that Dark mode's color-text-icon points to from gray-10 to gray-60
5c99798b#1996 Thanks @gloriliale! - Updated and added link colors to the default theme and dark theme.
bdff8b23#1928 Thanks @loreina! - [Tokens] Added shadow-focus-inset token to dark theme, and adjusted shadow-focus-inset token value for default theme.
d13c1095#1911 Thanks @andipants12! - [paste-design-tokens] Added the following tokens for usage with the Connectivity variant and status pattern:- color-text-icon-available:
- color-text-icon-busy
- color-text-icon-unavailable
- color-text-icon-offline
bec21fa0#1893 Thanks @TheSisb! - Added 'shadow-focus-inset', a box-shadow token representing an inset focus outline.
866cf8f1#1835 Thanks @nkrantz! - [Design tokens] Text, background, and icon color tokens are updated to meet accessibility guidelines.
30160725#1774 Thanks @nkrantz! - Added an alias for orange-65 and added the following text color tokens for icons:- color-text-icon-error -> red-60 (default) / red-40 (dark)
- color-text-icon-success -> green-70 (default) / green-50 (dark)
- color-text-icon-warning -> orange-65 (default) / orange-40 (dark)
- color-text-icon-neutral -> blue-80 (default) / blue-40 (dark)
- color-text-icon-brand-highlight -> amaranth
- color-text-icon-brand-inverse -> gray-0
a2860c3b#1708 Thanks @nkrantz! - Addcolor-border-inverse-strongandshadow-border-inverse-stronger, adjustshadow-border-inverse-strongto align color-border tokens and shadow-border tokens.
10f4a285#1310 Thanks @SiTaggart! - [design tokens] export design token types from the design-tokens page [theme]GenericTokenShapeis now calledGenericTokensShapeand exported from@twilio-paste/design-tokens
c42f86ca#1434 Thanks @SiTaggart! - [design-tokens]: Added two extra brand based background tokens. Update the new design tokens for better dark mode contrast.Renamed black aliases in the dark theme as they are not palette colors.
Updated meta data for weak and strong design tokens to reflect their new naming convention
f551079a#1505 Thanks @richbachman! - Fixed shadow-border, shadow-border-weak, shadow-border-weaker, shadow-border-strong values to match respective color-border-* values in all themes.Shadow-border-stronger token has been removed in all themes.
Default theme
Token Original color value New color value shadow-border-weak NA palette-gray-30 shadow-border-weaker NA palette-gray-20 shadow-border-strong palette-gray-30 palette-gray-60 Console theme
Token Original color value New color value shadow-border-weak NA palette-gray-50 shadow-border-weaker NA palette-gray-40 shadow-border-strong palette-gray-40 palette-gray-60 Dark theme
Token Original color value New color value shadow-border palette-gray-50 palette-gray-60 shadow-border-weak NA palette-gray-70 shadow-border-weaker NA palette-gray-80 shadow-border-strong palette-gray-90 palette-gray-50
62f7fd3e#1451 Thanks @SiTaggart! - [design-tokens] Adding for availability tokens to display entity status such as available, offline and busy
25a1f632#1404 Thanks @SiTaggart! - Add a dark theme to Paste
25a1f632#1404 Thanks @SiTaggart! - Design tokens that are named using the light / dark nomenclature are being deprecated in favour of a new set of tokens based on a weak / strong nomenclature to accommodate light and dark modes.If you are using these tokens with our
BoxorTextcomponent, these will still work for now but we will be removing them in the 2021.11.16 release of Paste. In most cases replacingdarkforstrongandlightforweakis all that is required to transition.Design tokens that are being deprecated include:
old new color-background-dark color-background-strong color-background-darker color-background-stronger color-background-darkest color-background-strongest color-background-inverse-light color-background-inverse-weak color-background-neutral-lightest color-background-neutral-weakest color-background-success-lightest color-background-success-weakest color-background-warning-lightest color-background-warning-weakest color-background-error-dark color-background-error-strong color-background-error-lightest color-background-error-weakest color-background-primary-darkest color-background-primary-strongest color-background-primary-darker color-background-primary-stronger color-background-primary-dark color-background-primary-strong color-background-primary-light color-background-primary-weak color-background-primary-lighter color-background-primary-weaker color-background-primary-lightest color-background-primary-weakest color-background-destructive-darkest color-background-destructive-strongest color-background-destructive-darker color-background-destructive-stronger color-background-destructive-dark color-background-destructive-strong color-background-destructive-light color-background-destructive-weak color-background-destructive-lighter color-background-destructive-weaker color-background-destructive-lightest color-background-destructive-weakest old new color-border-dark color-border-strong color-border-light color-border-weak color-border-lighter color-border-weaker color-border-inverse-darker color-border-inverse-weaker color-border-inverse-lighter color-border-inverse-stronger color-border-inverse-lightest color-border-inverse-strongest color-border-primary-darkest color-border-primary-strongest color-border-primary-darker color-border-primary-stronger color-border-primary-dark color-border-primary-strong color-border-primary-light color-border-primary-weak color-border-primary-lighter color-border-primary-weaker color-border-neutral-light color-border-neutral-weak color-border-success-light color-border-success-weak color-border-success-lightest color-border-success-weakest color-border-warning-light color-border-warning-weak color-border-warning-lightest color-border-warning-weakest color-border-error-dark color-border-error-strong color-border-error-light color-border-error-weak color-border-error-lightest color-border-error-weakest color-border-destructive-darkest color-border-destructive-strongest color-border-destructive-darker color-border-destructive-stronger color-border-destructive-dark color-border-destructive-strong color-border-destructive-light color-border-destructive-weak color-border-destructive-lighter color-border-destructive-weaker old new shadow-border-lighter shadow-border-weaker shadow-border-light shadow-border-weak shadow-border-primary-lighter shadow-border-primary-weaker shadow-border-primary-light shadow-border-primary-weak shadow-border-primary-dark shadow-border-primary-strong shadow-border-primary-darker shadow-border-primary-stronger shadow-border-destructive-lighter shadow-border-destructive-weaker shadow-border-destructive-light shadow-border-destructive-weak shadow-border-destructive-darker shadow-border-destructive-stronger shadow-border-error-light shadow-border-error-weak shadow-border-error-dark shadow-border-error-strong shadow-border-inverse-darker shadow-border-inverse-weaker shadow-border-inverse-light shadow-border-inverse-strong shadow-border-inverse-lightest shadow-border-inverse-strongest old new color-text-link-light color-text-link-weak color-text-link-dark color-text-link-strong color-text-link-darker color-text-link-stronger color-text-link-destructive-light color-text-link-destructive-weak color-text-link-destructive-dark color-text-link-destructive-strong color-text-link-destructive-darker color-text-link-destructive-stronger color-text-error-light color-text-error-weak color-text-error-dark color-text-error-strong color-text-warning-dark color-text-warning-strong
4c9ed5ca#1236 Thanks @richbachman! - The SendGrid theme now inherits everything from the Default theme, except for font family. The SendGrid theme uses Colfax forfont-family-text.
944c3407#1221 Thanks @SiTaggart! - Pointed font-weight-light to the font-weight-normal alias in the default theme as we do not want people using 300 weight text in our default UIs
All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.
6.5.1 (2021-01-25)
Note: Version bump only for package @twilio-paste/design-tokens
6.4.1 (2021-01-07)
Note: Version bump only for package @twilio-paste/design-tokens
- design-tokens: switch default theme font family to inter var (796a3bb)
6.3.7 (2020-12-09)
Note: Version bump only for package @twilio-paste/design-tokens
6.3.6 (2020-11-06)
Note: Version bump only for package @twilio-paste/design-tokens
6.3.5 (2020-10-23)
Note: Version bump only for package @twilio-paste/design-tokens
6.3.4 (2020-10-07)
Note: Version bump only for package @twilio-paste/design-tokens
6.3.3 (2020-09-22)
Note: Version bump only for package @twilio-paste/design-tokens
6.3.2 (2020-09-15)
Note: Version bump only for package @twilio-paste/design-tokens
6.3.1 (2020-09-15)
Note: Version bump only for package @twilio-paste/design-tokens
- design-tokens: add line-height-0 (693165f)
6.2.2 (2020-08-31)
Note: Version bump only for package @twilio-paste/design-tokens
6.2.1 (2020-08-31)
Note: Version bump only for package @twilio-paste/design-tokens
- design-token: adjust the line-height scale (6531091)
6.1.1 (2020-08-12)
Note: Version bump only for package @twilio-paste/design-tokens
- design-tokens: add missing udl boxShadow tokens (2b6f6a1)
6.0.1 (2020-08-04)
- design-tokens: tidy offset aliases for ease of use (0b8a00c)
- design-tokens: updates to default and console aliases and tokens (a3d02e2)
- design-tokens:
color-background-inversehas been changed to a transparent color. Usecolor-background-body-inverseinstead.color-text-labelhas been removed.color-text-placeholderhas been removed.
- design-tokens: add negative space tokens (3bc718f)
- design-tokens: add color-border-light and color-border-lighter (83d0b04)
5.3.2 (2020-07-14)
Note: Version bump only for package @twilio-paste/design-tokens
5.3.1 (2020-07-01)
Note: Version bump only for package @twilio-paste/design-tokens
- design-tokens: adding 2 new border-width tokens (69ae496)
5.2.2 (2020-06-12)
Note: Version bump only for package @twilio-paste/design-tokens
5.2.1 (2020-06-01)
Note: Version bump only for package @twilio-paste/design-tokens
- design-tokens: create color-text-weaker token (3c63e32)
- design-tokens: updates to border and shadow-border tokens (c7f687d)
- design-tokens: Removed and renamed some border and shadow border tokens
- removed color-border-input -> use color-border
- removed color-border-input-hover
- removed color-border-input-focus
- renamed shadow-border-input -> shadow-border
- renamed shadow-border-input-hover -> shadow-border-primary-dark
- renamed shadow-border-input-disabled -> shadow-border-light
- renamed shadow-border-input-error -> shadow-border-error
- renamed shadow-border-input-error-hover -> shadow-border-error-dark
4.5.1 (2020-05-01)
Note: Version bump only for package @twilio-paste/design-tokens
- design-tokens: add background and square sizes tokens (7c8f8e6)
4.4.1 (2020-04-22)
- design-tokens: add overlay background token, switch to rgb colors (d9f783b)
- design-tokens: add boxShadow tokens for input borders (20022ec)
4.1.4 (2020-02-28)
Note: Version bump only for package @twilio-paste/design-tokens
4.1.3 (2020-02-26)
4.1.2 (2020-02-13)
4.1.1 (2020-02-03)
- design-token: add new status tokens (462f471)
- design-tokens: create paste and console themes (d550e4e)
- design-tokens: Move the default theme values to be the console theme Make the default theme the Paste theme based on new unified design language
3.0.5 (2019-12-19)
3.0.4 (2019-12-05)
3.0.3 (2019-11-20)
3.0.2 (2019-11-18)
- design-tokens: change color-text-link token values (#172) (f0a215c)
- design-tokens: update lightest console color palette (#174) (98b625c)
- correct button heights add new default icon size (#186) (2e54478)
- design-tokens: update some blues, reds, and focus shadow (#185) (98d70cc)
3.0.1 (2019-11-12)
Note: Version bump only for package @twilio-paste/design-tokens
- icons: delete old icons, add new streamline icons (#129) (571791d)
- typography: heading component (#149) (4e033e6)
- icons: removed all the inherited icons since we're moving to a new system
- design-tokens: fix SendGrid token values (#71) (396fccf)
- design-tokens: typo on word
borderr(#56) (6b5edd1) - tokens: correct the box shadow tokens category and type (#95) (fe0f946)
- design-tokens: resolve path correctly (6f89111)
- tokens: added missing SG token values (#22) (23d7385)
- change @paste scope to @twilio-paste (#2) (1d8d2ff)
- run eslint across the right files and fix any issues that arise. (#21) (2fcc872)
- swap light/dark border token colors (0a99d3c)
- Type-checking fixes (#12) (be02450)