![](img/hero.png) ### Crafted for the way you think. _Best Theme of [Obsidian Gems of the Year 2024](https://obsidian.md/blog/2024-goty-winners/)_

## Overview ### Fresh. Familiar. Focused. **Feels right at home.** Clean typography, refined spacing, and native-inspired components make Cupertino feel like it belongs on any device. ![](img/adaptive.png) **Built for mobile.** Everything is redesigned for touch. One-hand reachability, comfortable spacing, and intuitive layout make your vault feel right in your pocket. ![](img/mobile.png) ## Philosophy ### Less is more. Cupertino exists because great tools should just work. No rabbit holes. No endless tweaking. Just a beautiful, distraction-free place to think and write. - **Fewer plugins** Everything you need is here without plugins. Cupertino is complete the moment you install it. - **Fewer customizations** Every option is an invitation to procrastinate. Cupertino keeps choices intentionally minimal so you stay in flow. - **Less visual noise** Low-priority UI elements step back automatically. What remains is what matters. ## Plugins Cupertino works beautifully on its own. These plugins let you fine-tune the experience if you'd like. ### [Style Settings](https://community.obsidian.md/plugins/obsidian-style-settings) Enable focus view, hover sidebars. Or disable active line highlight, centered tabs, and compact status bar, and more. ### [Pseudo Mica](https://community.obsidian.md/plugins/pseudo-mica) Bring translucent window effects to Windows and macOS for an even more native feel. ## Features Cupertino supports all filter and helper classes from [Minimal](https://github.com/kepano/obsidian-minimal). ### Banner | Class | Description | | :---------------------- | :------------------------------------------------------------------------------------------ | | `banner` | Add at the end of the image link, e.g. `![[image.jpeg\|banner]]` | | `banner-fade` | Add faded edge to the banner (requires `banner`) | | `banner-icon` | Add an emoji or letter as note icon using callout, e.g. `> [!banner-icon] 👋` | | `banner-title` | Moves inline title next to the icon (requires `banner-icon`) | | `y0`, `y5`... to `y100` | Adjust the vertical position of the banner (requires `banner`), from 0 to 100 in steps of 5 | ### [Block width](https://minimal.guide/features/block-width) | Class | Description | | :------------------------------------- | :------------------------------------ | | `wide` | Entire note uses wide line width | | `max` | Entire note uses max line width | | `table-100`, `bases-100`, `img-100` | Fill 100% of the pane width | | `table-max`, `bases-max`, `img-max` | Fill the max line width (default 90%) | | `table-wide`, `bases-wide`, `img-wide` | Fill the wide line width | ### [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) | ### Embeds | Class | Description | | :----------------- | :----------------------- | | `embed-strict` | Remove embed background | | `embed-hide-title` | Hide embedded file title | ### [Image filters](https://minimal.guide/images#Image+filters) Add at the end of the image link, e.g. `![[image.jpeg#invert]]` | 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 | ### [Tables](https://minimal.guide/tables) | Class | Description | | :-------------- | :-------------------------------------------------- | | `table-nowrap` | Disable line wrapping in table cells | | `table-wrap` | Force line wrapping in table cells | | `table-center` | Center small tables narrower than line width | | `table-numbers` | Add row numbers to tables | | `table-tabular` | Use tabular figures in tables | | `table-small` | Use small font size in tables | | `table-tiny` | Use tiny font size in tables | | `table-lines` | Add borders around all table cells | | `row-lines` | Add borders between table rows | | `col-lines` | Add borders between table columns | | `row-alt` | Add striped background to alternating table rows | | `col-alt` | Add striped background to alternating table columns | | `row-hover` | Highlight rows on hover | ### [Bases](https://minimal.guide/tables) | Class | Description | | :-------------- | :------------------------------------------------------------- | | `bases-row-alt` | Add striped background to alternating Bases table view rows | | `bases-col-alt` | Add striped background to alternating Bases table view columns | | `bases-plain` | Hide embedded Bases toolbar | ### [Alternate checkboxes](https://github.com/damiankorcz/Alternative-Checkboxes-Reference-Set) ![](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 | | `- [+]` | Add | | `- [B]` | Brainstorm | | `- [a]` | Alarm | | `- [n]` | Note | | `- [R]` | Review | | `- [t]` | Time | | `- [P]` | Phone | | `- [L]` | Love | ## Credits - [**Yushan Main East Peak** by Huang Chung Yu](https://commons.wikimedia.org/wiki/File:Yushan_main_east_peak%2BHuang_Chung_Yu%E9%BB%83%E4%B8%AD%E4%BD%91%2B9030.png) - Yushan background - [**Minimal** by kepano](https://github.com/kepano/obsidian-minimal) ([Donate](https://www.buymeacoffee.com/kepano)) - Dataview cards, image filters, table helper classes ## License Cupertino is licensed under the [MIT license](LICENSE).