Skip to content

notes about naming (icon) themes, color schemes - #160

Merged
FichteFoll merged 2 commits into
sublimetext-io:masterfrom
braver:patch-1
Oct 27, 2026
Merged

FichteFoll merged 2 commits into
sublimetext-io:masterfrom
braver:patch-1

Conversation

@braver

@braver braver commented Oct 13, 2026

Copy link
Copy Markdown
Contributor

Add some guidance about naming themes, color schemes and icon themes. The topic came up on Discord about packages providing the new icon theme feature, and my own confusing use of "FileIcons Theme" for a package that is not a UI theme. This also subtly implies a preference for the more natural "something color scheme" over the also quite common "color scheme - something" naming convention for such packages.
This of course also means I should rename my own package 😅 I haven't come up with anything good yet...

- Language support (aka "syntax" or "grammar") packages
are named after the language it supports,
without suffixes like "syntax" or "highlighting".
- UI theme packages have "Theme" in their name (e.g. "Material Theme"),

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We also have a lot of package in the stlyle of "Theme - Name" or "Color Scheme - Name". Do we consider that to be deprecated (to promote uniformity) or do we accept this as well? In the latter case, I would also include examples for those.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Those are far less common these days, especially for color schemes. I would almost say "we don't do that anymore" ... but it's not like there was ever a rule. As this screenshot from new themes sorted by date proves, we have no official position no this right now:

Screenshot 2026-10-15 at 09 28 56

😅

The "Theme - " and "Color Scheme - " prefix feel unnatural to me. It's a the kind of convention that makes things sort nicely on a file system. Which A only matters in a file system, and B only really works if a system enforces compliance. Personally I think of "Solarized Color Scheme" mostly as "Solarized" and expect it to be at S in an alphabetical list. And package control's site can filter by type, so if the results are a list where the first words in every name are always "Color Scheme" ... that's not super helpful either. So that's what I mean with "Name Theme" being more "natural", and what I would prefer. But I'm not going to enforce it per se.

@FichteFoll FichteFoll Oct 25, 2026 •

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

So, I did a small survey on Discord (non-scientific) and the result appears to be majorly in favor of the ST-endorsed "Color Scheme - Cool" form over "Cool Color Scheme" (4:0). I suppose this is also what most people will recognize because it is what ST uses for its default color scheme (and themes).

We may suggest both forms but I do not believe we can omit "Color Scheme - Cool".

As for icons, I suppose "Icon Theme - Colorful" would be the respective variant for icon themes.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

4:0

You're not counting the non-voters so that hardly means anything. And ST's convention is not front-and-center in any way, how the package was named internally is only known by handful of die-hard nerds, of which 4 care about it enough to vote one way or another. "people will recognize because it is what ST uses for its default color scheme" is a statement I'd love to test out with a few real users, the people in the package-control channel on discord are not the general public by a long shot. And it's not like people won't understand "Cool Color Scheme" is a color scheme, while "Color Scheme - Cool" is clear to them, both are equally clear. Especially since Sublime is the only ecosystem where the latter is used, while tons of themes exist across several IDE platforms.

But sure, I have nothing against either naming scheme and we can cover both as examples.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Lol, I'm having a hard time finding color schemes that start with "Color Scheme -". I think Brackets is a lovely example of the status quo: it's "Theme - Brackets", but "Brackets Color Scheme" (by the same author of course).

@braver

braver commented Oct 26, 2026

Copy link
Copy Markdown
Contributor Author

Went with "Icons - Name" because one already exists, there is no precedent in packages provided by SublimeHQ, and seems smart to avoid overloading the word "theme".

@FichteFoll
FichteFoll merged commit d826f31 into sublimetext-io:master Oct 27, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants