NarixHine/uni-chem / .agents/skills/heroui-react
heroui-react
FlaggedHeroUI v3 React component library (Tailwind CSS v4 + React Aria). Use when building UIs with HeroUI — creating Buttons, Modals, Forms, Cards; installing @heroui/react; configuring dark/light themes with oklch variables; or fetching component docs. Keywords: HeroUI, Hero UI, heroui, @heroui/react, @heroui/styles.
| File | Kind | Size |
|---|---|---|
| LICENSE.txt | markdown | 11.0 KB |
| SKILL.md | skill md | 6.4 KB |
| scripts/get_component_docs.mjs | script | 4.2 KB |
| scripts/get_docs.mjs | script | 4.2 KB |
| scripts/get_source.mjs | script | 4.4 KB |
| scripts/get_styles.mjs | script | 4.4 KB |
| scripts/get_theme.mjs | script | 5.4 KB |
| scripts/list_components.mjs | script | 3.9 KB |
scripts/get_theme.mjs
View on GitHub#!/usr/bin/env node
/**
* Get theme variables and design tokens for HeroUI v3.
*
* Usage:
* node get_theme.mjs
*
* Output:
* Theme variables organized by common/light/dark with oklch color format
*/
const API_BASE = process.env.HEROUI_API_BASE || 'https://mcp-api.heroui.com'
const APP_PARAM = 'app=react-skills'
// Fallback theme reference when API is unavailable
const FALLBACK_THEME = {
common: {
base: [
{ name: '--font-sans', value: 'ui-sans-serif, system-ui, sans-serif' },
{ name: '--font-mono', value: 'ui-monospace, monospace' },
{ name: '--radius-sm', value: '0.375rem' },
{ name: '--radius-md', value: '0.5rem' },
{ name: '--radius-lg', value: '0.75rem' },
{ name: '--radius-full', value: '9999px' },
],
calculated: [{ name: '--spacing-unit', value: '0.25rem' }],
},
dark: {
semantic: [
{ name: '--color-background', value: 'oklch(14.5% 0 0)' },
{ name: '--color-foreground', value: 'oklch(98.4% 0 0)' },
{ name: '--color-accent', value: 'oklch(55.1% 0.228 264.1)' },
{ name: '--color-danger', value: 'oklch(63.7% 0.237 25.3)' },
{ name: '--color-success', value: 'oklch(76.5% 0.177 163.2)' },
{ name: '--color-warning', value: 'oklch(79.5% 0.184 86.0)' },
],
},
latestVersion: '3.0.0-beta',
light: {
semantic: [
{ name: '--color-background', value: 'oklch(100% 0 0)' },
{ name: '--color-foreground', value: 'oklch(14.5% 0 0)' },
{ name: '--color-accent', value: 'oklch(55.1% 0.228 264.1)' },
{ name: '--color-danger', value: 'oklch(63.7% 0.237 25.3)' },
{ name: '--color-success', value: 'oklch(76.5% 0.177 163.2)' },
{ name: '--color-warning', value: 'oklch(79.5% 0.184 86.0)' },
],
},
note: 'This is a fallback. For complete theme variables, ensure the API is accessible.',
source: 'fallback',
theme: 'default',
}
/**
* Fetch data from HeroUI API with app parameter for analytics.
*/
async function fetchApi(endpoint) {
const separator = endpoint.includes('?') ? '&' : '?'
const url = `${API_BASE}${endpoint}${separator}${APP_PARAM}`
try {
const response = await fetch(url, {
headers: { 'User-Agent': 'HeroUI-Skill/1.0' },
signal: AbortSignal.timeout(30000),
})
if (!response.ok) {
console.error(`# API Error: HTTP ${response.status}`)
return null
}
return await response.json()
} catch (error) {
console.error(`# API Error: ${error.message}`)
return null
}
}
/**
* Format theme variables for display.
*/
function formatVariables(variables) {
const lines = []
for (const variable of variables) {
const name = variable.name || ''
const value = variable.value || ''
const desc = variable.description || ''
if (desc) {
lines.push(` ${name}: ${value}; /* ${desc} */`)
} else {
lines.push(` ${name}: ${value};`)
}
}
return lines.join('\n')
}
/**
* Main function to get theme variables.
*/
async function main() {
console.error('# Fetching theme variables...')
const rawData = await fetchApi('/v1/themes/variables?theme=default')
let data
let version
if (!rawData) {
console.error('# API failed, using fallback theme reference...')
data = FALLBACK_THEME
version = FALLBACK_THEME.latestVersion || 'unknown'
} else {
// Handle API response format: { themes: [...], latestVersion: "..." }
if (rawData.themes && rawData.themes.length > 0) {
data = rawData.themes[0] // Get first theme (default)
version = rawData.latestVersion || rawData.version || 'unknown'
} else {
// Direct format
data = rawData
version = rawData.latestVersion || 'unknown'
}
}
// Output as formatted CSS-like structure for readability
console.log('/* HeroUI v3 Theme Variables */')
console.log(`/* Theme: ${data.theme || 'default'} */`)
console.log(`/* Version: ${version} */`)
console.log()
// Common variables
if (data.common) {
console.log(':root {')
console.log(' /* Base Variables */')
if (data.common.base) {
console.log(formatVariables(data.common.base))
}
console.log()
console.log(' /* Calculated Variables */')
if (data.common.calculated) {
console.log(formatVariables(data.common.calculated))
}
console.log('}')
console.log()
}
// Light mode
if (data.light) {
console.log(":root, [data-theme='light'] {")
console.log(' /* Light Mode Semantic Variables */')
if (data.light.semantic) {
console.log(formatVariables(data.light.semantic))
}
console.log('}')
console.log()
}
// Dark mode
if (data.dark) {
console.log("[data-theme='dark'] {")
console.log(' /* Dark Mode Semantic Variables */')
if (data.dark.semantic) {
console.log(formatVariables(data.dark.semantic))
}
console.log('}')
}
// Also output raw JSON to stderr for programmatic use
console.error('\n# Raw JSON output:')
console.error(JSON.stringify(rawData || data, null, 2))
}
main()
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |