Handover Implementation Docs

How to implement Handover on your client site

Follow these guides to connect API keys, embed editable content, set up /admin, and launch with lock-state protection. Focused on what to do, in order.

Quick start
Follow these steps to connect a site and start editing.
  1. 1pnpm create handover@latest my-client-site
  2. 2cp .env.example .env.local
  3. 3Set NEXT_PUBLIC_HANDOVER_API_URL and NEXT_PUBLIC_HANDOVER_API_KEY
  4. 4pnpm dev
DX principles
What these docs optimize for.

Exact implementation sequence from API key to live edits.

Clear /admin setup path for non-technical client users.

Lock-state and error handling patterns you can ship with confidence.

Core guides

Start here to integrate Handover into your pages and admin workflows.

Quickstart
Getting started

Create your first project, connect API key, and verify editing + lock flow.

Implementation
Embed editable fields

Wire editable text and images into your site with stable keys and fallbacks.

Implementation
Client admin setup

Implement /admin login and editing actions for non-technical client users.

Reliability
Lock state and errors

Map SDK error codes to clear UX states and safe fallback behavior.