# Parsers Not familiar with parsers? Head over to the existing parsers documentation and learn more about why you need them and how to use them. {% hint style="info" %} We're currently working on making [our existing parsers](/v1/concepts/parsers.md#all-parsers-available) compatible with the SDTF. We'll update this page accordingly. {% endhint %} ## General properties You must set a name and your desired output for each parser: 1. The `name` is the name of the parser 2. The `output` property indicates which type of output you want the parser to produce ### Output types Parsers support none, some or more output types, please refer to dedicated parser pages for details. #### File Use case: the parser is expected to produce exactly one file. ```typescript type FileOutput = { type: 'file'; filePath: string; } ``` **Directory** Use case: the parser is expected to produce 0 to N files, all placed in the given `directoryPath`. ```typescript type DirectoryOutput = { type: 'directory'; directoryPath: string; } ``` Example with the `to-css-custom-properties` parser: ```json "parsers": [ { "name": "to-css-custom-properties", "output": { "type": "file", "filePath": "style.css" } } // ... ] ``` ## Available parsers
ParserDescriptionUsage example
change-caseThis parser helps you change the case of names or modes over a SDTF graph.Example
convert-colorThis parser helps you convert the color formats of color compatible tokens over a SDTF graph.Example
filterThis parser helps you filter a SDTF graph.Example
select-modesThis parser helps you select design tokens from specific mode(s).Example
to-css-custom-propertiesThis parser helps you transform design tokens in CSS Custom Properties.Example
to-sdtfThis parser helps you get your design tokens as a SDTF graph in JSON.Example
to-style-dictionaryThis parser helps you generate Style Dictionary raw token files for all your design tokens coming from Specify.Example
to-tailwindThis parser helps you generate a Tailwind theme from all your design tokens coming from Specify.Example
to-javascriptThis parser helps you pull design tokens as JavaScript objects for all token types and their respective getter functions.Example
to-jsonThis parser helps you pull design tokens in JSON with token values in JSON or CSS.Example
to-typescriptThis parser helps you pull design tokens as TypeScript objects for all token types and their respective getter functions.Example
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.specifyapp.com/v1/advanced-repository/parsers.md?ask= ``` 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.