overview.mdx

title	Agent App
description	Wrap an agent in a desktop, mobile, or dashboard product.

An Agent-Based App is a distribution shell built on top of an Eliza agent. The bundled elizaOS app — desktop (Electrobun), mobile (Capacitor + iOS/Android), and the web dashboard — is the canonical example. You can clone it, white-label it, ship your own.

What you build

A signed, distributable product (.dmg / .exe / .AppImage / TestFlight / Play Store / hosted web) that boots a local agent, walks the user through onboarding, and exposes the agent's connectors, capabilities, and chat through a polished UI.

How it fits together

Agent (core runtime + character + plugins)
   ↓ embedded in
Agent App (desktop / mobile / web shell, onboarding, settings, chat UI)
   ↓ optionally registered with
Eliza Cloud (appId, deployments, billing, domains)

Track contents

Electrobun shell, native modules, packaging, code signing. iOS and Android via Capacitor. Bun-backed local agent. The web dashboard that ships in every app shell. Register the app with Eliza Cloud, bind a domain, ship to users.

Where this comes from

• Desktop / web shell: packages/app/
• Shared UI + onboarding: packages/app-core/
• Cloud app registration: packages/cloud-api/

See also

• Apps overview
• Desktop development
• Mobile build guide
• Dashboard