Specify Docs
Specify ↗︎Changelog ↗︎Guide ↗︎
V2
V2
  • Getting started
    • Introduction
    • What is Specify?
    • Pulling your first tokens with the CLI
    • Glossary
  • Collect
    • What is a Source?
    • Available sources
      • Figma Variables & Styles
      • Tokens Studio
  • Distribute
    • What is a Destination?
    • Available destinations
      • GitHub
      • Specify CLI
      • Specify SDK
      • HTTP API
  • Concepts
    • Overview
    • Parsers Engine
    • SDTF Client
      • SDTF Engine
    • Specify Design Token Format
  • Guides
    • Configuration file 101
    • Specify CLI usage 101
      • Getting started
      • Authentication
      • Generate Files
    • Specify SDK usage 101
      • Getting started
      • Retrieving and working with the tokens
      • Updating tokens
      • Converting a token to XXX
      • Executing generation parsers
    • Specify SDK Cheatsheet
    • Manage font files
    • Querying a SDTF graph
  • Reference
    • Parsers Engine
    • Parsers
      • change-case
      • convert-color
      • convert-dimension
      • make-line-height-relative
      • filter
      • register-view
      • select-modes
      • prefix-by
      • suffix-by
      • replace-string
      • to-css-custom-properties
      • to-css-text-style
      • to-css-font-import
      • to-flutter
      • to-javascript
      • to-json
      • to-json-list
      • to-kotlin
      • to-react-native
      • to-scss-mixin-text-style
      • to-scss-map
      • to-sdtf
      • to-style-dictionary
      • to-swift
      • to-tailwind
      • to-typescript
      • svgo
      • svg-to-jsx
      • svg-to-tsx
      • to-svg-file
      • to-bitmap-file
      • to-file
    • Specify SDK
      • SpecifyClient
      • SDTFClient
      • Converters
        • CSS
      • ParsersEngineResults
    • SDTF Engine
      • Query API
      • Mutation API
      • SDTF Query Language
      • SDTF QueryResult
      • TokenState
        • Stateful Value
    • HTTP API
      • POST /parsers-engine-rpc
    • Specify CLI
  • Resources
    • Parser Rules templates
      • CSS Custom Properties
      • Tailwind
      • React Native
      • Flutter
      • SDTF
      • JSON
    • Specify CLI VS Specify SDK
    • Playground
    • Best practices
  • Useful links
    • Discord
    • YouTube
    • Twitter
    • Help Center
    • Canny
Powered by GitBook
On this page
  • Organization (workspace)
  • Repository
  • Source
  • Destination
  • Specify Design Token Format (SDTF)
  • Token type
  • Collection
  • Group
  • Alias
  • Mode
  • Parsers Engine
  • Parser Rule
  • Parser
  • SDTF Client
  • SDTF Engine
  • Configuration file

Was this helpful?

Export as PDF
  1. Getting started

Glossary

Looking for a definition? We've got your back!

PreviousPulling your first tokens with the CLINextWhat is a Source?

Last updated 12 months ago

Was this helpful?

Organization (workspace)

An organization, sometimes called workspace, is the Specify place you share with your team.

Repository

A repository is like a directory containing your design tokens and assets. The design data is stored within a JSON compatible tree built upon the .

Source

A source belongs to a repository, it represents where the original design tokens and/or assets come from - think of (Variables or Local Styles) or .

Destination

A destination belongs to a repository, it represents where the formatted design data get distributed on updates - think of or any automation you can come up with our and .

Specify Design Token Format (SDTF)

The SDTF stands for . It's a token format that helps you sync design tokens from Figma Styles, Figma Variables, and Tokens Studio. Your design tokens are created and saved as a token tree you can query and transform thanks to the Specify API. The SDTF is composed of more than 50 token types. In a SDTF token tree, design tokens can be organized in Collections, Groups, and Modes.

Token type

A Token type is a type of design token or asset supported by Specify like a color, a textStyle or a vector.

Collection

A collection is a way to group design tokens while ensuring the modes of the tokens they contain within the SDTF. A Collection can contain groups, and design tokens with one or several modes.

Group

A group is way to semantically group design tokens in the SDTF. A group contains design tokens, other groups and exists in the context of a collection.

Alias

An alias design token is a design token whose value is not a raw value but a reference to another design token's value.

Mode

A Mode is a way to associate the value of a design token to a specific context. For instance, a color named background can have several values associated to different modes like Light or Dark.

Parsers Engine

Parser Rule

Parser

SDTF Client

SDTF Engine

Configuration file

The is the high-level design data transformation and export API.

A is a JSON object describing a series of parsers and options, responsible to transform and export your design tokens and assets to your code base.

are functions allowing you to transform design tokens and assets coming from Specify to fit your needs and company standards. .

The offers versatile methods for working with token trees, enabling data manipulation, transformation, and conversion into various formats or languages, bridging the gap between stored and live token instances within your repository.

The brings together the core APIs that enable most of Specify features to seamlessly integrate, whether you're working in Figma or Token Studio, managing GitHub pull-requests, or directly within your codebase with the SDK or the CLI.

A file is a JSON or JavaScript file, made of one or many rules and the credentials to authenticate. The configuration is used to communicate with the Parsers Engine.

Specify Design Token Format
Figma
Tokens Studio
GitHub
CLI
SDK
Specify Design Token Format
Parsers Engine
SDTF Client
SDTF
SDTF Engine
See all parsers
parser rule
Parsers
Specify configuration