Skip to content

fcakyon/claude-codex-settings / plugins/heroui-skills/skills/heroui-react

heroui-react

Verified

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.8 KB
scripts/get_component_docs.mjsscript3.9 KB
scripts/get_docs.mjsscript3.9 KB
scripts/get_source.mjsscript4.0 KB
scripts/get_styles.mjsscript4.0 KB
scripts/get_theme.mjsscript4.9 KB
scripts/list_components.mjsscript3.5 KB

scripts/list_components.mjs

View on GitHub
#!/usr/bin/env node
/**
 * List all available HeroUI v3 components.
 *
 * Usage:
 *   node list_components.mjs
 *
 * Output:
 *   JSON with components array, latestVersion, and count
 */

const API_BASE = process.env.HEROUI_API_BASE || "https://mcp-api.heroui.com";
const APP_PARAM = "app=react-skills";
const LLMS_TXT_URL = "https://heroui.com/react/llms.txt";

/**
 * 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(`HTTP Error ${response.status}: ${response.statusText}`);

      return null;
    }

    return await response.json();
  } catch (error) {
    console.error(`API Error: ${error.message}`);

    return null;
  }
}

/**
 * Fetch component list from llms.txt fallback URL.
 */
async function fetchFallback() {
  try {
    const response = await fetch(LLMS_TXT_URL, {
      headers: {"User-Agent": "HeroUI-Skill/1.0"},
      signal: AbortSignal.timeout(30000),
    });

    if (!response.ok) {
      return null;
    }

    const content = await response.text();

    // Parse markdown to extract component names from pattern: - [ComponentName](url)
    // Look for links under the Components section (### Components)
    const components = [];
    let inComponentsSection = false;

    for (const line of content.split("\n")) {
      // Check if we're entering the Components section (uses ### header)
      if (line.trim() === "### Components") {
        inComponentsSection = true;
        continue;
      }

      // Check if we're leaving the Components section (another ### header)
      if (inComponentsSection && line.trim().startsWith("### ")) {
        break;
      }

      // Extract component name from markdown link pattern
      // Match: - [ComponentName](https://www.heroui.com/docs/react/components/component-name)
      // Skip "All Components" which links to /components without a specific component
      if (inComponentsSection) {
        const match = line.match(
          /^\s*-\s*\[([^\]]+)\]\(https:\/\/www\.heroui\.com\/docs\/react\/components\/[a-z]/,
        );

        if (match) {
          components.push(match[1]);
        }
      }
    }

    if (components.length > 0) {
      console.error(`# Using fallback: ${LLMS_TXT_URL}`);

      return {
        components: components.sort(),
        count: components.length,
        latestVersion: "unknown",
      };
    }

    return null;
  } catch (error) {
    console.error(`Fallback Error: ${error.message}`);

    return null;
  }
}

/**
 * Main function to list all available HeroUI v3 components.
 */
async function main() {
  let data = await fetchApi("/v1/components");

  // Check if API returned valid data with components
  if (!data || !data.components || data.components.length === 0) {
    console.error("# API returned no components, trying fallback...");
    data = await fetchFallback();
  }

  if (!data || !data.components || data.components.length === 0) {
    console.error("Error: Failed to fetch component list from API and fallback");
    process.exit(1);
  }

  // Output formatted JSON
  console.log(JSON.stringify(data, null, 2));

  // Print summary to stderr for human readability
  console.error(
    `\n# Found ${data.components.length} components (${data.latestVersion || "unknown"})`,
  );
}

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: 319kUpdated 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: 196kUpdated 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: 196kUpdated 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: 196kUpdated Claude CodeCodexVerifiedInstall