Introduction

Pre-release macOS-first

Hoplite is a lightweight, high-performance and deeply customizable Nginx application container. An application is an immutable resource tree, each operation points to a Hara Var, and each Nginx worker resolves and compiles its handlers once at startup.

request → nginx → HTA value → cached Hara handler → HTA response → nginx

Application as data

Routes and operations are declarative values that can be validated before serving traffic.

Worker-local runtime

Each Nginx worker owns one Hoplite runtime, its values, fibers, promises, and compiled handlers.

Capability-bound host

Hara code calls explicitly installed host services rather than reaching ambient system APIs.

Operational surface

One executable checks, builds, serves, reloads, inspects, installs, and stops applications.

Current scope

The packaged executable currently targets macOS. Linux is exercised by CI and Docker, but the first tagged release and final bytecode bootstrap integration are still in preparation. Treat all interfaces as pre-release.

Follow the quickstart

1. Install Hoplite.
2. Define your first application.
3. Configure its Hara project profile.
4. Use the development workflow.

For a single end-to-end tutorial that continues through routing, the current request and response boundary, asynchronous handlers, OpenAPI, build output, and production operation, follow Writing web services.

Hara prerequisite

Hoplite applications are written in HAL and evaluated by Hara. The source-build workflow expects sibling checkouts of hara.lang and hoplite.