# Publish — Atom Apps

Machine-readable. HTML twin: https://atom.apps.qwixl.com/docs/publish

Create an **App** (listing), attach a **Release** (versioned zip), publish.

## 1. Open the console

https://atom.apps.qwixl.com/developer/

- Create account (Supabase Auth), accept Terms, sign in.
- Free: Terms enough to publish.
- Paid: verified email + Stripe Connect ready.

## 2. Create an app and first release

- **New app**: identity, listing copy, Free or Paid (GBP), then package.
- Zip must include parseable `manifest.json` whose id and version match the form.
- Review and publish — listing appears on https://atom.apps.qwixl.com/apps
- After first publish: edit listing metadata without re-upload; later versions via **Ship a new version**.

Slug: `module_id` with `/` → `--` (example `acme/notes` → `acme--notes`).

## 3. How owners install

On the app detail page:

- **Open in Atom** — `atom://install?...`
- **Open in browser shell** — `https://atom.qwixl.com/install?...`
- **Copy install link**

Store install links include `registryUrl=https://atom.apps.qwixl.com/registry/index.json`.

## After publish

- Public URL: `https://atom.apps.qwixl.com/apps/{slug}`
- New version = new Release with bumped semver
- Paid path details: https://atom.apps.qwixl.com/docs/paid.md