# Specify Docs

## V2

- [Introduction](https://docs.specifyapp.com/getting-started/introduction.md): Learn about our API and how to sync and transform design tokens in your design system.
- [What is Specify?](https://docs.specifyapp.com/getting-started/what-is-specify.md): The first Design Token Engine allowing you to send your design tokens across your design system tools. Specify is built with this idea: configure once, synchronize anytime.
- [Pulling your first tokens with the CLI](https://docs.specifyapp.com/getting-started/getting-started.md): A 5min guide on collecting and pulling your first design tokens with the Specify CLI.
- [Glossary](https://docs.specifyapp.com/getting-started/glossary.md): Looking for a definition? We've got your back!
- [What is a Source?](https://docs.specifyapp.com/collect/what-is-a-source.md)
- [Available sources](https://docs.specifyapp.com/collect/available-sources.md): List of all integrations you can use with Specify to collect design tokens and assets from.
- [Figma Variables & Styles](https://docs.specifyapp.com/collect/available-sources/figma-variables.md): In this guide, you’ll learn how to sync your Figma Variables and/or Styles to a Specify Repository and how to keep them updated.
- [Tokens Studio](https://docs.specifyapp.com/collect/available-sources/tokens-studio.md): In this guide you’ll learn how to sync your design tokens from Tokens Studio to your Specify repository and how to keep them updated.
- [What is a Destination?](https://docs.specifyapp.com/distribute/what-is-a-destination.md)
- [Available destinations](https://docs.specifyapp.com/distribute/available-destinations.md): List of all integrations you can use with Specify to distribute design tokens and assets to.
- [GitHub](https://docs.specifyapp.com/distribute/available-destinations/github.md): Distribute your design tokens and assets via automated Pull Requests.
- [Specify CLI](https://docs.specifyapp.com/distribute/available-destinations/cli.md)
- [Specify SDK](https://docs.specifyapp.com/distribute/available-destinations/specify-sdk.md): Distribute your design tokens and assets from Specify right from your codebase.
- [HTTP API](https://docs.specifyapp.com/distribute/available-destinations/http-api.md): Consume your design tokens and assets over HTTP requests.
- [Overview](https://docs.specifyapp.com/concepts/overview.md): Take some time to understand the basic concepts of Specify. Getting to know its foundational ideas will help you glimpse into how to leverage the apps and APIs in your projects.
- [Parsers Engine](https://docs.specifyapp.com/concepts/parsers-engine.md): Configure automated pipelines and deliver the design data to battle-tested technologies like CSS, Style Dictionary, Javascript, TypeScript, Swift, Kotlin — and more.
- [SDTF Client](https://docs.specifyapp.com/concepts/sdtf-client.md): Step into the Specify SDK APIs to get fined grained access to your design data.
- [SDTF Engine](https://docs.specifyapp.com/concepts/sdtf-client/sdtf-engine.md): Leverage the Specify core APIs to manipulate the SDTF token tree and produce any output you need.
- [Specify Design Token Format](https://docs.specifyapp.com/concepts/specify-design-token-format.md): Learn more about the Specify Design Token Format (SDTF) specifications.
- [Configuration file 101](https://docs.specifyapp.com/guides/configuration.md): Learn more about how to setup your Specify configuration file to generate design tokens and assets fitting your company standards.
- [Specify CLI usage 101](https://docs.specifyapp.com/guides/specify-cli-usage-101.md)
- [Getting started](https://docs.specifyapp.com/guides/specify-cli-usage-101/getting-started.md): Getting started with the Specify CLI
- [Authentication](https://docs.specifyapp.com/guides/specify-cli-usage-101/authentication.md)
- [Generate Files](https://docs.specifyapp.com/guides/specify-cli-usage-101/generate-files.md)
- [Specify SDK usage 101](https://docs.specifyapp.com/guides/specify-sdk-usage-101.md)
- [Getting started](https://docs.specifyapp.com/guides/specify-sdk-usage-101/getting-started.md): Getting started with the Specify SDK.
- [Retrieving and working with the tokens](https://docs.specifyapp.com/guides/specify-sdk-usage-101/retrieving-and-working-with-the-tokens.md)
- [Updating tokens](https://docs.specifyapp.com/guides/specify-sdk-usage-101/update-the-tokens.md)
- [Converting a token to XXX](https://docs.specifyapp.com/guides/specify-sdk-usage-101/convert-a-token-to-xxx.md)
- [Executing generation parsers](https://docs.specifyapp.com/guides/specify-sdk-usage-101/executing-parsers.md)
- [Specify SDK Cheatsheet](https://docs.specifyapp.com/guides/specify-sdk-cheatsheet.md): On this page you'll find a lot of common actions you'll probably want to perform when using the SDK
- [Manage font files](https://docs.specifyapp.com/guides/manage-font-files.md): Learn how to add font files to your Specify repositories once you've synced text styles.
- [Querying a SDTF graph](https://docs.specifyapp.com/guides/querying-a-sdtf-graph.md): Learn more about how to query your SDTF token graph.
- [Parsers Engine](https://docs.specifyapp.com/reference/parsers-engine.md): Parsers Engine API reference
- [Parsers](https://docs.specifyapp.com/reference/parsers.md): Parsers API reference
- [change-case](https://docs.specifyapp.com/reference/parsers/change-case.md): This parser helps you change the case of names or modes over a SDTF graph.
- [convert-color](https://docs.specifyapp.com/reference/parsers/convert-color.md): This parser helps you convert the color formats of color compatible tokens over a SDTF graph.
- [convert-dimension](https://docs.specifyapp.com/reference/parsers/convert-dimension.md): This parser helps you convert units of dimension tokens (spacing, sizing, breakpoint, blur...) and composite tokens sub values (font-size, letter-spacing, border-width...)
- [make-line-height-relative](https://docs.specifyapp.com/reference/parsers/select-modes.md): This parser helps you transform your text style lineheight values relative to their font size.
- [filter](https://docs.specifyapp.com/reference/parsers/filter.md): This parser helps you filter a SDTF graph.
- [register-view](https://docs.specifyapp.com/reference/parsers/register-view.md): This parser helps you register a SDTF view that can be later used by generation parser to allow for partial outputs of the token tree with no destructive mutations.
- [select-modes](https://docs.specifyapp.com/reference/parsers/select-modes-1.md): This parser helps you select design tokens from specific mode(s).
- [prefix-by](https://docs.specifyapp.com/reference/parsers/select-modes-1-1.md): This parser helps you prefix the name of your collections, groups and tokens from your SDTF token tree.
- [suffix-by](https://docs.specifyapp.com/reference/parsers/select-modes-2.md): This parser helps you suffix the name of your collections, groups and tokens from your SDTF token tree.
- [replace-string](https://docs.specifyapp.com/reference/parsers/select-modes-3.md): This parser helps you replace a part or the whole name of your collections, groups and tokens from your SDTF token tree.
- [to-css-custom-properties](https://docs.specifyapp.com/reference/parsers/to-css-custom-properties.md): This parser helps you transform design tokens into CSS Custom Properties.
- [to-css-text-style](https://docs.specifyapp.com/reference/parsers/to-css-text-style.md): This parser helps you generate text styles as CSS classes.
- [to-css-font-import](https://docs.specifyapp.com/reference/parsers/to-css-text-style-1.md): This parser helps you create CSS @font-face rules to import your font files.
- [to-flutter](https://docs.specifyapp.com/reference/parsers/to-flutter.md): This parser helps you generate a Flutter theme from all your design tokens coming from Specify.
- [to-javascript](https://docs.specifyapp.com/reference/parsers/to-javascript.md): This parser helps you pull design tokens as JavaScript objects for all token types and their respective helper functions.
- [to-json](https://docs.specifyapp.com/reference/parsers/to-json.md): This parser helps you pull design tokens in JSON with token values in JSON or CSS.
- [to-json-list](https://docs.specifyapp.com/reference/parsers/to-json-list.md): This parser helps you pull design tokens in JSON within an iterable array structure.
- [to-kotlin](https://docs.specifyapp.com/reference/parsers/to-kotlin.md): This parser helps you generate design tokens in Kotlin.
- [to-react-native](https://docs.specifyapp.com/reference/parsers/to-react-native.md): This parser helps you pull design tokens as a theme compatible with React Native and their respective helper functions.
- [to-scss-mixin-text-style](https://docs.specifyapp.com/reference/parsers/to-scss-mixin-text-style.md): This parser helps you generate text styles as SCSS mixins.
- [to-scss-map](https://docs.specifyapp.com/reference/parsers/to-scss-mixin-text-style-1.md): This parser helps you generate .scss files for each token type containing SCSS map and function / mixin to access the values of the tokens.
- [to-sdtf](https://docs.specifyapp.com/reference/parsers/to-sdtf.md): This parser helps you get your design tokens as a SDTF graph in JSON.
- [to-style-dictionary](https://docs.specifyapp.com/reference/parsers/to-style-dictionary.md): This parser helps you generate Style Dictionary raw token files for all your design tokens coming from Specify.
- [to-swift](https://docs.specifyapp.com/reference/parsers/to-swift.md): This parser helps you generate design tokens as Swift classes.
- [to-tailwind](https://docs.specifyapp.com/reference/parsers/to-tailwind.md): This parser helps you generate a Tailwind theme from all your design tokens coming from Specify.
- [to-typescript](https://docs.specifyapp.com/reference/parsers/to-typescript.md): This parser helps you pull design tokens as TypeScript objects for all token types and their respective helper functions.
- [svgo](https://docs.specifyapp.com/reference/parsers/svgo.md): This parser help you optimize and transform your SVG strings with svgo.
- [svg-to-jsx](https://docs.specifyapp.com/reference/parsers/svg-to-jsx.md): This parser helps you generate JSX or TSX components from your vector assets.
- [svg-to-tsx](https://docs.specifyapp.com/reference/parsers/svg-to-tsx.md): This parser helps you generate TSX components from your vector assets.
- [to-svg-file](https://docs.specifyapp.com/reference/parsers/to-svg-file.md): This parser helps you generate SVG files from your vector assets.
- [to-bitmap-file](https://docs.specifyapp.com/reference/parsers/to-bitmap-file.md): This parser helps you generate PNG and JPG files from your bitmap assets.
- [to-file](https://docs.specifyapp.com/reference/parsers/to-file.md): This parser helps you generate files from any asset token: Bitmap, Font and Vector.
- [Specify SDK](https://docs.specifyapp.com/reference/specify-sdk.md): Specify SDK API Reference
- [SpecifyClient](https://docs.specifyapp.com/reference/specify-sdk/specifyclient.md): The main Specify client to interact with Specify repositories and the SDTF token tree.
- [SDTFClient](https://docs.specifyapp.com/reference/specify-sdk/sdtfclient.md): The client to use SDTFEngine and Parsers Pipeline APIs. It provides methods for interacting with the token tree of a repository.
- [Converters](https://docs.specifyapp.com/reference/specify-sdk/converters.md)
- [CSS](https://docs.specifyapp.com/reference/specify-sdk/converters/css.md)
- [ParsersEngineResults](https://docs.specifyapp.com/reference/specify-sdk/parsers-engine-results.md): ParsersEngineResults class API reference
- [SDTF Engine](https://docs.specifyapp.com/reference/sdtf-engine.md): The SDTF Engine API reference.
- [Query API](https://docs.specifyapp.com/reference/sdtf-engine/query-api.md): Methods for locally accessing and iterating the token tree.
- [Mutation API](https://docs.specifyapp.com/reference/sdtf-engine/mutation-api.md): Methods for locally mutating the token tree.
- [SDTF Query Language](https://docs.specifyapp.com/reference/sdtf-engine/sdtf-query-language.md): SDTF Query Langage format API reference
- [SDTF QueryResult](https://docs.specifyapp.com/reference/sdtf-engine/sdtf-queryresult.md): The QueryResult class API reference
- [TokenState](https://docs.specifyapp.com/reference/sdtf-engine/tokenstate.md): The TokenState class API reference
- [Stateful Value](https://docs.specifyapp.com/reference/sdtf-engine/tokenstate/stateful-value.md)
- [HTTP API](https://docs.specifyapp.com/reference/http-api.md): Specify HTTP API reference
- [POST /parsers-engine-rpc](https://docs.specifyapp.com/reference/http-api/post-parsers-engine-rpc.md): Execute the Parsers Engine against a given input and Parsers Rules.
- [Specify CLI](https://docs.specifyapp.com/reference/specify-cli.md): Here you can find all the detailed informations about the CLI
- [Parser Rules templates](https://docs.specifyapp.com/resources/parser-rules-templates.md): Automatically distribute your design tokens and assets according to your organization's standards with our ready-to-use configuration templates.
- [CSS Custom Properties](https://docs.specifyapp.com/resources/parser-rules-templates/css-custom-properties.md): This template is dedicated for Web developers using CSS. It helps you generate all types of design tokens as CSS Custom Properties in their respective CSS file and it helps you to optimize your SVG's.
- [Tailwind](https://docs.specifyapp.com/resources/parser-rules-templates/tailwind.md): This template helps you generate your design tokens as a Tailwind theme.
- [React Native](https://docs.specifyapp.com/resources/parser-rules-templates/react-native.md): This template helps you generate your design tokens as a React Native theme and icons as JSX components
- [Flutter](https://docs.specifyapp.com/resources/parser-rules-templates/flutter.md): This template helps you generate your design tokens in a dart file and icons as SVG files.
- [SDTF](https://docs.specifyapp.com/resources/parser-rules-templates/sdtf.md): This template helps you pull your design tokens in the SDTF format in a JSON file.
- [JSON](https://docs.specifyapp.com/resources/parser-rules-templates/json.md): This template helps you pull your design tokens in JSON.
- [Specify CLI VS Specify SDK](https://docs.specifyapp.com/resources/specify-cli-vs-specify-sdk.md)
- [Playground](https://docs.specifyapp.com/resources/playground.md): Learn how to use the Specify Playground to iterate more easily on your configuration files
- [Best practices](https://docs.specifyapp.com/resources/best-practices.md)

## V1

- [Introduction](https://docs.specifyapp.com/v1/getting-started/introduction.md): Welcome to the Specify docs! Learn about how to use and integrate Specify in your workflow to sync your design tokens and assets in your design system.
- [What is Specify?](https://docs.specifyapp.com/v1/getting-started/what-is-specify.md): We provide the first Design Data Platform allowing you to send your design tokens and assets across your design system tools. Specify is built with this idea: configure once, synchronize anytime.
- [Getting started](https://docs.specifyapp.com/v1/getting-started/getting-started.md): A 5min guide on collecting and pulling your first design tokens and assets with Specify.
- [Glossary](https://docs.specifyapp.com/v1/getting-started/glossary.md): Specify is built on core concepts such as sources, destinations, pipelines, parsers. This page will help you understand all of them.
- [Getting started](https://docs.specifyapp.com/v1/advanced-repository/getting-started.md): Here’s a 5 minute guide on how to use different features within the Advanced Repository based on the Specify Design Token Format.
- [Figma Variables & Styles](https://docs.specifyapp.com/v1/advanced-repository/figma-variables.md): In this guide, you’ll learn how to sync your Figma Variables and/or Styles to a Specify Repository and how to keep them updated.
- [Tokens Studio](https://docs.specifyapp.com/v1/advanced-repository/tokens-studio.md): In this guide you’ll learn how to sync your design tokens from Tokens Studio to your Specify repository and how to keep them updated.
- [CLI & Config](https://docs.specifyapp.com/v1/advanced-repository/cli.md): In this guide you’ll learn how to transform design data coming from Figma Variables, Figma Styles and/or Tokens Studio into CSS Custom Properties using the Specify CLI.
- [Querying a SDTF graph](https://docs.specifyapp.com/v1/advanced-repository/querying-a-sdtf-graph.md): Learn more about how to query your SDTF token graph.
- [GitHub](https://docs.specifyapp.com/v1/advanced-repository/github.md): Learn how to distribute your design tokens from Specify to your GitHub repositories via automated Pull Requests.
- [Parsers](https://docs.specifyapp.com/v1/advanced-repository/parsers.md): Parsers are functions allowing you to transform design tokens and assets coming from Specify to fit your needs and company standards.
- [to-css-custom-properties](https://docs.specifyapp.com/v1/advanced-repository/parsers/to-css-custom-properties.md): This parser helps you transform design tokens into CSS Custom Properties.
- [to-style-dictionary](https://docs.specifyapp.com/v1/advanced-repository/parsers/to-style-dictionary.md): This parser helps you generate Style Dictionary raw token files for all your design tokens coming from Specify.
- [to-tailwind](https://docs.specifyapp.com/v1/advanced-repository/parsers/to-tailwind.md): This parser helps you generate a Tailwind theme from all your design tokens coming from Specify.
- [to-sdtf](https://docs.specifyapp.com/v1/advanced-repository/parsers/to-sdtf.md): This parser helps you get your design tokens as a SDTF graph in JSON.
- [to-javascript](https://docs.specifyapp.com/v1/advanced-repository/parsers/to-javascript.md): This parser helps you pull design tokens as JavaScript objects for all token types and their respective helper functions.
- [to-react-native](https://docs.specifyapp.com/v1/advanced-repository/parsers/to-react-native.md): This parser helps you pull design tokens as a theme compatible with React Native and their respective helper functions.
- [to-json](https://docs.specifyapp.com/v1/advanced-repository/parsers/to-json.md): This parser helps you pull design tokens in JSON with token values in JSON or CSS.
- [to-typescript](https://docs.specifyapp.com/v1/advanced-repository/parsers/to-typescript.md): This parser helps you pull design tokens as TypeScript objects for all token types and their respective helper functions.
- [filter](https://docs.specifyapp.com/v1/advanced-repository/parsers/filter.md): This parser helps you filter a SDTF graph.
- [select-modes](https://docs.specifyapp.com/v1/advanced-repository/parsers/select-modes.md): This parser helps you select design tokens from specific mode(s).
- [change-case](https://docs.specifyapp.com/v1/advanced-repository/parsers/change-case.md): This parser helps you change the case of names or modes over a SDTF graph.
- [convert-color](https://docs.specifyapp.com/v1/advanced-repository/parsers/convert-color.md): This parser helps you convert color formats of color tokens.
- [convert-dimension](https://docs.specifyapp.com/v1/advanced-repository/parsers/convert-color-1.md): This parser helps you convert units of dimension tokens.
- [Templates](https://docs.specifyapp.com/v1/advanced-repository/templates.md): Automatically distribute your design tokens and assets according to your organization's standards with our ready-to-use configuration templates.
- [CSS Custom Properties](https://docs.specifyapp.com/v1/advanced-repository/templates/css-custom-properties.md): This template is dedicated for Web developers using CSS. It helps you generate all types of design tokens as CSS Custom Properties in their respective CSS file.
- [SDTF](https://docs.specifyapp.com/v1/advanced-repository/templates/sdtf.md): This template helps you pull your design tokens in the SDTF format in a JSON file.
- [Tailwind](https://docs.specifyapp.com/v1/advanced-repository/templates/tailwind.md): This template helps you generate your design tokens as a Tailwind theme.
- [REST API](https://docs.specifyapp.com/v1/advanced-repository/rest-api.md): The Specify API lets you extend Specify functionalities beyond what we provide out of the box.
- [Playground](https://docs.specifyapp.com/v1/advanced-repository/playground.md): Learn how to use the Specify Playground to iterate more easily on your configuration files
- [Token types](https://docs.specifyapp.com/v1/concepts/token-types.md): Types define every type of design token and asset Specify is compatible with. Use them to target specific types of design data you want to pull from Specify and manage with rules and parsers.
- [Configuration](https://docs.specifyapp.com/v1/concepts/configuration.md): Learn more about how to configure Specify to generate design tokens and assets fitting your company standards.
- [Parsers](https://docs.specifyapp.com/v1/concepts/parsers.md): Parsers are functions allowing you to transform design tokens and assets coming from Specify to fit your needs and company standards.
- [Best practices](https://docs.specifyapp.com/v1/concepts/best-practices.md)
- [Overview](https://docs.specifyapp.com/v1/apps-and-tools/overview.md): List of all apps you can use with Specify to sync, read and transform your design tokens and assets.
- [GitHub](https://docs.specifyapp.com/v1/apps-and-tools/github.md): Learn how to distribute your design tokens and assets from Specify to your GitHub repositories via automated Pull Request.
- [npm](https://docs.specifyapp.com/v1/apps-and-tools/npm.md): Learn how to distribute your design tokens and assets from Specify as npm or GitHub packages.
- [REST API](https://docs.specifyapp.com/v1/apps-and-tools/rest-api.md): The Specify API lets you extend Specify functionalities beyond what we provide out of the box.
- [CLI](https://docs.specifyapp.com/v1/apps-and-tools/cli.md): The Specify CLI helps you pull design tokens and assets from Specify right from your terminal.
- [Notion](https://docs.specifyapp.com/v1/apps-and-tools/notion.md): Learn how to automatically document your design tokens and assets from Specify to your Notion workspace.
- [Raycast](https://docs.specifyapp.com/v1/apps-and-tools/raycast.md): Learn to get and use your design tokens and assets right from Raycast.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on a page URL with the `ask` query parameter:
```
GET https://docs.specifyapp.com/getting-started/introduction.md?ask=<question>
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.