Skip to content

docs(theming): add prebuilt themes section documenting M2 and M3 themes#32832

Merged
crisbeto merged 1 commit intoangular:mainfrom
yogeshwaran-c:docs/prebuilt-themes-m2-m3
Mar 25, 2026
Merged

docs(theming): add prebuilt themes section documenting M2 and M3 themes#32832
crisbeto merged 1 commit intoangular:mainfrom
yogeshwaran-c:docs/prebuilt-themes-m2-m3

Conversation

@yogeshwaran-c
Copy link
Copy Markdown
Contributor

What kind of change does this PR introduce?

Documentation improvement

What is the current behavior?

The theming guide does not mention prebuilt themes at all. Developers who use a prebuilt theme have no way to know from the docs which themes use the M2 design system and which use M3. This causes confusion when components look different from the Material Design documentation site (which uses M3).

Additionally, the getting-started guide links to theming#pre-built-themes which is a broken anchor.

Closes #30565

What is the new behavior?

Adds a "Prebuilt Themes" section to the theming guide that:

  • Lists all eight prebuilt themes in a table
  • Identifies which themes use M3 and which use M2
  • Shows the light/dark mode and color palettes for each theme
  • Notes that M2 themes are provided for backwards compatibility
  • Includes instructions for adding a prebuilt theme via angular.json
  • Links to the source code for the prebuilt theme definitions

Also fixes the broken anchor in the getting-started guide to point to the new section.

Additional context

The prebuilt theme source files confirm:

  • M3 themes (use system.theme): azure-blue, rose-red, cyan-orange, magenta-violet
  • M2 themes (use m2.define-light-theme/m2.define-dark-theme): indigo-pink, deeppurple-amber, pink-bluegrey, purple-green

@pullapprove pullapprove Bot requested review from adolgachev and ok7sai February 23, 2026 20:16
@angular-robot angular-robot Bot added area: docs Related to the documentation area: theming labels Feb 23, 2026
@crisbeto crisbeto added action: merge The PR is ready for merge by the caretaker target: patch This PR is targeted for the next patch release labels Mar 25, 2026
@crisbeto crisbeto merged commit e8d54c3 into angular:main Mar 25, 2026
16 of 18 checks passed
@angular-automatic-lock-bot
Copy link
Copy Markdown

This issue has been automatically locked due to inactivity.
Please file a new issue if you are encountering a similar or related problem.

Read more about our automatic conversation locking policy.

This action has been performed automatically by a bot.

@angular-automatic-lock-bot angular-automatic-lock-bot Bot locked and limited conversation to collaborators Apr 25, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

action: merge The PR is ready for merge by the caretaker area: docs Related to the documentation area: theming target: patch This PR is targeted for the next patch release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs-bug(theming): Add back explanation about some prebuilt themes being M2 and some M3

2 participants