Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Running the Build Service

The build service (hone-build) coordinates cross-platform plugin compilation. It accepts plugin source code and dispatches compilation jobs to perry-hub workers.

Overview

PropertyValue
Binaryhone-build
Port8447

Configuration

Create build.conf in the working directory:

PORT=8447

Running

cd /opt/hone-build && ./hone-build

How It Works

  1. A plugin author submits source code to the build service.
  2. The build service creates compilation jobs for each supported platform target (macOS, iOS, Windows, Linux, Android, Web).
  3. Jobs are dispatched to perry-hub workers — remote machines with the Perry compiler installed for each target platform.
  4. Workers compile the plugin and return the platform-specific binary artifacts.
  5. The build service collects all artifacts and stores them for retrieval by the marketplace.

Compilation

cd hone-build && perry compile src/app.ts --output hone-build

Tests

cd hone-build && bun test

Runs 21 tests covering artifact storage and platform normalization.