Essentials
Base layout containers, scoped auto-styling, and typography.
Selectors
.cider- Opt-in scope — auto-styles native HTML elements inside it (typography, forms, tables, etc.).
.cider-fixed- Centered responsive page layout. Use alongside
.cider. .cider-reset- Stops
.ciderauto-styling from leaking into nested components.
Cider Scope
Hello
Native elements are auto-styled inside a .cider scope.
<div class="cider">
<h1>Hello</h1>
<p>Native elements are auto-styled inside a <code>.cider</code> scope.</p>
</div>
Page layout
.cider-fixed adds centered padding with responsive max-width breakpoints. Override any value with Tailwind utilities.
<!-- Default breakpoints -->
<div class="cider cider-fixed">
...
</div>
<!-- Override max-width -->
<div class="cider cider-fixed max-w-6xl">
...
</div>
<!-- Override padding -->
<div class="cider cider-fixed px-8">
...
</div>
<!-- Constrained fluid (no fixed breakpoints) -->
<div class="cider max-w-4xl mx-auto">
...
</div>
<!-- Custom fixed breakpoints -->
<div class="cider cider-fixed max-w-6xl xl:max-w-7xl">
...
</div>
Behind the scenes, .cider-fixed is just Tailwind utilities:
.cider-fixed {
@apply mx-auto px-5 max-w-xl md:max-w-2xl lg:max-w-4xl xl:max-w-6xl;
}
| Breakpoint | Viewport | Max width |
|---|---|---|
| Default | < 768px | 576px (36rem) |
md |
≥ 768px | 672px (42rem) |
lg |
≥ 1024px | 896px (56rem) |
xl |
≥ 1280px | 1152px (72rem) |
Semantic containers
Apply .cider to any element — <header>, <main>, <footer>, or a <div>. Each opens its own auto-styling scope.
<body>
<header class="cider py-6">
<h1>My App</h1>
</header>
<main class="cider py-8">
<h2>Welcome</h2>
<p>All elements inside are styled automatically.</p>
<form>
<label for="name">Name</label>
<input type="text" id="name">
<button class="btn-gray" type="submit">Send</button>
</form>
</main>
<footer class="cider py-6">
<small>© 2026 My App</small>
</footer>
</body>
Scope boundary
Add .cider-reset to stop auto-styling from leaking into nested components. Nest .cider again to re-open a new scope.
Reset boundary
Styled by .cider
This paragraph is auto-styled.
no .cider styling
<div class="cider">
<h1>Styled by .cider</h1>
<p>This paragraph is auto-styled.</p>
<div class="cider-reset">
<code>no .cider styling</code>
</div>
</div>
Re-enabling inside reset
Styled
Unstyled
Styled again
<div class="cider">
<code>Styled</code>
<div class="cider-reset">
<code>Unstyled</code>
<div class="cider" style="margin-top:0.5rem">
<code>Styled again</code>
</div>
</div>
</div>
Typography
Headings, paragraphs, lists, and inline elements are auto-styled inside a .cider scope.
Font sizes
| Element | Size | Weight | Line height | Margin top | Margin bottom |
|---|---|---|---|---|---|
| Body | 17px | Regular | 1.47 | — | — |
h1 |
34px | Bold | 1.21 | 32px | 16px |
h2 |
28px | Bold | 1.21 | 32px | 12px |
h3 |
22px | Bold | 1.27 | 24px | 8px |
h4 |
20px | Semibold | 1.25 | 16px | 4px |
small |
13px | Regular | — | — | — |
code |
13px | Regular | — | — | — |
<table>
<thead>
<tr>
<th>Element</th>
<th>Size</th>
<th>Weight</th>
<th>Line height</th>
<th>Margin top</th>
<th>Margin bottom</th>
</tr>
</thead>
<tbody>
<tr>
<td>Body</td>
<td>17px</td>
<td>Regular</td>
<td>1.47</td>
<td>—</td>
<td>—</td>
</tr>
<tr>
<td><code>h1</code></td>
<td>34px</td>
<td>Bold</td>
<td>1.21</td>
<td>32px</td>
<td>16px</td>
</tr>
<tr>
<td><code>h2</code></td>
<td>28px</td>
<td>Bold</td>
<td>1.21</td>
<td>32px</td>
<td>12px</td>
</tr>
<tr>
<td><code>h3</code></td>
<td>22px</td>
<td>Bold</td>
<td>1.27</td>
<td>24px</td>
<td>8px</td>
</tr>
<tr>
<td><code>h4</code></td>
<td>20px</td>
<td>Semibold</td>
<td>1.25</td>
<td>16px</td>
<td>4px</td>
</tr>
<tr>
<td><code>small</code></td>
<td>13px</td>
<td>Regular</td>
<td>—</td>
<td>—</td>
<td>—</td>
</tr>
<tr>
<td><code>code</code></td>
<td>13px</td>
<td>Regular</td>
<td>—</td>
<td>—</td>
<td>—</td>
</tr>
</tbody>
</table>
Headings
Heading 1
Heading 2
Heading 3
Heading 4
<h1>Heading 1</h1>
<h2>Heading 2</h2>
<h3>Heading 3</h3>
<h4>Heading 4</h4>
Paragraphs & links
Design is not just what it looks like and feels like. Design is how it works. Every detail matters — the way text flows on a page, the spacing between elements, the careful balance of hierarchy.
When done right, typography becomes invisible, letting the content speak for itself.
<p>Design is not just what it looks like and feels like. Design is how it works. Every detail matters — the way text flows on a page, the spacing between elements, the careful balance of hierarchy.</p>
<p>When done right, typography becomes invisible, letting the <a href="#">content speak for itself</a>.</p>
Inline text
Use the @import "ciderui" directive to include all styles.
Press Cmd + K to open the command palette.
Use mark to highlight important text.
Build interfaces with CSS and HTML.
This is helper text at a smaller size.
<p>Use the <code>@import "ciderui"</code> directive to include all styles.</p>
<p>Press <kbd>Cmd</kbd> + <kbd>K</kbd> to open the command palette.</p>
<p>Use <mark>mark</mark> to <mark>highlight</mark> important text.</p>
<p>Build interfaces with <abbr title="Cascading Style Sheets">CSS</abbr> and <abbr title="HyperText Markup Language">HTML</abbr>.</p>
<p><small>This is helper text at a smaller size.</small></p>
Blockquote
Simplicity is the ultimate sophistication.
<blockquote>
Simplicity is the ultimate sophistication.
</blockquote>
Unordered list
- Clean, semantic HTML structure
- Apple-inspired design tokens
- Dark mode support built-in
<ul>
<li>Clean, semantic HTML structure</li>
<li>Apple-inspired design tokens</li>
<li>Dark mode support built-in</li>
</ul>
Ordered list
- Install the Tailwind CSS plugin
- Import the ciderui stylesheet
- Start building beautiful interfaces
<ol>
<li>Install the Tailwind CSS plugin</li>
<li>Import the ciderui stylesheet</li>
<li>Start building beautiful interfaces</li>
</ol>
Description list
- Cider UI
- Apple-aesthetic UI components as a Tailwind CSS v4 plugin.
- Dark mode
- Add class="dark" to your html element. All components adapt automatically.
- Framework
- No framework required. Pure CSS with optional vanilla JS.
<dl>
<dt>Cider UI</dt>
<dd>Apple-aesthetic UI components as a Tailwind CSS v4 plugin.</dd>
<dt>Dark mode</dt>
<dd>Add class="dark" to your html element. All components adapt automatically.</dd>
<dt>Framework</dt>
<dd>No framework required. Pure CSS with optional vanilla JS.</dd>
</dl>