Design

All code must follow the Coding Principles in AGENTS.md (functional, minimal, readable, modular).

Core principles

• No scrolling — ever. The webview is a fixed sandboxed canvas (min 320×320px).
• Mobile-first. Design for the smallest viewport, then scale up.
• Tailwind only. No <style> blocks, no inline style= attributes.
• Functional over decorative. Every visual element should serve the user.

Spacing scale

Use Tailwind's default spacing scale. Avoid arbitrary values (p-[13px]).

Typography

svelte
1<h1 class="text-xl font-bold tracking-tight">Title</h1>
2<h2 class="text-base font-semibold">Section</h2>
3<p  class="text-sm text-gray-700 dark:text-gray-300">Body</p>
4<span class="text-xs text-gray-500">Caption / meta</span>

• Base body size: text-sm (14px). Never below text-xs for readable content.
• Line length: max-w-sm or max-w-xs for prose.
• No custom fonts — use the system font stack (Tailwind default).

Color

Always pair a light and dark variant. Reddit renders in both modes.

Buttons

svelte
1<!-- Primary -->
2<button class="w-full rounded-lg bg-orange-500 px-4 py-2.5 text-sm font-semibold text-white
3               hover:bg-orange-600 active:scale-95 transition-all disabled:opacity-50
4               disabled:cursor-not-allowed focus-visible:outline-none focus-visible:ring-2
5               focus-visible:ring-orange-400">
6  Submit
7</button>
8
9<!-- Secondary -->
10<button class="w-full rounded-lg border border-gray-300 dark:border-gray-600 px-4 py-2.5
11               text-sm font-semibold text-gray-700 dark:text-gray-200
12               hover:bg-gray-100 dark:hover:bg-gray-700 active:scale-95 transition-all">
13  Cancel
14</button>

• Minimum tap target: min-h-[44px] or py-2.5 on text-sm.
• Always include disabled:opacity-50 disabled:cursor-not-allowed.
• Always include active:scale-95 transition-all for tactile feedback.

Inputs

svelte
1<input
2  class="w-full rounded-lg border border-gray-300 dark:border-gray-600 bg-white
3         dark:bg-gray-800 px-3 py-2 text-sm text-gray-900 dark:text-gray-100
4         placeholder:text-gray-400 focus:outline-none focus:ring-2 focus:ring-orange-400"
5/>

UI states

Every data-driven component must handle all four states:

Cards & surfaces

svelte
1<div class="rounded-xl border border-gray-200 dark:border-gray-700
2            bg-white dark:bg-gray-800 p-4 shadow-sm">
3  <!-- content -->
4</div>

• rounded-xl for cards, rounded-lg for inputs/buttons, rounded-md for badges.
• shadow-sm only — avoid heavy shadows.
• Max two surface levels deep (page → card → no deeper).

Animation

• Only Tailwind built-in transitions: transition-all, transition-colors, transition-opacity.
• Default duration (150ms). No custom durations.
• animate-pulse for loading, animate-spin for spinners.
• No entrance animations.

Checklist before finishing

• No <style> blocks — Tailwind classes only
• No arbitrary values (p-[13px]) — use scale steps
• Dark mode variants on all color classes
• Buttons have disabled, active:scale-95, and focus-visible:ring classes
• Minimum tap target size respected
• Typography follows the hierarchy (xl → base → sm → xs)