# ary — obsidian theme

> a brutalist obsidian theme.
> georgia for prose, jetbrains mono for everything else, one accent color.
> matches [aryvectory.xyz](https://aryvectory.xyz).

![dark mode preview](./screenshots/dark.png)

> *"all the typography of an essay journal, none of the rounded corners."*

a single 9 KB css file. no images, no icons, no themes-within-themes. designed for people who write a lot in obsidian and want their notes to look like a book, not a productivity app.

---

## install

### option 1 — community plugins (when published)

settings → appearance → manage → search "ary" → install → use.

### option 2 — manual

```bash
# from your vault root
mkdir -p .obsidian/themes/ary
curl -o .obsidian/themes/ary/theme.css \
  https://aryvectory.xyz/obsidian/theme.css
curl -o .obsidian/themes/ary/manifest.json \
  https://aryvectory.xyz/obsidian/manifest.json
```

then in obsidian: **settings → appearance → themes → ary**.

---

## what it changes

- **typography** — georgia for body prose, jetbrains mono for code, headings, the file tree, the status bar, every UI element. obsidian's default sans-serif is gone.
- **colors** — single accent color (`#c6ff00` chartreuse) used sparingly, on hover, on tags, on active states, on the code-block left border, on H1 underlines. everything else is greyscale.
- **shapes** — every border-radius is forced to zero. sharp corners on every panel, every modal, every input, every tag.
- **callouts** — obsidian's default pastel callouts become hairline-bordered blocks. `[!info]` and `[!note]` get the accent color. `[!warning]` gets the accent-muted background. `[!error]` gets red.
- **tables** — dashed row separators, mono font, double-line under headers. matches the rest of the brutalist family.
- **code** — `pre` blocks get the signature 3px solid accent left border. inline `code` gets a hairline outline.
- **graph view** — node colors retuned to match the design system; tags are accent, unresolved are muted.

---

## customizing

every color and font lives at the top of `theme.css` in two `:root`-style blocks. open the file and edit the variables — no compilation, no build step.

```css
.theme-dark {
  --ary-bg: #0e0e0e;          /* page background */
  --ary-bg-card: #151515;     /* code blocks, sidebar */
  --ary-fg: #e8e6df;          /* primary text */
  --ary-muted: #8a8a8a;       /* metadata, secondary */
  --ary-acc: #c6ff00;         /* the accent — change this for a different feel */
  --ary-acc-muted: rgba(198, 255, 0, 0.08);
  --ary-rule: #e8e6df;        /* major borders */
  --ary-cb: #2a2a2a;          /* card / panel borders */
  --ary-red: #e24b4a;         /* error / destructive */
}
```

**accent ideas:**
- `#c6ff00` — chartreuse (default, brutalist)
- `#ff5c00` — burnt orange (warm)
- `#00ddff` — electric cyan (cold)
- `#ff3366` — magenta (loud)
- `#a3a3a3` — grey (no-accent variant)

after editing, save the file. obsidian picks up changes within ~1 second.

---

## fonts

the theme assumes **jetbrains mono** is available. if it isn't:

- macos: download from [jetbrains.com/lp/mono](https://www.jetbrains.com/lp/mono/) and double-click to install
- linux: `sudo apt install fonts-jetbrains-mono` or equivalent
- windows: download the zip, extract, right-click each `.ttf` → "install"

if jetbrains mono isn't present, obsidian falls back to your system mono (sf mono on mac, consolas on windows, monospace on linux). still readable, but loses some character.

georgia ships with every os.

---

## screenshots

### dark
![dark mode](./screenshots/dark.png)

### light
![light mode](./screenshots/light.png)

### graph view
![graph view](./screenshots/graph.png)

### a typical note
![note example](./screenshots/note.png)

---

## license

MIT — fork it, modify it, use it for your own theme.

if you publish a derivative theme, attribution appreciated but not required. if you ship it commercially with a small change, please at least pick a different accent color so we're not stepping on each other.

---

## also see

- [aryvectory.xyz/obsidian](https://aryvectory.xyz/obsidian) — the long-form writeup, with screenshots, sample notes, and the design rationale
- [aryvectory.xyz](https://aryvectory.xyz) — the website this theme matches
- [`DESIGN.md`](https://aryvectory.xyz/DESIGN.md) — the design system spec