Plain HTML, first
Write native <button>,
<input>,
<dialog>. Squircle dresses
them and binds behavior through
data-sq-* attributes.
One stylesheet, one 21 KB runtime, 298 design tokens and 44 original icons. No build step. No framework. No light mode to fight with. Just markup that looks finished.
npm install @luca-ecosystem/squircle
luca · dark by design
Most frameworks give you primitives and leave the coherence to you. Squircle ships the decisions already made — then gets out of your way.
Write native <button>,
<input>,
<dialog>. Squircle dresses
them and binds behavior through
data-sq-* attributes.
One CSS file and a dependency-free runtime. No React, no build chain, no transitive supply chain to audit before you can ship a landing page.
298 tokens in three tiers. Override semantic tokens once and the whole system retunes — no per-component CSS rewrites, no utility soup.
Real focus states, ARIA-wired menus and tabs, reduced-motion support, and a WCAG 2.2 AA contrast policy baked into the token palette.
Every widget here is running from the same
squircle.min.css and runtime you
would install. Click the tabs, open the dialog, fire the toast.
Change the markup on the left and press Run (or ⌘/Ctrl + Enter). The preview runs the actual 1.1.1 stylesheet and runtime — nothing is mocked.
data-sq-* to wire behavior.
An honest map. If your project needs something else, the right tool is worth more than a forced fit.
| Concern | Squircle | Tailwind | shadcn/ui | MUI | Bootstrap |
|---|---|---|---|---|---|
| Dependencies | None | Build tooling | React + Radix | React + Emotion | Optional JS |
| Build step | Not required | Required | Required | Required | Not required |
| Plain HTML | First-class | Classes in markup | No | No | Yes |
| Coherent theme out of the box | Yes | You assemble it | Copy in components | Yes | Partial |
| Dark-first identity | The point | Neutral | Neutral | Opt-in | Opt-in |
| Framework adapters | None yet | n/a | React | React | JS plugins |
| Light / auto mode | Deliberately no | Yes | Yes | Yes | Yes |
The Luca Ecosystem Theme is the default and only mode. Navy appears as layered surfaces, gold is a restrained secondary voice, and bright accents are reserved for feedback — each with a contrast-tuned text variant. That is a brand decision, not a missing toggle. If you need light or OS-aware theming, Squircle is probably the wrong fit today, and we would rather say so. The override surface is open if you want to author your own theme on top.
The long-form version — including when not to use Squircle — lives in docs/why-squircle.md.
No secret master plan. This is what is done, what is next, and what is only under consideration.
Feedback changes the order. See docs/roadmap.md and the issue tracker.
Link a stylesheet, write one button, call
Squircle.init(). If it fits, you will
know quickly.