Koo Docs
View as Markdown

Showcase your app

Every public Koo app gets a page on koo.io — a place to show what you built, collect upvotes, and take comments. This guide covers app visibility, what your public page shows today, and how to get discovered.

Public vs private apps

Every app has a visibility setting: public or private.

  • Public apps render a page anyone can view, and they appear in discovery and search.
  • Private apps are visible only to members of the owning account. Private apps are a paid feature — apps on the Free plan are public. See what the free tier includes.

Making an app public exposes its showcase page only. Visitors see the app's name, its live URL, and social activity — never your environment variables and secrets, logs, or deployment history.

Your app's public page

Public apps render at koo.io/@handle/app-slug, where the handle belongs to the account that owns the app — see Your profile. The page shows, live today:

  • Name and live URL — the link points at the app's running web service.
  • Upvotes — signed-in visitors can upvote the app, one upvote per account.
  • Comments — a comment thread with one level of replies and per-comment votes.

The page reserves space for richer content — tagline, photo, video, links — but those fields can't be authored yet. The profile editor below will fill them in.

Author your app profile Coming soon

A profile editor, reachable from your own app page when you're signed in as the owning account, will let you fill out the public page:

  • Tagline and description — the one-line pitch and the longer story.
  • Photo — a cover image for the page and link previews.
  • YouTube embed — a video, referenced by its video id.
  • Category and tags — how your app is classified in search and browse.
  • Links — website, repository, and store pages (App Store, Play Store, Steam).

Members with the editor role or above on the owning account will be able to edit the profile; see Teams and roles. Saved profile fields will feed the search index, so a newly added tag or term will start matching in search right away.

Discover ranks public apps by search relevance and community activity; trending weighs an app's score against how recently it was earned. To rank well:

  1. Keep the app deployed and healthy — the public page links straight to your live URL.
  2. Complete the profile once the editor ships — name, tagline, description, and tags all feed the search index.
  3. Earn real activity — upvotes and comments raise your app's score. Sharing your page link is the simplest way to start.