> For the complete documentation index, see [llms.txt](https://docs.specifyapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.specifyapp.com/v1/advanced-repository/parsers.md). # 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