meta.json marketing, KPI & App Store fields

Marketing fields used in listings

These fields control the headline, outcome copy, imagery, and badges displayed in the App Store package detail view.

• title – marketing title shown in the hero section.
• outcome – short value statement displayed under the title.
• mission – used to filter and personalize the page (ex: general).
• description – fallback body copy when no outcome is provided.
• mainImage – hero image URL.
• screenshots – list of gallery image URLs.
• badges – optional tags like verified_integration or security_reviewed.
• pricing_levers – short labels surfaced in the offer panel (ex: runtime, usage).
• demo – optional demo video payload (video, length_sec).

KPI formatting

The kpis field accepts either an array of objects or a simple name-to-delta map.

{
  "kpis": [
    {"name": "Lead time", "delta": "-30%"},
    {"name": "NPS", "delta": "+12"}
  ]
}
      

The Package Manager UI also accepts one KPI per line in the form Name | Delta and writes it back into meta.json.

{
  "kpis": {
    "Lead time": "-30%",
    "NPS": "+12"
  }
}
      

Offers & entitlements

App Store offers are configured in the Store catalog (offer SKU/plan/pack IDs). meta.json supplies the entitlements that determine whether an offer is required for install.

• entitlements – explicit entitlement codes required to install the package.
• apps – app codes treated as entitlements for install gating.
• modules_required – module codes required for install.
• key / name / title – used to match the package to offers (via pack ID or SKU).

{
  "key": "flowbeacon",
  "title": "FlowBeacon AI",
  "entitlements": ["FLOWBEACON_PRO"],
  "apps": ["FLOWBEACON"],
  "modules_required": ["ANALYTICS"]
}
      

If you need to edit price, billing period, or SKU, update the offer in the Store admin. The package only declares what entitlements are required.