v1.1.1 · MIT · zero dependencies

A coherent UI system for people who write HTML.

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
your-app.html — running Squircle

Overview

Everything below is real Squircle markup.
All systems normal
12.4kRequests today
99.98%Uptime
184 msp95 latency
44Icons shipped
theme: luca · dark by design
The premise

Less assembly. More finished product.

Most frameworks give you primitives and leave the coherence to you. Squircle ships the decisions already made — then gets out of your way.

◧

Plain HTML, first

Write native <button>, <input>, <dialog>. Squircle dresses them and binds behavior through data-sq-* attributes.

∅

Zero dependencies

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.

⊞

Tokens all the way down

298 tokens in three tiers. Override semantic tokens once and the whole system retunes — no per-component CSS rewrites, no utility soup.

✦

Accessible by default

Real focus states, ARIA-wired menus and tabs, reduced-motion support, and a WCAG 2.2 AA contrast policy baked into the token palette.

Live components

Not screenshots. The real stylesheet.

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.

Zero-install trial

Edit HTML. See it render. Install later.

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.

index.html
The stylesheet and runtime are injected for you. Use data-sq-* to wire behavior.
Live previewsquircle@1.1.1
Positioning

Where Squircle fits — and where it doesn't.

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

Dark by design, not by omission.

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.

Direction

Small surface, clear next steps.

No secret master plan. This is what is done, what is next, and what is only under consideration.

Shipped

  • v1.0.0 — first public release
  • v1.1.0 — nine new components
  • v1.1.1 — type declarations, form fixes, Safari 17 floor
  • 44 icons, 298 tokens, full runtime API
  • CI across Chromium, WebKit, Firefox, mobile

Next up

  • Hosted playground and this landing page
  • `create-squircle` starter template
  • StackBlitz / CodeSandbox one-click examples
  • Bundle-size and performance notes

Considering — tell us

  • React adapter (highest-leverage ask)
  • Figma kit for the token system
  • A light theme — only with real demand
  • Release cadence and contributor pipeline

Feedback changes the order. See docs/roadmap.md and the issue tracker.

Give it five minutes.

Link a stylesheet, write one button, call Squircle.init(). If it fits, you will know quickly.

New report

Dialogs, focus return, and Escape handling all come from the runtime with no framework involved.