Welcome to the GitFig community! This is the place for feature requests, bug reports, and discussions about GitFig, the Figma plugin that syncs design tokens with GitHub.
Head over to the Discussions tab to:
- Feature Requests: Share ideas for new features and improvements
- Bug Reports: Report issues and bugs
- Q&A: Ask questions and get help
- General: General discussions about GitFig
- Show and Tell: Share how you're using GitFig in your workflow
The examples/ folder has ready-to-use token files for getting started:
- design-tokens-starter: a full base set (colors, palette, spacing, typography, radius, borders, elevation, motion, breakpoints), one file per collection
- variable-modes: a single-mode Primitives collection, a light/dark Semantic collection that aliases into it, and color and text style files (the same files a new GitFig repository starts with)
- multi-brand-themes: one brand theme per Git branch
- tokens-studio-migration: before/after files for migrating from Tokens Studio
Each folder's README explains what the files contain and how to map them in GitFig. Copy the files into your repo (or fork this one) and Pull.
The single-source-of-taste/ folder is the home of the theory behind GitFig: design tokens as resolution policies over a multidimensional context space, the Design Token Context Ontology (12 categories, 93 dimensions), and the Single Source of Taste, a design-owned authority for the aesthetic judgments no test can certify. Start with the folder README for the argument in five steps and a reading order, then the Glossary. Pages 07 and 08 describe what a Figma-to-Git tool would need to carry taste, not just values, through the round-trip.
Coming from Tokens Studio, the Figma Variables REST API, or hand-maintained JSON? See COMPARISON.md for a side-by-side comparison, including where each approach fits best.
- Website: gitfig.com
- Documentation: docs.gitfig.com
- Figma Community: GitFig Plugin
The contents of this repository are licensed under CC BY 4.0 (attribution terms in NOTICE). Reuse and adapt freely, including commercially, as long as you keep the attribution: Dan Schmitz, with Claude (Anthropic), with a link back to this repository and a note of any changes.
Version your design system with Git workflows: branches, pull requests, and full history.