Skip to content
Select theme
Select languageEnglish

Build for Dopame OS

Apps and desktops in HTML, CSS, and JS, with any frontend framework.

Give your coding agent this prompt. It installs acdev, sets it up, and learns how to use it:

Read https://pkgs.dopame.ai/acdev/install.md and follow it to set up acdev on this machine.

Or install it yourself:

Terminal window
curl -fsSL https://pkgs.dopame.ai/acdev/install.sh | sh

Handing these docs to an agent? Give it docs.dopame.ai/llms.txt: the acdev skill itself, in plain Markdown, with a link to every page. Each page is also there as Markdown, with .md in place of its last / (/guide/files.md).

The Dopame OS desktop is itself a web page, and so is every window on it. An app is a web project: HTML, CSS, and JS, written with any framework you like (React, Vue, Svelte, Next.js, Nuxt, Astro, ...), optionally with a backend that runs on Bun or Node.js.

Unlike in a browser, an app can request capabilities in its config (acde.config.jsonc), such as reading and writing the user's folders, opening a terminal, or opening other apps. Capabilities aren't exposed on global objects. You import them from built-in acde: modules, much like node:fs in Node.js:

import { fs } from 'acde:fs'
const roots = await fs.roots()

Almost everything else in the page is the standard Web platform: the DOM, fetch, localStorage, IndexedDB, Web Audio, and so on, behaving as they do in a browser. The exceptions, such as no Service Workers and no ES modules from other hosts, are listed in Web compatibility.

What it is Analogy
acdev The developer CLI: create projects, build, run dev sessions, debug, test wrangler
acdev runtime The runtime: the program that runs desktops and apps on your computer, built on the libacde runtime library workerd

In short: acdev is the command you type, and acdev runtime is the program that actually runs your app.

During development you only deal with acdev. acdev dev builds your project and starts acdev runtime, which opens a window on your computer with your app inside (with --desktop dopame, inside the Dopame desktop). When you change code, it rebuilds and reloads automatically. The acdev installer sets up the acdev runtime release that acdev pairs with next to it, so acdev dev works right after installing; see Install.