{"full_name":"google-labs-code/design.md","owner":"google-labs-code","name":"design.md","shard":"1","url":"https://github.com/google-labs-code/design.md","description":"A format specification for describing a visual identity to coding agents. DESIGN.md gives agents a persistent, structured understanding of a design system.","homepage":"https://stitch.withgoogle.com/docs/design-md/specification","topics":[],"tag_pages":[],"language":"TypeScript","license":"Apache-2.0","avatar":"https://avatars.githubusercontent.com/u/161364575?v=4","created_at":"2026-04-10T17:54:59Z","pushed_at":"2026-11-06T11:02:13Z","metrics":{"stars":28887,"forks":2306,"watchers":151,"issues":66,"prs":120,"releases":5,"issues_open":23,"issues_closed":43,"prs_open":19,"prs_closed":39,"prs_merged":62,"discussions":0},"growth":{"day":{"stars":12,"forks":3,"base_day":"2026-11-15"},"week":{"stars":183,"forks":21,"base_day":"2026-11-04"},"month":{"stars":536,"forks":24,"base_day":"2026-10-17"}},"history":{"dates":["2026-09-06","2026-09-07","2026-09-08","2026-09-09","2026-09-10","2026-09-11","2026-09-12","2026-09-13","2026-09-14","2026-09-15","2026-09-16","2026-09-17","2026-09-18","2026-09-19","2026-09-20","2026-09-21","2026-09-22","2026-09-23","2026-09-24","2026-09-25","2026-09-26","2026-09-27","2026-09-28","2026-09-29","2026-09-30","2026-10-01","2026-10-02","2026-10-03","2026-10-04","2026-10-05","2026-10-06","2026-10-07","2026-10-08","2026-10-09","2026-10-10","2026-10-11","2026-10-12","2026-10-13","2026-10-14","2026-10-15","2026-10-16","2026-10-17","2026-10-18","2026-10-19","2026-10-20","2026-10-21","2026-10-22","2026-10-23","2026-10-24","2026-10-25","2026-10-26","2026-10-27","2026-10-28","2026-10-29","2026-10-30","2026-10-31","2026-11-01","2026-11-02","2026-11-03","2026-11-04","2026-11-10","2026-11-11","2026-11-12","2026-11-13","2026-11-14","2026-11-15","2026-11-16"],"stars":[27480,27502,27522,27545,27558,27578,27592,27646,27674,27700,27730,27746,27775,27804,27810,27835,27857,27870,27911,27933,27951,27972,27991,28004,28033,28038,28062,28087,28108,28116,28144,28164,28205,28219,28227,28249,28260,28270,28291,28304,28315,28351,28360,28371,28391,28396,28401,28426,28436,28450,28471,28499,28514,28549,28596,28623,28640,28661,28690,28704,28805,28819,28836,28840,28864,28875,28887],"forks":[2287,2286,2285,2285,2287,2287,2285,2289,2288,2285,2285,2289,2291,2292,2278,2278,2282,2282,2285,2285,2283,2284,2284,2284,2284,2282,2282,2285,2285,2284,2283,2283,2281,2284,2286,2279,2279,2279,2281,2280,2280,2282,2283,2283,2286,2286,2286,2286,2280,2253,2253,2256,2258,2265,2271,2274,2276,2278,2282,2285,2289,2290,2295,2296,2300,2303,2306],"watchers":[172,171,171,172,173,173,174,177,178,178,178,178,180,180,173,173,173,173,173,173,173,173,173,173,173,173,172,172,171,171,171,171,171,171,171,171,171,171,171,172,172,172,172,172,172,172,172,172,169,158,158,158,153,153,154,154,153,153,153,153,null,151,151,151,151,151,151],"issues_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,21,21,21,22,22,23],"prs_open":[null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,null,19,19,19,19,19,19]},"boards":{},"same_owner":[{"full_name":"google-labs-code/stitch-skills","name":"stitch-skills","shard":"1","boards":{"daily":32,"daily_rate":16,"weekly_rate":142,"daily_forks":20}}],"issues":[{"number":13,"title":"Support for different modes/themes?","comments":11,"created_at":"2026-04-21T19:40:20Z"},{"number":47,"title":"Feature: motion tokens (duration, easing) with prefers-reduced-motion fallback","comments":7,"created_at":"2026-04-24T15:18:26Z"},{"number":17,"title":"Feature: Add Support for Component Variations","comments":6,"created_at":"2026-04-22T06:34:17Z"},{"number":16,"title":"Duplicating design facts in front matter and markdown body","comments":5,"created_at":"2026-04-21T23:50:29Z"},{"number":158,"title":"(feat) wish list item - static parsing a DESIGN from website","comments":4,"created_at":"2026-07-18T08:02:27Z"},{"number":116,"title":"Accessibility considerations: DESIGN.md as infrastructure for AI-generated UI","comments":3,"created_at":"2026-06-25T05:11:16Z"},{"number":63,"title":"Single vs. multiple DESIGN.md files within a project, is the spec opinionated?","comments":3,"created_at":"2026-05-01T15:38:53Z"},{"number":101,"title":"spec: Iconography section","comments":2,"created_at":"2026-06-04T15:36:42Z"}],"discussions":[],"latest_release":{"name":"0.4.0","tag":"0.4.0","published_at":"2026-07-27T21:15:16Z","body":"Bumps version from 0.3.0 to 0.4.0. All changes since 0.3.0:\n\n## Bug Fixes\n\n- **Missing design files fail gracefully instead of throwing a stack trace.** Reading a non-existent or unreadable file now outputs a clean error message and structured JSON with exit code 2. (#123, #145, @rmyndharis, @Emp1500) Fixes #132.\n- **Successful exports always return exit code 0.** Export command exit codes are now decoupled from source document linter warnings or errors, ensuring valid serialized builds pass pipeline gates. (#126, #152, @rmyndharis, @arpitjain099)\n- **Tailwind CSS exports end with exactly one trailing newline.** Serializing to `css-tailwind` no longer appends an extra empty line that caused strict repository formatting checks to fail. (#151, #140, #144, @sudarshandev-llm, @drmikecrypto, @Jalendar10) Fixes #139.\n- **Reading from an interactive terminal prints a usage hint.** When running a command with `-` as the input path from a TTY, the CLI prints `Reading from stdin... Press Ctrl+D when done` to prevent silent freezing. (#146, @Emp1500)\n- **Gradian angle units in colors parse correctly.** Angles like `100grad` now correctly take precedence over radian matching, producing accurate color computations and contrast metrics. (#120, @rmyndharis)\n- **CSS `color-mix()` requires explicit percentage weight values.** Bare numbers are now rejected instead of producing inaccurate color blends. (#120, @rmyndharis)\n- **Line terminators in font family names are escaped in Tailwind v4 exports.** (#122, @rmyndharis)\n- **Specification documentation resolves reliably from bundled CLI installations.** The CLI command `npx @google/design.md spec` no longer throws errors when executed from npm installations. (#118, #157, @rmyndharis, @SyedaQurratAI)\n- **Primitive types render correctly directly from specification configuration.** (#131, @juliosuas)\n- **Bounded token validation performance on adversarial inputs.** Cap dimension string parsing lengths, limit recursion depth in nested colors, and optimize string distance checks to prevent CPU spikes or call stack errors on malformed documents. (#121, @rmyndharis)\n\n## Features\n\n- **Optional `omitted` frontmatter key suppresses linter warnings.** Design authors can explicitly list skipped categories (like `spacing` or `rounded`) as bare strings or structured objects with reasons, silencing expected-missing linter warnings. (#155, #113, #147, @zachshallbetter, @mvanhorn, @sudarshandev-llm) Fixes #78.\n- **CSS custom properties export format.** Serializes design system tokens directly into standard CSS variables within a `:root` selector using `--format css-vars`, with optional naming prefix support via `--prefix`. (#109, @mvanhorn)\n- **Typography sub-property linting.** The linter now reports warnings for unrecognized or misspelled property fields inside typography token mappings. (#125, @rmyndharis)\n- **Token name collision detection.** The linter detects and reports naming collisions occurring between flattened dot-notation keys and nested YAML groups. (#150, @Arshgill01)\n- **Data-driven type definitions in specification.** Specification documentation dynamically generated from primitive configuration schemas. (#117, @Emp1500) Fixes #97.\n\n## Docs\n\n- Updated README to match runtime linter JSON output fields (`infos` vs `info`) and align the active rules count to eleven. (#119, @rmyndharis)\n- Declared supported Node runtime compatibility requirement (`\"engines\": { \"node\": \">=18.0.0\" }`) in package metadata. (#124, @rmyndharis)\n\n## Contributors\n\nThank you to the contributors who made this release possible:\n\n- @rmyndharis (#118, #119, #120, #121, #122, #123, #124, #125, #126)\n- @Emp1500 (#117, #145, #146)\n- @mvanhorn (#109, #113, #155)\n- @sudarshandev-llm (#147, #151, #155)\n- @zachshallbetter (#155)\n- @juliosuas (#131)\n- @Arshgill01 (#150)\n- @arpitjain099 (#152)\n- @SyedaQurratAI (#157)\n- @drmikecrypto (#140)\n- @Jalendar10 (#144)\n","is_prerelease":false},"readme":true,"readme_zh":false,"news":[],"stale":false,"snapshot_at":"2026-11-16T09:23:14Z","history_start":"2026-09-06"}