Design System

Design Tokens Package

Paste Design System Tokens package with a number of different formats for Web, Mobile, and Sketch.

yarn add @twilio-paste/design-tokens — or — yarn add @twilio-paste/core

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.

Supported Formats#

While the Paste Tokens Package supports the following formats, our roadmap currently prioritizes React Components and Sketch Libraries as primary deliverables of the Design System. Reach out to us at #help-design-system if you'd like to use Paste for another format: we'll help you out as much as we can!

Paste Design Tokens are supported in the following formats within this package:


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. Here's an example of Themes:

Paste (default) themeConsole themeSendGrid theme
$color-brand-highlight: #F22F46$color-brand-highlight: #F22F46$color-brand-highlight: #3368FA
$font-weight-semibold: 600$font-weight-semibold: 500$font-weight-semibold: 600

See our list of Tokens and their corresponding values in the Token List page.

Within themes, we presently have support for:

Give us Feedback on this Page#

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?

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

5.2.0 (2020-05-20)


  • design-tokens: create color-text-weaker token (3c63e32)

5.1.0 (2020-05-07)


5.0.0 (2020-05-07)


  • 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

4.5.0 (2020-04-25)


  • design-tokens: add background and square sizes tokens (7c8f8e6)

4.4.1 (2020-04-22)

Bug Fixes#

  • tokens: Add shadow-border-input-* aliases, tokens to themes (#400) (a553100)

4.4.0 (2020-04-07)


  • design-tokens: add overlay background token, switch to rgb colors (d9f783b)

4.3.0 (2020-03-11)


  • design-tokens: add boxShadow tokens for input borders (20022ec)

4.2.0 (2020-03-02)


  • design-tokens: consistent iconsize to line-height tokens (#339) (00cb441)

4.1.4 (2020-02-28)

Note: Version bump only for package @twilio-paste/design-tokens

4.1.3 (2020-02-26)

Bug Fixes#

  • package dependencies and deprecation warnings (#334) (0e88338)

4.1.2 (2020-02-13)

Bug Fixes#

  • design-tokens: change sg gray-70 and color-border-inpt (#311) (642cfcc)

4.1.1 (2020-02-03)

Bug Fixes#

  • tokens: update tokens for sg disabled buttons (#286) (27074eb)

4.1.0 (2020-01-17)


  • design-token: add new status tokens (462f471)

4.0.0 (2019-12-20)


  • 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)

Bug Fixes#

  • SG: change color-text-weak to `gray-80 for a11y (#225) (12e1261)

3.0.4 (2019-12-05)

Bug Fixes#

  • console: change "color-text-inverse-weak" for a11y (#218) (c29de58)

3.0.3 (2019-11-20)

Bug Fixes#

  • remap console semibold to medium font weight (#195) (c01f6b3)

3.0.2 (2019-11-18)

Bug Fixes#

  • 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

3.0.0 (2019-11-11)


  • 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

2.5.0 (2019-10-29)

Bug Fixes#


  • design token and theme package documentation (#103) (3060113)

2.4.0 (2019-09-16)

Bug Fixes#

  • 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)


  • tokens: Add box-shadow and line-height tokens (#35) (706643b)

2.3.0 (2019-08-15)

Bug Fixes#


  • change the z-index scale to 10s (#34) (ed05089)
  • ComponentHeader component, component overview fixes, more (#20) (875e124)
  • website: Add text color token accessibility rating to the token page (#28) (74f12d1)
  • website: Add the tokens page (#19) (878d3c5)
  • website: Callout component (#25) (e4a3d00)


If you need support, please open a new issue in our GitHub repository. Please try to provide as much detail as possible in your issue.


The Paste design system is open source and contributions are welcome. Check out the project on GitHub to learn more about contributing.

Copyright © 2020 Twilio, Inc.