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.