Skip to content

v1.3.0

Choose a tag to compare

@macintacos macintacos released this 13 Oct 19:56
Immutable release. Only release title and notes can be modified.
af30850

caret 1.3.0 adds custom themes: put a JSON theme file in caret's themes folder or upload one from Settings → Appearance, and it shows up in the theme picker next to the built-in themes. It also adds caret convert-theme to turn a VS Code theme into a theme file, Dawnfox and Duskfox palettes, and a copy button on the upgrade command.

Added

  • Custom themes. Theme files in the themes folder of caret's config dir (~/.config/caret/themes) appear in Appearance's picker for their scheme after a reload. Files that fail to load are listed there with their errors. A picked custom theme paints from the first frame. If its file is edited, deleted or unreadable, the slot falls back to caret's theme and keeps the saved pick until the file is back. Theme files documents the format.
  • A JSON theme file format, with a published schema (doc/theme.schema.json) so an editor can check a file through $schema. Errors read one path: message line per problem. A file sets caret's chrome palette and 11 required syntax roles. Nine optional roles (operators, brackets, parameters, this, tags, built-in functions and types, and template ${ }) each fall back to a required role. caret's built-in themes ship as theme files, so each one is a working example to copy.
  • Settings → Appearance has an "Upload theme file…" button. It validates the file, saves it to the themes folder as <id>.json, and adds it to the picker without a reload. Uploading a theme whose id is already in use replaces that theme, and the open plan repaints with it. An invalid file lists its errors and nothing is saved.
  • caret convert-theme <file> [--out <file>] turns a VS Code color theme (JSON or JSONC) into a caret theme file. Code colors come from the theme's token rules. Chrome colors are a best-effort pick from its colors, and each one it can't find falls back to caret's theme with a note. Output goes to stdout unless --out names a file.
  • Dawnfox (light) and Duskfox (dark) palettes from Nightfox, with Nightfox's own code colors.
  • The upgrade command in What's new and Settings → Updates has a copy button.

Changed

  • Code colors in the Catppuccin, Dracula and GitHub themes now come from each theme's converted syntax roles instead of the upstream theme, so a few tokens are colored slightly differently. The chrome is unchanged, and the UI bundle is about 1.4 MB smaller.
  • Reaching caret from another device
    now covers the other devices. A browser-only device needs no caret. A device running its own agent should answer "I'll run it myself" at install and keep the server's host and hostnames out of its config.toml.

Full Changelog: v1.2.0...v1.3.0