Skip to content

docs: Clarify app icon instructions, add link to Material Symbols & Icons#15321

Open
jancborchardt wants to merge 1 commit into
masterfrom
fix/app-icon-clarification
Open

docs: Clarify app icon instructions, add link to Material Symbols & Icons#15321
jancborchardt wants to merge 1 commit into
masterfrom
fix/app-icon-clarification

Conversation

@jancborchardt

Copy link
Copy Markdown
Member

☑️ Resolves

Makes it more clear what to use for app icons. Ref @miaulalala

✅ Checklist

  • I have built the documentation locally and reviewed the output
  • Screenshots are included for visual changes
  • I have not moved or renamed pages (or added a redirect if I did)
  • I have run codespell or similar and addressed any spelling issues

…cons

Signed-off-by: Jan C. Borchardt <925062+jancborchardt@users.noreply.github.com>
@github-actions

Copy link
Copy Markdown
Contributor

📖 Documentation Preview

🔍 Open preview →

📄 1 changed documentation page

Last updated: Thu, 16 Jul 2026 10:32:48 GMT

- Never use a custom icon except for the icon of the app itself. Still, most apps use an app icon from Material Symbols to keep consistency.
- Never use a custom icon except for the icon of the app itself.
- When possible, use text together with icons so it’s clear what they refer to.
- For the main app icon, you can use a custom icon or just pick a fitting one from `Material Symbols <https://fonts.google.com/icons>`__ to keep consistency. While the interface icons should be outlined, we recommend using the filled version for the main app icon so it stands out better, also on the header background which can be an image and/or themed.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

are there also some recommendations for custom app icons? Should they also be filled versions? Or should the provide more than one variant (light, dark)?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Status: 🏗️ At engineering

Development

Successfully merging this pull request may close these issues.

2 participants