Baseline isn’t just another Obsidian theme — it’s a theming platform designed for flexibility and longevity. Created by the developer behind the Cupertino theme, Baseline offers a polished, mobile-first design that’s deeply customizable through the Obsidian Style Settings plugin. Beyond static CSS, it supports style migration from other themes and a community-driven marketplace for sharing presets, making it a solid foundation for Obsidian users who want both aesthetics and configurability.
What baseline offers and how it’s built
At its core, Baseline is an Obsidian theme written in SCSS that focuses on both out-of-the-box beauty and adaptability. Unlike many themes that offer fixed styling, Baseline integrates tightly with Obsidian’s Style Settings plugin, allowing users to tweak colors, fonts, spacing, and other design tokens without diving into CSS themselves.
The theme supports the full set of helper classes from the Minimal theme suite — including banners, cards, image grids, tables, embeds, and alternate checkboxes. This compatibility means users migrating from Minimal or using Minimal’s conventions in their vaults can adopt Baseline without breaking existing styles.
The architecture revolves around SCSS partials that organize styles logically and promote maintainability. This modular approach helps manage complexity and enables layering of customizations. The project prioritizes a mobile-first design, enhancing navigation and refining menus to work well on small and large screens alike.
A distinguishing feature is the Style Settings Migration Tool, which can import user settings from other supported themes. This tool makes switching themes less painful by preserving your customizations rather than forcing a reset. Complementing this is the Baseline Marketplace, a community hub where users can share and download style presets, fostering collaboration and experimentation.
Technical strengths and design tradeoffs
The standout technical strength lies in Baseline’s approach to decoupling presentation from configuration. By leveraging Obsidian’s Style Settings plugin, the theme externalizes configuration options that are typically hardcoded in CSS. This means users can adjust theme parameters dynamically, and these settings can be exported, imported, or shared.
Supporting the Minimal helper classes is another plus. These utility classes provide rich UI components like:
.banner { /* styles for banner */ }
.card { /* styles for cards */ }
.image-grid { /* grid layout for images */ }
.alternate-checkbox { /* custom checkbox styles */ }
This compatibility ensures that Baseline fits well in vaults that rely on Minimal’s established CSS ecosystem, reducing friction for users who want advanced UI components without extra setup.
The SCSS codebase is well-structured, which is crucial for maintainability given the complexity of theming an app like Obsidian. Mobile-first CSS ensures the theme adapts well across devices, a significant UX advantage given Obsidian’s desktop and mobile presence.
However, there are tradeoffs. SCSS requires a build step and some familiarity with CSS preprocessors for users who want to extend the theme beyond the provided Style Settings. While the migration tool eases switching, it only supports themes that integrate with Style Settings, which limits backward compatibility with older or simpler themes.
Also, the reliance on Obsidian’s Style Settings plugin means that users must have this plugin installed and enabled, which adds a dependency. For users who prefer pure CSS themes or don’t want to use Style Settings, Baseline might feel heavyweight.
Quick start
Migrating from another theme?
Seamlessly migrate your existing Style Settings from supported themes.
Carry your settings over with Style Settings Migration Tool ↗
Looking for inspiration?
Discover and share Style Settings presets in Baseline Marketplace.
Explore community-made presets in Baseline Marketplace ↗
This quick start points to the migration tool and marketplace but does not provide direct commands because Baseline is installed as a typical Obsidian theme. The key takeaway is the ability to carry over style settings and explore presets without manual CSS hacking.
Verdict
Baseline is a solid choice for Obsidian users who want more than just a static theme. Its SCSS foundation, combined with deep Style Settings integration, makes it a flexible platform for customization. The migration tool and marketplace add practical value for users who experiment with themes or want to share their style configurations.
The tradeoff is the added complexity of SCSS and dependency on the Style Settings plugin, which might not suit all users, especially those seeking minimalist or zero-dependency themes. But for those invested in Obsidian customization and willing to engage with the style ecosystem, Baseline offers a clean, maintainable, and user-friendly foundation.
In production, this means less friction when switching themes and the ability to evolve your vault’s look without rewriting CSS. It’s worth understanding even if you don’t adopt it because it sets a direction for how Obsidian themes can move beyond static CSS into configurable platforms.
Related Articles
- Mosaic Lite: a minimal React and Tailwind CSS admin dashboard template — Mosaic Lite is a minimal React admin dashboard template built with Tailwind CSS and Vite, designed for flexibility and d
- Obsidian-pm: a Markdown-based project management system inside Obsidian — Obsidian-pm transforms your Obsidian vault into a project management system using Markdown and YAML, with views like Tab
- Exploring axton-obsidian-visual-skills: AI-powered diagram skills for Obsidian — axton-obsidian-visual-skills offers prompt-based Claude Code Skills to generate Excalidraw, Mermaid, and Canvas diagrams
- Building a visual CSS variable editor for shadcn/ui theme customization — Explore how shadcn-ui-customizer extends shadcn/ui with a visual color picker for CSS custom properties, covering design
- Hermes Mod: visual skin editor with ASCII art hero images for the Hermes CLI — Hermes Mod offers a web UI to customize Hermes CLI skins, converting images to terminal-compatible ASCII art hero banner
→ GitHub Repo: aaaaalexis/obsidian-baseline ⭐ 1,381 · SCSS