Custom Repositories

Extend HAX with custom component repositories to share artifacts, composers, and UI components across teams and organizations.

Overview

• Share components internally across teams and projects
• Create private component libraries for your organization
• Fork and customize existing HAX components
• Distribute specialized components for specific domains
• Maintain version control over component updates

Repository Structure

your-hax-repo/
├── cli/src/registry/github-registry/
│   ├── artifacts.json
│   ├── ui.json
│   └── composers.json
├── hax/
│   ├── artifacts/
│   ├── components/ui/
│   └── composers/
├── templates/
└── docs/

Setting Up a Custom Repository

# Initialize a new HAX registry repository
hax admin init-registry --github=your-org/your-hax-components

# Or initialize locally and push manually
mkdir my-hax-components
cd my-hax-components
hax admin init-registry --local

Validate Registry

hax admin validate-registry