yap.app.json reference

Stub. See the Market & Apps spec § 3 for the canonical schema while this page is being filled in.

A single JSON file at the root of your app’s repo. The CLI publishes this file plus its referenced bundle.

Required fields

FieldTypeNotes
idstringGlobally unique. Reverse-DNS recommended.
namestringHuman display name.
slugstringURL slug for /market/<slug>.
versionsemver stringSemantic version.
publisherstringYour publisher handle.
categoryenumhealth, pm, reading, productivity, dev, other.
taglinestring≤ 120 chars.
descriptionstringMarkdown body shown on the detail page.
scopesstring[]OAuth scopes the app requests at install.

Example

{
  "id": "fitness-app",
  "name": "Fitness",
  "slug": "fitness",
  "version": "1.2.3",
  "publisher": "lift-co",
  "category": "health",
  "tagline": "Track workouts, PRs, and routines as yaps.",
  "scopes": ["yaps:read", "yaps:write", "tags:write", "goals:read", "goals:write", "routines:read"],
  "pricing": { "model": "free" }
}