Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/aaaaalexis/obsidian-cupertino

A native look and feel Obsidian theme designed for a clean, focused, and mobile-friendly writing experience.
https://github.com/aaaaalexis/obsidian-cupertino

dark-theme light-theme obsidian obsidian-md obsidian-theme theme

Last synced: 12 days ago
JSON representation

A native look and feel Obsidian theme designed for a clean, focused, and mobile-friendly writing experience.

Awesome Lists containing this project

README 

        
![Screenshot of Cupertino theme for Obsidian running on macOS and iOS.](img/hero.png)



### Best Theme of Obsidian [Gems of the Year 2024](https://obsidian.md/blog/2024-goty-winners/) 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](https://www.buymeacoffee.com/sevenaxis) 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.



  ![Two screenshots showcasing Cupertino on macOS. The first shows how Cupertino utilizes background blur. The second showcases the stylized text editor.](img/native.png)



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



  ![Three screenshots showcasing Cupertino on mobile. The first shows file navigation sidebar with comfortable spacing. The second highlights the mode switcher within the editor. The third displays a redesigned search interface.](img/mobile.png)



- **Windows Mode** — Fluent Design UI for native feeling on Windows (Enabled by default, can be disabled with [Style Settings](https://github.com/mgmeyers/obsidian-style-settings))



  ![Screenshot of Cupertino theme for Obsidian running on Windows.](img/windows.png)



> [!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](https://github.com/mgmeyers/obsidian-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](https://github.com/aaaaalexis/obsidian-cupertino-helper/) (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](https://github.com/kepano/obsidian-minimal).



### Editor filters



| Class          | Description                                                               |

| :------------- | :------------------------------------------------------------------------ |

| `story`        | Centered headings, indented text and wider letter spacing for reading     |

| `sepia`        | Low contrast with sepia hue from [Flexoki](https://stephango.com/flexoki) |

| `low-contrast` | Low background and text contrast                                          |



### [Image filters](https://minimal.guide/images#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](https://minimal.guide/Block+types/Image+grids)



| Class      | Description          |

| :--------- | :------------------- |

| `img-grid` | Activate image grids |



### [Cards](https://minimal.guide/Block+types/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](https://github.com/damiankorcz/Alternative-Checkboxes-Reference-Set)



![Preview of alternate checkboxes.](img/checkbox.png)



| 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](https://github.com/kepano/obsidian-minimal)**: Cards, image grids, image filters



## Licensing



Cupertino is licensed under the [MIT license](LICENSE).