Skip to content

NarixHine/uni-chem / .agents/skills/heroui-react

heroui-react

Flagged

HeroUI 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.

FileKindSize
LICENSE.txtmarkdown11.0 KB
SKILL.mdskill md6.4 KB
scripts/get_component_docs.mjsscript4.2 KB
scripts/get_docs.mjsscript4.2 KB
scripts/get_source.mjsscript4.4 KB
scripts/get_styles.mjsscript4.4 KB
scripts/get_theme.mjsscript5.4 KB
scripts/list_components.mjsscript3.9 KB

scripts/get_styles.mjs

View on GitHub
#!/usr/bin/env node
/**
 * Get CSS styles (BEM classes) for HeroUI v3 components.
 *
 * Usage:
 *   node get_styles.mjs Button
 *   node get_styles.mjs Button Card Chip
 *
 * Output:
 *   CSS file content with BEM classes and GitHub URL for each component
 */

const API_BASE = process.env.HEROUI_API_BASE || 'https://mcp-api.heroui.com'
const GITHUB_RAW_BASE = 'https://raw.githubusercontent.com/heroui-inc/heroui/refs/heads/v3'
const APP_PARAM = 'app=react-skills'

/**
 * Fetch data from HeroUI API with app parameter for analytics.
 */
async function fetchApi(endpoint, method = 'GET', body = null) {
    const separator = endpoint.includes('?') ? '&' : '?'
    const url = `${API_BASE}${endpoint}${separator}${APP_PARAM}`

    try {
        const options = {
            headers: {
                'Content-Type': 'application/json',
                'User-Agent': 'HeroUI-Skill/1.0',
            },
            method,
            signal: AbortSignal.timeout(30000),
        }

        if (body) {
            options.body = JSON.stringify(body)
        }

        const response = await fetch(url, options)

        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
    }
}

/**
 * Fetch CSS styles directly from GitHub as fallback.
 */
async function fetchGithubFallback(component) {
    // Try common patterns for style paths
    const patterns = [
        `packages/styles/src/components/${component.toLowerCase()}.css`,
        `packages/styles/components/${component.toLowerCase()}.css`,
    ]

    for (const path of patterns) {
        const url = `${GITHUB_RAW_BASE}/${path}`

        try {
            const response = await fetch(url, {
                headers: { 'User-Agent': 'HeroUI-Skill/1.0' },
                signal: AbortSignal.timeout(30000),
            })

            if (response.ok) {
                const content = await response.text()

                return {
                    component,
                    filePath: path,
                    githubUrl: `https://github.com/heroui-inc/heroui/blob/v3/${path}`,
                    source: 'fallback',
                    stylesCode: content,
                }
            }
        } catch {
            continue
        }
    }

    return { component, error: `Failed to fetch styles for ${component}` }
}

/**
 * Main function to get CSS styles for specified components.
 */
async function main() {
    const args = process.argv.slice(2)

    if (args.length === 0) {
        console.error('Usage: node get_styles.mjs <Component1> [Component2] ...')
        console.error('Example: node get_styles.mjs Button Card')
        process.exit(1)
    }

    const components = args

    // Try API first
    console.error(`# Fetching styles for: ${components.join(', ')}...`)
    const data = await fetchApi('/v1/components/styles', 'POST', { components })

    if (data && data.results) {
        for (const result of data.results) {
            result.source = 'api'
        }

        // Output results
        if (data.results.length === 1) {
            const result = data.results[0]

            if (result.stylesCode) {
                console.log(`/* File: ${result.filePath || 'unknown'} */`)
                console.log(`/* GitHub: ${result.githubUrl || 'unknown'} */`)
                console.log()
                console.log(result.stylesCode)
            } else {
                console.log(JSON.stringify(result, null, 2))
            }
        } else {
            console.log(JSON.stringify(data, null, 2))
        }

        return
    }

    // Fallback to GitHub direct fetch
    console.error('# API failed, using GitHub fallback...')
    const results = []

    for (const component of components) {
        const result = await fetchGithubFallback(component)

        results.push(result)
    }

    if (results.length === 1) {
        const result = results[0]

        if (result.stylesCode) {
            console.log(`/* File: ${result.filePath || 'unknown'} */`)
            console.log(`/* GitHub: ${result.githubUrl || 'unknown'} */`)
            console.log()
            console.log(result.stylesCode)
        } else {
            console.log(JSON.stringify(result, null, 2))
        }
    } else {
        console.log(JSON.stringify({ results }, null, 2))
    }
}

main()
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: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall