Getting Started

Setup Guide

Getting Started

Choose your framework, install packages with your preferred package manager, import tokens, and ship your first screen in minutes.

Install

Add `@glinui/ui` and `@glinui/tokens`.

Import Tokens

Load `theme.css` once at app entry.

Ship Components

Compose atoms and primitives fast.

Base Install

pnpm add @glinui/ui @glinui/tokens

Registry Workflow

Prefer file ownership instead of package imports? Use the Glin CLI registry flow to copy component source into your app and customize directly.

Add from Registry

Copies component files into your project.

pnpm dlx @glinui/cli@latest add button
pnpm dlx @glinui/cli@latest add data-table

Ownership Pattern

Source is local, so edits are yours.

Shell
1# Adds source files directly to your app
2pnpm dlx @glinui/cli@latest add button
3
4# Example result:
5# components/ui/button.tsx
6# lib/utils.ts

Framework Setup

Next.js

App Router with full Glin UI component support

1. Create project

pnpm create next-app@latest my-app -- --ts --tailwind --eslint --app

2. Install packages

pnpm add @glinui/ui @glinui/tokens

3. Import tokens

CSS
1/* app/globals.css */
2@import "@glinui/tokens/theme.css";

4. Render your first UI

TSX
1// app/page.tsx
2import { Button } from "@glinui/ui"
3
4export default function Page() {
5 return (
6 <main className="p-10">
7 <Button variant="glass">Ship it</Button>
8 </main>
9 )
10}

5. Start development server

pnpm dev

Recommended for production apps using the full React component library.

Sanity Checklist

  • Tokens are imported once at the app root (`theme.css`).
  • First component renders without custom CSS overrides.
  • Package-manager command tabs match your local tooling.
Browse ComponentsRead Token GuideForms AccessibilityAccessibility HubForm RecipesScreen Reader TestingFocus ManagementColor ContrastAPI Metadata