Docs

Introduction

Next.jsReact 19Tailwind v4MIT

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.

bash
$ git clone https://github.com/gradientaistudio/ui.git$ cd ui$ npm install$ npm run dev

Open 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

tree
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 / Usage

Using components

Browse the Components catalog. Each detail page has Preview, Code, and Usage tabs.

example.tsx
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.

lib/components.ts
{
  slug: "button-simple",
  name: "Button Simple",
  codePath: "components/ui/button.tsx",
  usagePath: "components/ui/button-usage.tsx",
}

Adding components

  1. 1

    Create the primitive

    Add components/ui/your-component.tsx.

  2. 2

    Add a usage demo

    Pair it with components/ui/your-component-usage.tsx.

  3. 3

    Register it

    Extend lib/components.ts with slug, name, codePath, and usagePath.

  4. 4

    Wire the preview switch

    Update components/previews.tsx so CardPreview / DocPreview stay exhaustive for ComponentSlug.

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.

components/icons.tsx
{
  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.

theme-toggle.ts
document.documentElement.classList.toggle("dark", next)
localStorage.setItem("theme", theme)
document.cookie = `theme=${theme}; path=/; max-age=31536000; samesite=lax`
app/globals.css
@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.