comp-hub

CLI for comp-hub — a component sharing platform supporting Vue and React. Start a local dev server to preview, manage, and share components.

Languages: Full docs are also available in 简体中文 · 繁體中文 on our documentation site.

Website: https://www.comphub.cn  ·  Docs: https://docs.comphub.cn

Requirements

• Node.js >= 16.0.0
• npm >= 8.0.0

Installation

Global (recommended)

npm install comp-hub@latest -g

Local

npm install comp-hub@latest -D

Quick Start

Run in your project directory:

comphub

Once started, open the URL shown in the terminal (default http://localhost:5478).

Without installing — npx fetches the CLI on demand:

npx comp-hub

The CLI is published with three binary names — comphub, ch and comp-hub — all identical. Every command below works with any of them, e.g. ch status, comp-hub -p 8080.

CLI Options

comphub [options]

| Option | Alias | Type | Default | Description | |--------|-------|------|---------|-------------| | --port | -p | number | 5478 | Server port | | --dir | -d | path | "./" | Component directory | | --version | -v | — | — | Show version | | --help | -h | — | — | Show help |

Examples:

comphub -p 8080          # Custom port
comphub -d ./src         # Custom component directory

Management Commands

| Command | Description | |---------|-------------| | comphub | Start dev server | | comphub status | List all running projects | | comphub stop <hash> | Stop a specific project | | comphub stop --all | Stop all projects | | comphub kill | Shut down all services |

Examples:

# Check running projects
comphub status

# Stop a specific project
comphub stop 94525912

# Stop all projects
comphub stop --all

# Shut down everything
comphub kill

Multi-Project

Run multiple projects simultaneously on separate ports:

cd /path/to/project-a && comphub
cd /path/to/project-b && comphub
comphub status             # List all

Configuration

Create .comphub.json or .comphub.js in your project root:

{
  "dir": "./src",
  "allowDebug": false
}

module.exports = {
  dir: './src',
  allowDebug: false
}

| Option | Type | Default | Description | |--------|------|---------|-------------| | dir | string | "./" | Component root directory | | allowDebug | boolean | false | Enable debug mode | | proxy | object | — | Custom proxy rules |

Priority: CLI flags > config file > defaults

Component Specs

• Upload components as folders — folder name is the component name
• Entry point: index.vue (Vue) or index.jsx/index.tsx (React)
• Include a README.md describing usage
• comp.json is generated by the platform and holds only __id__, name and version — dependencies are detected from your source import statements, not declared here
• Optional demo/ directory for preview configs

Links

• Website: https://www.comphub.cn
• Docs (English · 简体中文 · 繁體中文): https://docs.comphub.cn

License

MIT