# GwenUI

> A full-page block library for Next.js. 
> OKLCH-first design tokens, Framer Motion animations, 
> and WebGL-powered Supreme blocks via React Three Fiber.
> Built and maintained by JinXSuper.

## Getting Started
- [Introduction](https://gwenui.com/docs/getting-started/introduction)
- [Installation](https://gwenui.com/docs/getting-started/installation)
- [Quick Start](https://gwenui.com/docs/getting-started/quick-start)

## CLI
- [Overview](https://gwenui.com/docs/cli/overview)
- [init](https://gwenui.com/docs/cli/init)
- [add](https://gwenui.com/docs/cli/add)
- [Global Config](https://gwenui.com/docs/cli/global-config)

## Theming
- [Design Tokens](https://gwenui.com/docs/theming/design-tokens)
- [OKLCH Colors](https://gwenui.com/docs/theming/oklch-colors)
- [Custom Fonts](https://gwenui.com/docs/theming/custom-fonts)

## Blocks
- [Overview](https://gwenui.com/docs/blocks/overview)
- [Auth — Login](https://gwenui.com/docs/blocks/auth-login)

## Supreme Blocks (WebGL/R3F)
- [Overview](https://gwenui.com/docs/supreme/overview)
- [Parallax Hero](https://gwenui.com/docs/supreme/parallax-hero)

## Packages
- [@gwenui/themes](https://gwenui.com/docs/packages/themes) — OKLCH design tokens + self-hosted fonts
- [@gwenui/react](https://gwenui.com/docs/packages/react) — 2D blocks with Framer Motion
- [@gwenui/supreme](https://gwenui.com/docs/packages/supreme) — 3D blocks with R3F + OGL
- [@gwenui/cli](https://gwenui.com/docs/packages/cli) — TUI installer

## Design Language
- Primary color: oklch(68% 0.18 48) — Gwen Orange
- Background: oklch(10% 0.005 265) — Midnight Zinc
- Font: Plus Jakarta Sans
- Motion: Framer Motion (spring-based, orchestrated)
- 3D: React Three Fiber, OGL, GLSL shaders

## CLI Usage
- Install: `npm install -g @gwenui/cli`
- Init: `gwenui init`
- Add block: `gwenui add auth-login`
- View block: `gwenui view auth-login`
- List blocks: `gwenui list`
- Project info: `gwenui info`

## License
- Basic blocks: MIT
- Supreme blocks: BSL 1.1
- CLI: MIT

## Links
- Docs: https://gwenui.com/docs
- GitHub: https://github.com/jinxsuper/gwenui
- npm: https://npmjs.com/org/gwenui