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/get_docs.mjs

View on GitHub
#!/usr/bin/env node
/**
 * Get non-component HeroUI documentation (guides, theming, releases).
 *
 * Usage:
 *   node get_docs.mjs /docs/react/getting-started/theming
 *   node get_docs.mjs /docs/react/releases/v3-0-0-beta-3
 *
 * Output:
 *   MDX documentation content
 *
 * Note: For component docs, use get_component_docs.mjs instead.
 */

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

/**
 * Fetch documentation from HeroUI API.
 * Uses v1 endpoint pattern: /v1/docs/:path
 */
async function fetchApi(path) {
  // The v1 API expects path without /docs/ prefix
  // Input: /docs/react/getting-started/theming
  // API expects: react/getting-started/theming (route is /v1/docs/:path(*))
  let apiPath = path.startsWith("/docs/")
    ? path.slice(6) // Remove /docs/ prefix
    : path.startsWith("/")
      ? path.slice(1) // Remove leading /
      : path;

  const separator = "?";
  const url = `${API_BASE}/v1/docs/${apiPath}${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;
  }
}

/**
 * Fetch MDX directly from v3.heroui.com as fallback.
 */
async function fetchFallback(path) {
  // Ensure path starts with /docs and ends with .mdx
  let cleanPath = path.replace(/^\//, "");

  if (!cleanPath.endsWith(".mdx")) {
    cleanPath = `${cleanPath}.mdx`;
  }

  const url = `${FALLBACK_BASE}/${cleanPath}`;

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

    if (!response.ok) {
      return {error: `HTTP ${response.status}: ${response.statusText}`, path};
    }

    const content = await response.text();

    return {
      content,
      contentType: "mdx",
      path,
      source: "fallback",
      url,
    };
  } catch (error) {
    return {error: `Fetch Error: ${error.message}`, path};
  }
}

/**
 * Main function to get documentation for specified path.
 */
async function main() {
  const args = process.argv.slice(2);

  if (args.length === 0) {
    console.error("Usage: node get_docs.mjs <path>");
    console.error("Example: node get_docs.mjs /docs/react/getting-started/theming");
    console.error();
    console.error("Available paths include:");
    console.error("  /docs/react/getting-started/theming");
    console.error("  /docs/react/getting-started/colors");
    console.error("  /docs/react/getting-started/animations");
    console.error("  /docs/react/releases/v3-0-0-beta-3");
    console.error();
    console.error("Note: For component docs, use get_component_docs.mjs instead.");
    process.exit(1);
  }

  const path = args[0];

  // Check if user is trying to get component docs
  if (path.includes("/components/")) {
    console.error("# Warning: Use get_component_docs.mjs for component documentation.");
    const componentName = path.split("/").pop().replace(".mdx", "");
    const titleCase = componentName.charAt(0).toUpperCase() + componentName.slice(1);

    console.error(`# Example: node get_component_docs.mjs ${titleCase}`);
  }

  console.error(`# Fetching documentation for ${path}...`);

  // Try API first
  const data = await fetchApi(path);

  if (data && data.content) {
    data.source = "api";
    console.log(data.content);

    return;
  }

  // Fallback to direct fetch
  console.error("# API failed, using fallback...");
  const fallbackData = await fetchFallback(path);

  if (fallbackData.content) {
    console.log(fallbackData.content);
  } else {
    console.log(JSON.stringify(fallbackData, null, 2));
    process.exit(1);
  }
}

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