             ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
              CHANGE LOG OF THE MODUS THEMES FOR GNU EMACS
             ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━


This document contains the release notes that are included in each
tagged commit on the project's main git repository:
<https://github.com/protesilaos/modus-themes>.

The newest release is at the top.  Since the notes are meant to be in
plain text format, I copy them verbatim.

For further details, please consult these additional resources:

Manual
      <https://protesilaos.com/emacs/modus-themes>
Screenshots
      <https://protesilaos.com/emacs/modus-themes-pictures>


5.3.0 on 2026-06-21
═══════════════════

  The Modus themes are in a stable state. To my mind, they provide the
  best "default theme" experience across the 40+ original themes I have
  carefully designed.

  Modus is also a platform for making themes for Emacs. There are plenty
  of derivatives already. I am linking to them through the project's
  README.md and am always happy to mention more packages—just let me
  know.

  This version does not include many user-facing changes. Most of my
  work focused on making internal refinements.


Load the themes through the `early-init.el'
───────────────────────────────────────────

  The Modus themes can now be loaded through the `early-init.el' file.
  The idea is to avoid the flash of light that occurs under certain
  conditions during startup.

  This feature is the result of several changes to helper functions,
  especially those contributing to the `modus-themes-generate-palette'
  function that Modus derivatives may be relying on.

  Thanks to Steven Allen for an intermediate refinement in pull request
  194 and to Mike Olson for another relevant tweak in pull request 199:

  • <https://github.com/protesilaos/modus-themes/pull/194>
  • <https://github.com/protesilaos/modus-themes/pull/199>

  Steven's contribution no longer exists in the code base due to other
  changes I made, but was still useful at the time.

  Both changes are small, meaning that their authors do not need to
  assign copyright to the Free Software Foundation.

  Also thanks to Jacod "Jake" Gordon for reminding me to apply one of
  the new functions to the `org-habit' faces. This was done in issue
  197: <https://github.com/protesilaos/modus-themes/issues/197>.


The underline for widget fields has the correct colour
──────────────────────────────────────────────────────

  Relevant faces use the palette entry for `border' (invoke the command
  `modus-themes-preview-colors' or `modus-themes-preview-colors-current'
  to view the entries in a theme's palette).

  A popular package that makes use of `widget.el' widgets is `notmuch'.

  Thanks to ukiran03 for the contribution, which was done in pull
  request 193: <https://github.com/protesilaos/modus-themes/pull/193>.
  The change is small, meaning that ukiran03 does not need to assign
  copyright to the Free Software Foundation.


A palette can now have a `bg-popup' entry
─────────────────────────────────────────

  This gives users and derivative themes the option to pick a suitable
  value for popup interfaces, such as those of the `company' and `corfu'
  packages.

  Thanks to aikrahguzar for making this suggestion in issue 70 of my
  `ef-themes' repository (the `ef-themes' are built on top of the
  `modus-themes' since Modus version `5.0.0', Ef version `2.0.0'):
  <https://github.com/protesilaos/ef-themes/issues/70>.


Support for faces or packages
─────────────────────────────

  • `lin' by Protesilaos.
  • `pulsar' by Protesilaos.
  • `institution-calendar' by Protesilaos.
  • `markdown-ts-mode' by Rahul Martim Juliato and Stéphane Marks.
  • `trust-manager' by Eshel Yaron.
  • `typst-ts-mode' by Ziqi Yang. Thanks to Pranshu Sharma for
    suggesting its inclusion in issue 208:
    <https://github.com/protesilaos/modus-themes/issues/208>.
  • new `elfeed' faces since the maintenance of the project was assumed
  …  …
