---
name: honest-ui
description: Add and customize Honest UI components, charts, icons, assets, and shaders in React projects.
license: MIT
compatibility: Requires a React or Next.js project with Tailwind CSS.
metadata:
  source: https://www.honestui.com/llms.txt
---

# Honest UI

## When to use this skill

Use this skill when a task involves Honest UI in a React project, specifically when the user wants to:

- Install Honest UI and choose between copied component source and package-backed collections.
- Add a specific component, chart, icon, logo, vector, animated component, or shader to a page or route.
- Customize or restyle an installed component while keeping its accessibility behavior.
- Debug an installed Honest UI component that renders incorrectly or fails verification.
- Decide whether the CLI, the npm package, the REST API, or the MCP server is the right integration surface for a task.

Do not use this skill as generic React styling guidance; it documents Honest UI's own components, tokens, and delivery models.

## Workflow

1. Read `/llms.txt` to find the relevant documentation page.
2. Read `/docs/get-started.md` before choosing an installation path.
3. Copy UI and animated component source with the Honest UI CLI.
4. Install the `honestui` package for charts, icons, logos, vectors, or shaders.
5. Follow the relevant accessibility, styling, fallback, and verification guidance before presenting the work as production-ready.

To call Honest UI from code instead of installing it, start at `https://www.honestui.com/api/v1` (REST) or `https://www.honestui.com/mcp` (MCP over Streamable HTTP). Both are public and read-only; no credential is required.

## Constraints

- Do not describe every Honest UI feature as copied source. Charts, icons, logos, vectors, and shaders remain package dependencies.
- Do not describe a component as accessible without verifying its final content, composition, styling, and behavior in the application.
- Preserve the project's existing React and Tailwind CSS setup unless the user explicitly asks to change it.
- Treat Apache ECharts as the underlying chart dependency.
- Import each package-backed feature from its documented entry point.
- Keep reduced-motion behavior and non-WebGL fallbacks when using animated components or shaders.