Skip to content
skrewww

Changelog

Meaningful updates to the Skrewww design system, newest first. For current implementation status and technical detail, see the project documentation in the repository. Guard and Agent Kit each track their own release stage — see Guard and Agent Kit.

Figma spacing release (Pro and Free)

The Pro and Free Figma libraries are updated with a consistent spacing foundation: a 4px base grid with an 8px-preferred macro rhythm. The Free Community file and the Skrewww Pro product are updated too. These are Figma changes and are separate from the @skrewww/react package release.

New
  • Pro: Combobox now comes in Small, Medium and Large sizes.
Improved
  • Small Button, Text Input and Select now use an explicit 32px height in both Pro and Free; Small Search Field matches in Pro.
  • Button Small and Link icon gaps are aligned with the canonical component rhythm in both Pro and Free.
  • Pro: Split Button Small segments now align at 32px, and the Validation Message icon-to-text gap is refined.
Fixed
  • Tabs: the active indicator no longer changes a tab's height when it is selected, in both Pro and Free.

@skrewww/react 0.1.0-beta.2

Second public beta of the framework-agnostic React package. Install with @skrewww/react@beta, or pin 0.1.0-beta.2. A bare npm install of the package still resolves to the first beta, so prefer the beta tag or an exact version. No public API change and no new dependency.

Fixed
  • Validation Message icon-to-text spacing now follows the 4px micro rhythm.
  • Form Field spacing between the label, the control and the supporting or error text now follows the 8px structural rhythm.

Indexed in the shadcn registry directory

The @skrewww registry is indexed in the shadcn registry directory, so the shadcn CLI resolves the @skrewww namespace without any components.json setup. This is a directory entry, not an endorsement by shadcn.

New
  • Install directly with npx shadcn@latest add @skrewww/button — Foundation installs automatically, and no registry entry needs to be added first.
  • Browse every installable Skrewww item from the CLI with npx shadcn@latest search @skrewww.

Free/Pro Figma parity and Dark-mode contrast

The Free Figma library now matches Pro's presentation quality and shared component behavior, and Alert's Dark-mode colors now meet accessible contrast. Figma component counts stay separate from the open-source React library (23 Free / 52 Pro components in Figma).

Improved
  • Free Figma component pages now use the same presentation structure and quality as Pro across all 23 components.
  • Gradient surface treatment is now consistent across shared Free and Pro components.
  • Alert Dark-mode colors reworked for accessible contrast on title, description, and status icon, across Info, Success, Warning, and Error.
Fixed
  • Button's focused-state outline, restored in the Free file.
  • A pagination item's default-state text was hard to read; corrected.
  • Alert and Toast corner radius now behaves consistently across Shape modes.
  • Outdated token references in a few component descriptions, corrected to match current behavior.

Skrewww Guard (Beta)

Public Beta of an offline local CLI that validates selected Skrewww canonical-contract claims. Install with @skrewww/guard@beta. Guard is Beta — not a TypeScript, accessibility, Figma, or visual checker. Details on the Guard page.

New
  • Public package @skrewww/guard with the skrewww-guard CLI — offline, local, zero-config validation after install.
  • Three public consumer rules: nonexistent component slug, false Stable maturity claims, and false installable-via-registry claims.
  • Provenance-aware checks via @skrewww-component origin markers from Skrewww registry installs (unmarked local files stay unknown — no false errors).
Improved
  • Docs surface at /guard with install, rule list, limitations, and links to npm and the GitHub release.

Skrewww is now open source

The Skrewww codebase is now open source under the MIT license, with a public contribution workflow. Agent Kit remains available in Beta. Skrewww Pro (the paid Figma library and Gumroad deliverables) and Skrewww Free (the Community Figma file) remain separate from this repository.

New
  • Repository source is public under the MIT license — components, tokens, docs platform, tests, registry infrastructure, and Agent Kit.
  • Public contribution workflow: issue templates for bugs, component issues, Agent Kit issues, documentation issues, and feature requests, plus a pull request template.
Improved
  • Agent Kit's public Feedback section now points to the live issue tracker instead of an informal contact route.

Skrewww Agent Kit (Beta)

Public Beta: helps AI coding agents understand and use Skrewww from current machine-readable contracts instead of relying on model memory. Agent Kit's own release stage is Beta — independent of individual component maturity. Known limitations are listed on the Agent Kit page.

New
  • Machine-readable component contracts (API, tokens, usage guidance, accessibility) for every implemented component.
  • A canonical Agent Skill teaching coding agents to check a real contract before using a Skrewww component, instead of relying on memorized APIs.
  • Project context detection — a conservative, evidence-only read of what a consumer project actually has configured.
  • Recipes and one Feature Kit for common multi-component patterns.
  • Public retrieval for all of the above, plus a documented relationship to the existing @skrewww shadcn registry.
Improved
  • In a 14-case internal Beta evaluation, Agent Kit reduced hard design-system errors from 35 to 1 under the tested setup.

Analytics preferences

New
  • Added analytics preferences so visitors can choose whether Google Analytics measurement is enabled.
Improved
  • Analytics preferences can be reopened at any time using the Analytics preferences control to change your choice.

Skrewww 1.0

Skrewww Design System 1.0 — platform and documentation release. Individual React components retain their own Beta or Stable maturity and are promoted independently from the platform release.

New
  • Skrewww Design System 1.0 platform release.
  • Verified shadcn registry distribution for the supported install surface.
  • Production-ready foundation, token, and accessibility contracts for the platform release.
Improved
  • Core Figma and React parity, including interaction-state alignment.
  • Glass Menu panel parity.
  • Link interaction and state parity.
  • Foundation brand interaction ramp.
  • Registry dependency validation and clean consumer install path.
Fixed
  • Stable-v1 component and state parity defects closed during hardening.
  • Foundations page-specific canonical and SEO metadata.

Foundation refinements and component distribution

Closer color parity with the design source, a new Gradient surface option, several accessibility and rendering fixes, and a new way to install components directly into a project.

New
  • Added a Getting Started guide for developers working in the Skrewww repository.
  • Components can now be installed directly into a project through the shadcn CLI.
  • Introduced a Gradient surface option for supported components, alongside the existing Flat and Glass modes.
Improved
  • Brought core text colors closer in line between the design source and the React components.
  • Refined how several components render in Gradient and Glass modes — including containers, feedback messages, file upload, and list items — to more closely match the approved designs.
  • Improved supporting-text readability across Accordion, Dialog, Drawer, Empty State, Popover, and Table headers.
Fixed
  • Fixed the button focus indicator not always being visible across every surface mode.
  • Fixed the current-page indicator in Pagination not displaying correctly in Glass mode.
  • Fixed low-contrast supporting text in the File Upload empty state.
  • Fixed inconsistent behavior for disabled items with keyboard shortcuts in Menu.