PortModels
Log in

Publish an app

Everything you need to get an app listed in the PortModels gallery.

Publishing is free. You keep the revenue your app earns from usage.

1. Create a developer profile#

Publishing requires a PortModels account with a developer profile. Register if you don't have an account yet.

Your developer profile carries a publisher namespace — a unique handle that prefixes every app you publish. An app named summarizer published by acme has the identifier acme/summarizer. The namespace is claimed once and cannot be taken over by anyone else.

2. Submit your app#

From /publish, provide:

  • Name and tagline — a short, specific description of what the app does.
  • Description — what it does, what input it expects, and what a user gets back.
  • Category — pick the closest match so users can find it while browsing.
  • Typeweb app if it runs at a URL, download if users install it.
  • Link URL — where the app actually runs, or where the download starts.
  • Cover image — required, shown on the gallery card and the app page.
  • Screenshots — optional, up to 4, shown on the app page.

See Images for the format and size rules.

3. Review#

New submissions are pending and are not visible in the gallery until an admin reviews them. Review checks that the link works, that the listing accurately describes the app, and that the images are appropriate.

Editing an approved app's core details — link, description, category — returns it to pending until it is re-reviewed, because the outbound link is what users trust most.

See Review for what reviewers look for.

4. Live#

Once approved your app appears in the gallery, can be rated, and can receive comments. Comments are visible immediately and moderated after the fact; admins can hide comments that violate the guidelines.

5. Wire up Connect and the API#

A listing is a link — the app itself still has to authenticate users and call models:

  1. Enable Connect and note your client ID and secret.
  2. Send users through the authorization code flow, or the device flow for downloadable apps.
  3. Call the chat completions API with the token you receive.

6. Get paid#

Set your markup, watch earnings accumulate against real usage, and request a payout. See Pricing and markup and Earnings and payouts.