HyperPack CLI

Modern frontend build tool and dev server with esbuild, HMR, and plugin API.

Features

• Fast Build — Powered by esbuild with native ESM
• Sub-ms HMR — Hot module replacement with state preservation
• Zero Config — Works out of the box with sensible defaults
• Plugin API — Extend build with custom plugins
• Development — Built-in dev server with file watching
• Production — Optimized builds with tree-shaking and code splitting
• Diagnostics — doctor command checks project setup

Installation

npm i -D @hyperpackai/cli

Or globally:

npm i -g @hyperpackai/cli

Quick Start

# Create a new app
npx @hyperpackai/create-hyperpack my-app
cd my-app
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Preview production build
npm run preview

Commands

# Development server
hyperpack dev --open

# Production build
hyperpack build --analyze

# Preview production build
hyperpack preview --port 5000

# Check project setup
hyperpack doctor

# Show all package versions
hyperpack versions

# Inspect resolved config
hyperpack inspect --json

# Clean cache and dist
hyperpack clean --all

Configuration

Create hyperpack.config.ts:

export default {
  entry: "src/main.tsx",
  jsxImportSource: "@hyperpackai/hyperion",
  plugins: [
    // Custom plugins
  ],
};

Plugins

Extend the build with plugins:

export default {
  plugins: [
    {
      name: "my-plugin",
      async resolveId(id) {
        if (id === "virtual-module") return id;
      },
      async load(id) {
        if (id === "virtual-module") return "export default {}";
      },
    },
  ],
};

Documentation

• Getting Started
• CLI Reference
• Configuration
• Plugins

License

MIT