Documentation

All guides

Every guide is a Markdown file. Read it here, or append .md to any URL for the source.

Using Ember

Open Library inside Ember to browse the Ember catalog. Choosing Install downloads a package to Ember-owned staging, compares it with the registry SHA-256 digest, and shows its requested capabilities. An applet is installed only after you approve that review.

users.md Build applets

Build an Ember applet

An Ember applet is a small web app that runs inside Ember. You write HTML, CSS, and JavaScript, describe the app in applet.json, then sign and package it as a .ember-applet file.

humans.md Build applets

Build an Ember applet with an AI agent

Give the agent the repository's entire docs/applets folder. It is the authoritative applet contract and contains the manifest specification, v1 and v2 schemas, TypeScript types, a key generator, a package signer, and a WASI backend template. Read the public API reference first, then use the repository folder when packaging.

agents.md Reference

Ember applet API and manifest reference

This is the public reference for building an Ember applet. For packaging tools, JSON schemas, TypeScript declarations, and the WASI backend template, use the repository's docs/applets author kit.

applets/APPLET_SPEC.md Reference

Ember extensions

An Ember extension is a trusted native package installed into Ember. It is not sandboxed. An extension can run native code and access the user's computer and network. Ember shows this warning before installation.

extensions/EXTENSION_SPEC.md Reference

Registry API

The registry is the read side of Ember's distribution: a catalog of published applets and extensions, immutable package bytes, and the desktop client's update feed. Every response is public and unauthenticated. Writing to the registry is covered in publishing.

registry.md Reference

Publishing to Ember Registry

POST /v1/applets/:id/releases accepts the signed .ember-applet bytes. Authenticate with Authorization: Bearer <publisher-token> and supply JSON release metadata in X-Ember-Release.

publishing.md