# Marketplace

apps.kode.diy, the catalog of apps for the Kode Dot. Install one over USB from a computer, rate what you ran, and publish your own through review.

![The marketplace opens on a catalog you can search and filter by category, with apps chosen by Kode first and an Install button on every card, no account needed.](/ecosystem/marketplace/home.webp)

*apps.kode.diy signed out: what anyone sees on a first visit.*

## What it is

The marketplace at `apps.kode.diy` is the catalog of apps for the Kode Dot.
Makers publish them, and Kode tries each one on a real Kode Dot before it is
listed. Browsing, searching and installing need no account.

Every app is one of two kinds, and the kind decides what an install does. An
app's page says which one it is, beside its name.

![A kodeOS app joins the list of apps kodeOS already holds, and kodeOS stays. A full image replaces everything on the board, kodeOS included.](/ecosystem/marketplace/two-kinds.webp)

## Install from a computer

1. Open `apps.kode.diy` in **Chrome or Edge**. The install goes through Web Serial, which Safari and Firefox do not have.
2. Plug the Kode Dot in with a USB-C cable that carries data, not just charge.
3. Open an app, press **Install over USB** and pick the Kode Dot in the browser's port list.
4. Wait for the install to end. The Kode Dot reboots into the app.

![On an app's page, the yellow Install over USB button sits under the app's name and kind, and the line under it says the install needs Chrome or Edge and kodeOS on the Kode Dot.](/ecosystem/marketplace/install-over-usb.webp)

## Install without the port list

**Add Kode**, in the sidebar, connects a Kode Dot over the cable or over
Bluetooth and keeps it under **Your Kodes**. From then on the button on an
app's page reads **Install on** and the Kode Dot's name, and no port list
appears.

The last step of Add Kode, which you can skip, puts the Kode Dot on Wi-Fi and
on your account. A Kode Dot that is on your account and online takes kodeOS
apps over Wi-Fi, with no cable and from anywhere. A full image always needs
the cable.

## Rate, review and publish

Signing in, with GitHub, Google or Apple, opens these. One account per email:
a second provider with the same email is refused, not linked.

- **Rating**: Half stars, 0.5 to 5, one per person per app. Only for an app you installed while signed in, and never your own.
- **Review**: An optional comment of up to 1,000 characters beside the rating. The first one asks you to confirm you are 16 or older. Anyone can report a review.
- **Publishing**: A `.bin` of up to 30 MB with a name, a version and a description. A reviewer tries it on a Kode Dot, and it is listed once approved.
- **Updating**: The update goes through review too. The listed version stays up until it is approved.

## When something goes wrong

- **Get kodeOS back**: After a full image, or your own build, kodeOS apps stop running. **Recovery**, top right of these docs, `apps.kode.diy/recovery`, or **Reinstall kodeOS** at the foot of a Kode Dot's page on the marketplace, installs kodeOS again and **erases the whole Kode Dot** first: apps, saved Wi-Fi networks and storage.
- **On a phone**: The site is for browsing. To install, use the Kode app, which installs kodeOS apps over Bluetooth.
- **No port in the list**: The cable only charges. Try one that carries data.