{"id":49256578,"url":"https://github.com/oscarabcorona/hex-core","last_synced_at":"2026-05-07T23:25:09.006Z","repository":{"id":351898375,"uuid":"1212707558","full_name":"oscarabcorona/hex-core","owner":"oscarabcorona","description":"AI-native component library for LLMs and humans.","archived":false,"fork":false,"pushed_at":"2026-05-05T15:34:43.000Z","size":8676,"stargazers_count":1,"open_issues_count":15,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-05T17:30:57.023Z","etag":null,"topics":["ai-components","ai-native","component-library","mcp","radix-ui","react","shadcn-alternative","tailwindcss"],"latest_commit_sha":null,"homepage":"https://hex-core.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oscarabcorona.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-16T16:44:28.000Z","updated_at":"2026-05-05T15:32:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/oscarabcorona/hex-core","commit_stats":null,"previous_names":["oscarabcorona/hex-ui","oscarabcorona/hex-core"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/oscarabcorona/hex-core","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscarabcorona%2Fhex-core","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscarabcorona%2Fhex-core/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscarabcorona%2Fhex-core/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscarabcorona%2Fhex-core/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oscarabcorona","download_url":"https://codeload.github.com/oscarabcorona/hex-core/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oscarabcorona%2Fhex-core/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32671179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-05T11:29:49.557Z","status":"ssl_error","status_checked_at":"2026-05-05T11:29:48.587Z","response_time":54,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-components","ai-native","component-library","mcp","radix-ui","react","shadcn-alternative","tailwindcss"],"created_at":"2026-04-25T04:07:09.553Z","updated_at":"2026-05-07T23:25:09.000Z","avatar_url":"https://github.com/oscarabcorona.png","language":"TypeScript","funding_links":["https://github.com/sponsors/oscarabcorona"],"categories":[],"sub_categories":[],"readme":"# Hex Core\n\n[![CI](https://github.com/oscarabcorona/hex-core/actions/workflows/ci.yml/badge.svg)](https://github.com/oscarabcorona/hex-core/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/@hex-core/components.svg?label=%40hex-core%2Fcomponents)](https://www.npmjs.com/package/@hex-core/components)\n[![downloads](https://img.shields.io/npm/dm/@hex-core/components.svg)](https://www.npmjs.com/package/@hex-core/components)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Sponsor](https://img.shields.io/github/sponsors/oscarabcorona?label=Sponsor\u0026logo=GitHub)](https://github.com/sponsors/oscarabcorona)\n\n**The component layer for spec-driven UI development.**\n\nHex Core turns a brief (or a `spec.md` / `plan.md` section) into a ranked component checklist over MCP. No server, no runtime — just static JSON and 12 MCP tools over a catalog of 83 components.\n\n## Why Hex Core?\n\nshadcn/ui is built for humans browsing docs. Hex Core is built for **AI agents** that need:\n\n- **Machine-readable component specs** — Zod schemas with props, variants, slots, and constraints\n- **AI hints** — `whenToUse`, `whenNotToUse`, `commonMistakes`, `accessibilityNotes` per component\n- **Recipes** — six spec-driven blueprints (auth form, settings page, pricing table, data table, confirm-destructive, command palette) with ordered install steps and post-install checklists\n- **MCP server** — 12 tools for component discovery, installation, theming, scaffolding, spec resolution, and emitting paste-into-LLM app context\n- **Token budgets** — each component declares its token cost for efficient LLM context usage\n\n\u003e [!WARNING]\n\u003e **Use the scoped package names.** The npm packages are `@hex-core/cli` and `@hex-core/mcp`. An unrelated `hex-core` package is published on npm by a different author — `npx hex-core …` will fail with `npm error could not determine executable to run`. Always include the `@hex-core/` scope in install commands.\n\n## Quick Start\n\n### For AI (MCP)\n\nAdd to your Claude Code settings (`.claude/settings.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"hex-core\": {\n      \"command\": \"npx\",\n      \"args\": [\"@hex-core/mcp\"]\n    }\n  }\n}\n```\n\nThen ask Claude: *\"Search hex-core for a button component and add it to my project\"*\n\n### For Humans (CLI)\n\n```bash\nnpx @hex-core/cli init                    # detects Tailwind v3 vs v4, scaffolds globals.css, auto-installs peer deps\nnpx @hex-core/cli add button input label  # writes components, auto-installs Radix peers, rewrites imports to your @/ alias\nnpx @hex-core/cli doctor                  # diagnose what's missing if anything breaks\n```\n\n## Packages\n\n| Package | Description |\n|---------|-------------|\n| `@hex-core/registry` | Zod schemas and types for the component registry |\n| `@hex-core/tokens` | Design token engine with 3 themes |\n| `@hex-core/components` | Component source code (React + Tailwind) |\n| `@hex-core/motion` | UI animation primitives + deterministic timeline composer (zero-dep WAAPI core, optional `motion@^11` adapter) |\n| `@hex-core/mcp` | MCP server for AI-native distribution |\n| `@hex-core/cli` | CLI for human developers |\n\n## MCP Tools\n\n| Tool | Purpose |\n|------|---------|\n| `search_components` | Discover components by query, category, or tags |\n| `get_component` | Get full source code + metadata for installation |\n| `get_component_schema` | Get props/variants/AI hints (token-efficient) |\n| `get_theme` | Get theme in CSS, JSON, or Tailwind format |\n| `list_themes` | List available themes |\n| `scaffold_project` | Generate complete project setup |\n| `customize_component` | Apply CSS overrides to components |\n| `list_recipes` | Catalog of spec-driven blueprints |\n| `get_recipe` | Ordered install steps + post-install checklist |\n| `resolve_spec` | Deterministic brief → ranked component + recipe shortlist |\n| `verify_checklist` | Cross-check installed components against the internal-dep graph |\n| `emit_app_context` | Synthesize a paste-into-LLM markdown payload of theme + installed components |\n\nSee **[hex-core.dev/docs/spec-driven](https://hex-core.dev/docs/spec-driven)** for the full spec-driven workflow.\n\n## Spec-driven example\n\n```bash\n# 1. Discover recipes\nnpx @hex-core/cli recipe list\n\n# 2. Install every component in a recipe + print its checklist\nnpx @hex-core/cli recipe add settings-page\n```\n\nOr from an MCP client: ask *\"Resolve this spec into hex-core components: build a settings page with notifications toggle\"* — `resolve_spec` returns the `settings-page` recipe and a ranked component shortlist.\n\n## Skills (for Claude Code)\n\nHex Core ships nine prose context packs in `SKILL.md` format — overview, MCP tools decision tree, recipes workflow, theming, CLI, a11y, anti-patterns, registry authoring, motion. Install in one command:\n\n```bash\nnpx @hex-core/cli skills install\n```\n\nThis copies the skills into `.claude/skills/` so any agent working in your repo loads them via trigger keywords on demand. See **[hex-core.dev/docs/skills](https://hex-core.dev/docs/skills)**.\n\n## Themes\n\n- **Default** — Refined, neutral. Professional and versatile.\n- **Midnight** — Dark-first with deep blues. Built for developer tools.\n- **Ember** — Warm terracotta and amber. For creative applications.\n\n## Components\n\n**117 registry items** across primitives (Button, Input, Checkbox, Switch, Slider, …), compounds (Combobox, DataTable, Command, Calendar, Date Picker, …), AI-native (Composer, Message, Reasoning, ToolCall, Terminal, Canvas, Diagram, AudioPlayer, AudioWaveform, SpeechRecognition, …), 23 artifact diagrams (sankey, mindmap, gantt, …), and 11 motion primitives (Motion factory, Presence, Timeline composer, useAnimate, useScroll, …). Every item ships with a machine-readable `.schema.ts` containing props, variants, AI hints (`whenToUse`, `whenNotToUse`, `commonMistakes`, `accessibilityNotes`), and a token budget.\n\nFull catalog + live demos: **[hex-core.dev/docs](https://hex-core.dev/docs)**\n\n## Development\n\n```bash\npnpm install\npnpm build\npnpm run build:registry\n```\n\n## Architecture\n\n```\nhex-core/\n├── packages/\n│   ├── registry/       # Zod schemas + types\n│   ├── tokens/         # Design token engine\n│   ├── components/     # React component source\n│   ├── mcp-server/     # MCP server\n│   └── cli/            # CLI tool\n├── registry/           # Built registry JSON\n└── scripts/            # Build scripts\n```\n\nEach component has two files:\n- `{name}.tsx` — React component (Radix UI + Tailwind + CVA)\n- `{name}.schema.ts` — Machine-readable spec with props, variants, AI hints\n\n## Releases\n\nFeature branch → PR → `main` → `/release` skill. CI on `main` runs `Lint` / `Build` / `Test` (~2 min). Slow regression checks (a11y axe-scan + Playwright visual diffs) run locally via `pnpm regression` as a pre-release gate; see [CONTRIBUTING.md](CONTRIBUTING.md#releasing).\n\n## Sponsor\n\nIf hex-core saves you time, consider [sponsoring development on GitHub](https://github.com/sponsors/oscarabcorona).\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foscarabcorona%2Fhex-core","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foscarabcorona%2Fhex-core","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foscarabcorona%2Fhex-core/lists"}