Best Theme of Obsidian Gems of the Year 2024 awards

Cupertino is an Obsidian theme, optimized for desktop and mobile devices. Bringing clean, focused, comfortable reading and writing experience to your vault.

Support me and my work so I can keep regular updates and fixes. You’re also welcomed to submit pull requests.

Overview

• Native & minimal — Clean, native look and feel on all of your devices, so you can focus on your content.

  

• Optimized for mobile — Redesigned modals, menu, editor, search, and more, with comfortable spacing for usability.

  

• Windows Mode — Fluent Design UI for native feeling on Windows (Enabled by default, can be disabled with Style Settings)

  

Note

Make sure to enable "Translucent window" in Obsidian Appearance settings.

Plugins

All features are enable by default, following plugins can be installed to modify your installation. they are not required.

Style Settings

• Disable active line indicator
• Disable alternative heading style
• Disable auto hiding panel actions
• Disable centered tabs
• Disable compact status bar
• Disable Windows mode
• Enable accented window
• Enable compact view ...etc.

Pseudo Mica (Windows only)

Adds pseudo-Mica (wallpaper as background) on Windows (Alternatively, wait for Obsidian native support)

Philosophy

I’ve spent way too much time on customizing Obsidian, thousands of themes with millions of customizations, I believe a lot people do it too. It’s anti-productivity at this point, we need something that just works and is pleasant to use.

1. Less plugins. — Style Settings is only used for disabling features and fixing issues instead of adding. Cupertino works perfectly out of the box.
2. Less customizations — Customization is often more of a distraction that makes you waste more time on fiddling. Cupertino will never add customization.
3. Less visual noise — Your content is the key. Low priority UI elements are auto hidden to maintain focusability on content.

Features

Cupertino supports most filter and helper classes from Minimal.

Editor filters

Class	Description
story	Centered headings, indented text and wider letter spacing for reading
sepia	Low contrast with sepia hue from Flexoki
low-contrast	Low background and text contrast

Image filters

Filter	Description
#blend	Blend image into background
#invert	Invert images in dark mode — ideal for charts and handwriting on light backgrounds
#invertW	Invert images in light mode — ideal for charts and handwriting on dark backgrounds
#circle	Crop image to a circle
#outline	Add outline around image
#interface	Add drop shadow behind image

Image grids

Class	Description
img-grid	Activate image grids

Cards

Class	Description
cards (required)	Set all Dataview tables to card layout
list-cards	Set all bullet lists to card layout
cards-align-bottom	Align the last element of a card to the bottom
cards-cover	Images are resized to fill the defined space
cards-16-9	Fit images in cards to 16:9 ratio
cards-1-1	Fit images in cards to 1:1 ratio (square)
cards-2-1	Fit images in cards to 2:1 ratio
cards-2-3	Fit images in cards to 2:3 ratio
cards-cols-1 to 8	Force a specific number of columns (from 1 to 8)

Tables

Class	Description
table-small	Use small font size in tables
table-tiny	Use tiny font size in tables
row-alt	Add striped background to alternating table rows
col-alt	Add striped background to alternating table columns

Embeds

Class	Description
embed-strict	Remove embed background
embed-underline	Add underline to embedded content
embed-hide-title	Hide embedded file title

Alternate checkboxes

Syntax	Description
- [ ]	To-do
- [/]	Incomplete
- [x]	Done
- [-]	Canceled
- [>]	Forwarded
- [<]	Scheduling
- [?]	Question
- [!]	Important
- [*]	Star
- ["]	Quote
- [l]	Location
- [b]	Bookmark
- [i]	Information
- [S]	Savings
- [I]	Idea
- [p]	Pros
- [c]	Cons
- [f]	Fire
- [k]	Key
- [w]	Win
- [u]	Up
- [d]	Down

Credits

• @kepano - Minimal: Cards, image grids, image filters

Licensing

Cupertino is licensed under the MIT license.