Skip to content

docs: plugin API 0.28.0 color schemes for the Appearance picker - #20

Merged
hamidfzm merged 2 commits into
mainfrom
docs/color-scheme-api
Oct 30, 2026
Merged

hamidfzm merged 2 commits into
mainfrom
docs/color-scheme-api

Conversation

@hamidfzm

Copy link
Copy Markdown
Member

Summary

Documents ctx.ui.addColorScheme, the plugin API 0.28.0 addition from hamidfzm/glyph#1013: plugins offer color schemes to a picker in Settings > Appearance. The host change is hamidfzm/glyph#1024, and glyph-md/plugin-template#16 carries the matching types.

Merge after the host PR. The API reference here already names 0.28.0, the same header change as #19, so either PR can land first.

Changes

  • docs/api-reference.md: a ctx.ui.addColorScheme (API 0.28) section (what is injected and when, validation, namespacing by plugin id, removal on unload, and in the sandbox the drop of a malformed scheme or one referencing URLs; renaming on a language switch is marked as a "sandbox": false technique, since ctx.i18n is main-context only), addStyles now points schemes at it, and the sandbox subset lists it.
  • docs/recipes.md: a "Color scheme" recipe, setting the tokens on :root and :root.dark.
  • docs/ecosystem.md: the Theme presets core plugin's schemes are picked in Settings > Appearance.

Documents ctx.ui.addColorScheme, adds it to the sandbox subset, gives it a recipe, and points the core plugin catalog at the Appearance picker instead of addStyles.

Refs hamidfzm/glyph#1013
@hamidfzm hamidfzm self-assigned this Oct 30, 2026
@hamidfzm
hamidfzm merged commit 42f64cb into main Oct 30, 2026
3 checks passed
@hamidfzm
hamidfzm deleted the docs/color-scheme-api branch October 30, 2026 18:12
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.

1 participant