About
A registry of 389 components, one interaction each.
ns-ui is an open-source (MIT) registry of React components built and maintained by Nikolas Sapalidis. It is not a package you depend on: every component installs as plain source into your own repository, with one npx shadcn add command and no runtime library left behind.
What it is
Each component is built around a single interaction — a hold to confirm, a row that can be un-deleted, a hero that reacts to the cursor rather than to a click. That constraint is the whole editorial rule: a button styled differently from an existing button is not a new component here, and two submissions demonstrating the same behavior mean only the clearer one ships. The full standard is on the guidelines page.
Components are themed entirely by CSS custom properties the host app already defines, so they inherit your palette in both light and dark rather than shipping their own. The tokens they read are listed on /theming.
How it is verified
Nothing is merged on a screenshot the author took by hand. A Playwright suite renders every component headlessly across states and both themes and fails the build on a console error, a blank render, an interactive control Tab cannot reach, or a control with no accessible name. It also fails any component whose hover state renders byte-identical to its resting state, and any component whose dark and light renders are identical — an interaction that does not visibly interact is not an interaction, and a component that ignored the theme is not themed.
For agents
The registry is machine-readable first. An MCP server exposes search and per-component detail as callable tools over /.well-known/mcp (or stdio, via npx -y @nikolas.sapa/ns-ui-mcp); /llms.txt and /llms-full.txt carry the catalog as plain text; every prose page here also answers to Accept: text/markdown with a markdown version of itself. Setup for each client is on /connect.
Contributing
Component proposals go through /submit or a pull request on GitHub. Contributions are accepted under the MIT license with a DCO sign-off; the mechanics — setup, file layout, the verify commands — are in CONTRIBUTING.md in the repository.
Contact
Email nikolas.sapalidis@gmail.com for anything, or open an issue on GitHub for anything about a specific component. Security reports go privately through GitHub's security advisories or the same address — never a public issue; the policy is in SECURITY.md. What the site stores about you, and who processes it, is on /privacy.
Canonical home: https://design.helpmarq.com.