Introduction
Simplify UI is a catalog of React and Tailwind CSS components and SVG icons. Copy or command files into your app — browse a live preview, take the source, and adapt the styles.
Getting started
Clone the repo to explore locally, contribute, or pull files into another app.
$ git clone https://github.com/gradientaistudio/ui.git$ cd ui$ npm install$ npm run devOpen http://localhost:3000. Production: npm run build then npm start.
To use a component elsewhere, copy it from components/ui/, ensure Tailwind resolves, and import it like any other file. Pair -usage.tsx files show the intended JSX shape.
Stack
Next.js 16
App Router, RSC + client components
React 19
Plain React primitives
Tailwind CSS v4
@theme tokens + class dark mode
TypeScript
Typed registry + ComponentSlug
GSAP
Homepage motion + catalog fades
Syntax highlighter
Preview / Code / Usage tabs
Project structure
app/
(site)/ # Marketing + catalog routes
page.tsx # Homepage
components/ # Component catalog
icons/ # Icon catalog
docs/ # This documentation
[slug]/ # Individual component pages
globals.css # Tailwind theme, fonts, shared styles
tailwind.config.ts # Linked from globals via @config
components/
ui/ # Copy-ready UI primitives (+ *-usage.tsx)
icons.tsx # Icon registry (name, SVG, JSX)
catalog.tsx # Catalog grid + search + filter
lib/
components.ts # Component registry (slug, name, paths)
load-code.ts # Loads source for Preview / Code / UsageUsing components
Browse the Components catalog. Each detail page has Preview, Code, and Usage tabs.
import Button from "@/components/ui/button"
export default function Example() {
return <Button href="/components">Explore components</Button>
}Component catalog
Entries live in lib/components.ts — slug, name, and paths for source + usage. Homepage previews and the catalog grid both read from this list.
{
slug: "button-simple",
name: "Button Simple",
codePath: "components/ui/button.tsx",
usagePath: "components/ui/button-usage.tsx",
}Adding components
- 1
Create the primitive
Add
components/ui/your-component.tsx. - 2
Add a usage demo
Pair it with
components/ui/your-component-usage.tsx. - 3
Register it
Extend
lib/components.tswithslug,name,codePath, andusagePath. - 4
Wire the preview switch
Update
components/previews.tsxsoCardPreview/DocPreviewstay exhaustive forComponentSlug.
Icons
Icons live in components/icons.tsx with name, rendered node, raw svg, and jsx. The Icons page searches that list and offers copy actions.
{
name: "filter-horizontal-2",
renderedicon: (
<svg viewBox="0 0 24 24" /* … */ />
),
svg: `<svg xmlns="http://www.w3.org/2000/svg" …>`,
jsx: `<svg xmlns="http://www.w3.org/2000/svg" …>`,
}Theming
Light and dark mode use a dark class on <html>. The root layout reads a theme cookie so the first paint matches preference. The header toggle also writes localStorage.theme.
document.documentElement.classList.toggle("dark", next)
localStorage.setItem("theme", theme)
document.cookie = `theme=${theme}; path=/; max-age=31536000; samesite=lax`@config "../tailwind.config.ts";
@import "tailwindcss";
@custom-variant dark (&:where(.dark, .dark *));
@theme {
--color-charcoal: #1b1b1e;
--color-drk-charcoal: #171719;
--color-neon: #afff00;
--color-neon-blue: #4d4dff;
--color-teal: #30c1a5;
--color-vanilla: #faf9f3;
}Use utilities like bg-charcoal, text-neon-blue, and bg-vanilla. Dark mode still uses the dark: variant.
Styling & fonts
Global styles and font faces live in app/globals.css.
Regular
TASA Orbiter Regular
Body
TASA Orbiter Medium
font-tasa-medium
Headers
TASA Orbiter Medium
font-tasa-medium
License
Released under the MIT License. © 2026 Gradient AI. See also Privacy.