Farum Azula Themes

The Farum Azula Themes extension adds two dark themes to Zed. They share one syntax palette: blue keywords, gold functions, green types and attributes, orange operators, yellow brackets and delimiters, and italic comments. They differ in the window around the code.

Theme Window Built on
Farum Azula Dark Opaque, for full screen VScode Dark Plus by d1y
Farum Azula Transparent Transparent: the desktop shows through Transparent Prism Collection (Frost) by Magnus Pladsen
Extension id farum-azula-theme
Version 0.1.3
Source theme-extension in the zed_editor_extensions repository

Each theme is a complete copy: every colour of its base theme with this collection's changes applied. Neither base theme has to be installed, and an update to either cannot change these themes. Colours the base themes leave unset fall back to Zed's built-in dark defaults.

Choosing a theme

Run theme selector: toggle from the command palette and pick a Farum Azula theme, or set it in settings.json:

{ "theme": "Farum Azula Dark" }

To follow the system's light and dark mode with one of them for dark:

{
  "theme": {
    "mode": "system",
    "light": "One Light",
    "dark": "Farum Azula Transparent"
  }
}

How it looks

Switch between the two themes to see the same code in each:

@Service()
class Checkout {
  Checkout(this.payments);

  final PaymentService payments;

  // Charges the basket.
  Future<void> pay(List<Item> items) async {
    final total = items.fold(0.0, (sum, item) => sum + item.price);
    await payments.charge(total);
  }
}

Keywords, types, annotations and brackets are the same in both; strings and numbers differ. In Zed, Farum Azula Transparent also lets the desktop show through the window. The page shows the colours of the code; Zed colours a few more kinds of token (function names, operators, a closure's parameters), listed below.

The shared syntax palette

These colours are the same in both themes.

Style Colour Used for
keyword #6388d4 class, final, if, return, async
variable.builtin #6388d4 this, super
function #ffc400 Function and method names
type #02b576 Classes, enums, type names
attribute #02b047 Annotations (italic in Transparent)
operator #b35204 +, =, =>, ??
punctuation.bracket #e0bc43 ( ) [ ] { }
punctuation.delimiter #e0bc43 ;, ,, .
variable #d6d6d6 Local variables
variable.parameter.closure #c07a9a A closure's parameters (from the Spring for Dart language server)
punctuation.markup #d07277 Markdown markup
punctuation.special #b1574b ${ } in string interpolation

variable.parameter.closure is coloured only when the Spring for Dart extension is installed and Dart's semantic tokens are on; Flutter Tools maps the token to this style.

The colours that differ

Style Farum Azula Dark Farum Azula Transparent
string #ce9178 #6a9955
string.escape #d7ba7d #f7f1ff
string.regex #ce9178 #fce566
string.special, string.special.symbol #d7ba7d #fd9353
number #b5cea8 #948ae3
boolean, constant, preproc #569cd6 #948ae3
constructor #569cd6 #fc618d
tag #569cd6 #fc618d
property #9cdcfe #6ec5ff
variable.special #9cdcfe #bab6c0, italic
comment, comment.doc #505050, italic #69676c, italic
punctuation, punctuation.list_marker #808080 #8b888f
text.literal #ce9178 #fce566
title unset #fce566
label unset #7bd88f
link_text unset #fc618d
link_uri unset #7bd88f

Code examples in documentation comments

With Flutter Tools, the code blocks inside /// comments are highlighted as code. The themes give those examples the same hues, darkened, so they stay apart from the code around them. A few of them:

Style Farum Azula Dark Farum Azula Transparent
keyword.dartdoc #3b527f #3b527f
function.dartdoc #997600 #997600
type.dartdoc #016d47 #016d47
attribute.dartdoc #016a2b #016a2b
operator.dartdoc #6b3102 #6b3102
punctuation.bracket.dartdoc #867128 #867128
string.dartdoc #7c5748 #405c33
number.dartdoc #6d7c65 #595388
property.dartdoc #5e8498 #427699
comment.dartdoc #303030, italic #3f3e41, italic
dartdoc.code #505050 #69676c

Farum Azula Dark: the window

Element Colour
Window background #1e1e1e
Editor background #212121
Editor text #d4d4d4
Gutter, toolbar, scrollbar track #1e1e1e
Active line number #d4d4d4
Panels #212121
Title bar, status bar #2b2b2b
Terminal background #1e1e1e
Drop target #383b3d
Error, deleted, conflict #d16969
Warning, modified #d7ba7d
Info #9cdcfe
Created #608b4e
Hint #969696
Ignored #808080

Terminal colours:

Colour Normal Bright
Black #808080 #808080
Red #d16969 #d16969
Green #608b4e #b5cea8
Yellow #d7ba7d #ce9178
Blue #569cd6 #9cdcfe
Magenta #c586c0 #c586c0
Cyan #4ec9b0 #4ec9b0
White #d4d4d4 #d4d4d4

Farum Azula Transparent: the window

Colours with eight hex digits carry an alpha channel: #0c1016d0 is #0c1016 at about 82 % opacity, and 00 at the end is fully transparent.

Element Colour
Window background, title bar, status bar #0c1016d0
Editor, gutter, tab bar, toolbar #00000000
Panels, elements #21212100
Terminal background #2e2e2e00
Text, editor text #f7f1ff
Muted text, hints #8b888f
Accent text #fce566
Line numbers #525053
Active line, active tab #ffffff12
Hovered element #ffffff15
Selected element #ffffff40
Borders, pane borders #fce56620
Focused panel border #fce56680
Indent guides #fce56626, active #fce56666
Scrollbar thumb #f9a82580, hovered #f9a825
Search match, highlighted reference #383838
Pop-ups #2e2e2ee6
Error, deleted #fc618d
Warning, conflict #fd9353
Info #fce566
Created, added #6a9955
Modified, renamed #b8a04a
Ignored #c07a9a
Your cursor #e5c07b, selection #3e68d466
Bracket pair accents #5a9e69, #b57a1b, #b84767

Collaborators' cursors are #fc618d, #7bd88f, #fd9353, #fce566, #948ae3 and #5ad4e6.

Terminal colours:

Colour Normal Bright
Black #363537 #69676c
Red #fc618d #fc618d
Green #7bd88f #7bd88f
Yellow #fce566 #fce566
Blue #fd9353 #fd9353
Magenta #948ae3 #948ae3
Cyan #5ad4e6 #5ad4e6
White #f7f1ff #f7f1ff

Full screen with the transparent theme

In macOS full screen the window gets a Space of its own with nothing but black behind it, so the transparent theme turns black. A Zed theme can neither set a background image nor change with the window's size. Fill the screen instead: the window stays on the desktop and the wallpaper shows through. Use Window → Fill in the menu bar, or bind Zed's zoom in the keymap (zed: open keymap file):

[
  {
    "context": "Workspace",
    "bindings": {
      "ctrl-cmd-f": "zed::Zoom"
    }
  }
]

Pressed again, it brings the window back to its size. To use the whole screen, let macOS hide the menu bar and the Dock in System Settings. Or switch to Farum Azula Dark for full screen.

Troubleshooting

The themes are not in the theme selector. Check that the extension is listed on the Extensions page (zed: extensions). After editing themes/farum-azula.json in a clone, press Rebuild next to the extension.

The transparent theme is black. The window is in macOS full screen; see Full screen with the transparent theme.

Closure parameters are not rose-coloured. That colour comes from a semantic token of the Spring for Dart language server. Turn on "semantic_tokens": "combined" for Dart and use Flutter Tools, or add the token rule described on the Spring for Dart page.