Skip to content
Hoplite

Begin typing to search this documentation.

Introduction

Pre-1.0 macOS + Linux Release 0.1.0

Hoplite is a Hara application server built directly into Nginx. Applications are immutable resource trees, operations point to Hara Vars, and every Nginx worker resolves and compiles its handlers during startup.

request → nginx worker → cached Hara handler → native response

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 ambient system APIs.

One operational surface

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

Start with the running service

Section titled “Start with the running service”
  1. Install Hoplite with Homebrew or the release installer.
  2. Create your first application.
  3. Understand its project profile.
  4. Use the development workflow.

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