angular / angular/components

docs-bug(All-Components): Lack of Interactive Playground for Design Tokens

Open
#30,550 2 comments 5 reactions 0 assignees View on GitHub
area: material.angular.io docs feature P4
Dominant language
TypeScript
Stars
25k
Forks
6.8k
Avg merge
1d 8h
Merged PRs (30d)
91

Description

### Documentation Feedback

noticed that the Material Design documentation does not clearly demonstrate the real-time effects of various design tokens across components. To help designers and developers better understand token functionality, I have created [Material-In-Realtime](https://smil-thakur.github.io/Material-In-Real-Time). This tool allows users to experiment with design tokens and see live updates instantly.

However, the Material library is vast, and so far, I have only covered buttons. Expanding this playground to include all components requires more effort, and I would love contributions or guidance to make it more comprehensive.

I believe integrating a similar interactive playground into the official documentation could enhance clarity and usability. I’m happy to collaborate or provide insights if this aligns with your goals. Let me know if this would be valuable!

### Affected documentation page

https://material.angular.io/components/button/overview

Contributor guide

Open the contributing guide

Research direction

Start with the affected Button overview page and compare it with the linked Material-In-Realtime playground. Define the documentation scope for an interactive design-token playground across components, then confirm the result demonstrates live token effects within the official documentation.

Written by the indexing model from the issue text.

Assessment

Tech stack
angular, typescript
Domain
documentation, frontend
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.