Obsidian Stats logoObsidian Stats

Lucy

by gabrielbacha
Screenshot of the Lucy Obsidian theme
5
4
3
2
1
Code

Description

This theme supports Dark Mode
This theme supports Light Mode

README file from

Github

Lucy

A clean, spacious, Notion-inspired theme designed for clear thinking in Obsidian, Typora, and Zed.

Lucy Theme Showcase Lucy Theme Showcase Lucy Theme Showcase

✨ Features

Lucy is designed to remove visual noise, leaving you with a calm, well-structured digital canvas that feels like Notion but runs locally.

🧘 Distraction-Free Workspace

  • Auto-Hiding Document Titles: The note title container fades away to 0 opacity and smoothly transitions back only when focused (:focus-within), giving you a clean header line.
  • Low-Contrast Markdown Formatting: Formatting markers (such as #, **, *, ~~, ==, `) are styled in a semi-transparent, subtle color. They fade into the background, highlighting only the parsed text.

📐 Elegant Document Hierarchy

  • Full-Viewport H1 Accent Lines: Section headers (H1) feature top and bottom border accent lines. In Live Preview, these lines stretch edge-to-edge across the viewport for a structured, editorial feel.
  • Bordered H2 Headers: H2 elements include a clean underline border to clearly demarcate secondary sections.
  • Refined Heading Palette: Headings scale proportionally from H1 down to H6 with distinct color weights customized for both dark and light modes.

🎨 Notion-Inspired Colors

  • Light Mode: Features a clean base with a premium royal purple/deep indigo accent (rgb(65, 37, 131)). Default callouts, info callouts, and todo checkboxes adapt this deep indigo hue.
  • Dark Mode: Employs a soft, steel-blue palette with high contrast, light-blue headers for exceptional legibility during night writing.

🔗 Connected Blockquotes

  • Consecutive blockquote paragraphs visually connect their left borders, preventing disjointed blocks and creating a cohesive container for quoted text.

📝 Refined Lists & Layout Spacing

  • 3-Level Bullet Cycling: Bullets dynamically cycle their shape depending on indentation depth (Level 1: filled disc, Level 2: hollow circle, Level 3: filled square), looping every 3 levels.
  • Optimal Spacing: Generous line spacing and compact list items (2px vertical padding) strike the perfect balance between readability and density.
  • Empty Line Indicators: Blank lines retain Obsidian's native editor height and display a subtle caret guide (¬) to indicate line breaks without disrupting cursor placement.

🚀 Obsidian Installation

[!NOTE] Lucy requires Obsidian v1.13.0 or higher.

Option 1: Community Themes (Recommended)

  1. Open Settings in Obsidian.
  2. Navigate to Appearance → Themes → Manage.
  3. Search for Lucy.
  4. Click Install and use.

Option 2: Manual Installation

  1. Download theme.css and manifest.json from the latest release.
  2. In Obsidian, go to Settings → Appearance → Themes and click the Folder icon to open your themes directory.
  3. Create a folder named Lucy.
  4. Copy theme.css and manifest.json into the Lucy folder.
  5. In Obsidian, select Lucy from the themes dropdown.

✍️ Typora Installation

Lucy includes separate light and dark themes for Typora.

  1. Download lucy-typora.zip from the latest release and extract it.
  2. In Typora, open Settings → Appearance → Open Theme Folder.
  3. Copy lucy-light.css, lucy-dark.css, and the lucy directory into the theme folder.
  4. Restart Typora and select Lucy Light or Lucy Dark from the Themes menu.

See the Typora package documentation for appearance pairing, customization tokens, compatibility details, and the visual test fixture.

💻 Zed Installation

Lucy includes a native light/dark theme family for Zed's application chrome, editor, syntax highlighting, terminal, diagnostics, and Git states.

  1. Download lucy-zed.zip from the latest release and extract it.
  2. Copy lucy.json into Zed's local themes directory at ~/.config/zed/themes on macOS or Linux, or %USERPROFILE%\AppData\Roaming\Zed\themes\ on Windows.
  3. Reload Zed.
  4. Open the theme selector with cmd-k cmd-t on macOS or ctrl-k ctrl-t on Linux and Windows, then select Lucy Light or Lucy Dark.

See the Zed package documentation for automatic light/dark pairing, optional font settings, and the exact scope of the port.

🛠️ Development & Releases

If you're modifying or contributing to the theme:

  1. Clone this repository into your vault's theme folder: .obsidian/themes/Lucy
  2. Run your developer tools or editor of choice. All styling is configured directly in theme.css.
  3. To draft and publish a new version:
    • Run npm run release to automatically bump the patch version, update all configuration files (manifest.json and versions.json), create a Git commit and tag, and push them to GitHub.
    • For custom version bumps (minor or major), run npm version minor or npm version major.
    • The GitHub Actions workflow will automatically capture the pushed tag, create a new GitHub Release, upload the Obsidian manifest.json and theme.css assets, and attach install-ready lucy-typora.zip and lucy-zed.zip packages.

💬 Feedback & Support

If you encounter any issues, have feature requests, or want to contribute improvements, please open an issue on the GitHub repository.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

Sponsors