Developer Guides

Step-by-step developer guides for building with and on the PointSav platform. Each guide addresses a specific task — follow it start to finish, then refer back to the related architecture articles when you need the underlying theory.

For the concepts behind each guide, start in Platform architecture overview or patterns. For platform architecture overview, see Totebox orchestration as the development environment.

Getting started

The foundation: authenticate your device and open your first session.

• Pair a new device — enroll a machine using machine-based authorization; no username or password required
• Open your first Totebox session — navigate to an archive, read your inbox, and start contributing

Machine authorization

Credential and access control operations.

• Pair a new device — the core enrollment flow
• Authenticate binary downloads — verify and fetch signed binaries from the private distribution endpoint

Integration & data

Connect external data pipelines and build location-intelligence applications.

• Build a co-location map — query the GIS engine API and render a MapLibre cluster layer
• Federate archives via content mounts — mount wiki content from one archive into a second instance using declarative TOML mounts

Self-hosting

Deploy the platform on your own infrastructure.

• Self-host a deployment — provision a Totebox Archive on a supported compute node
• Run local SLM inference — route inference through Doorman to the on-premises language model

See also

• Architecture — cross-cutting platform architecture
• Patterns — named design patterns used across the platform
• Totebox session — what a Totebox session is and what it can do
• Machine-based authorization — how machine-based authorization works