Nuvaka › Developer docs › Store listing
Store listing
Your extension's Store card, tagline and media are separate from the package: you can change them at any time without releasing a new version. The name, description, icon, category and permissions still come from the manifest.
Card style and tagline
| Field | Value | Rule |
|---|---|---|
cardStyle | compact | wide | compact: small card (icon, name, description). wide: wide card; the banner or video is featured. |
tagline | { tr?, en? } | short one-line pitch; at most 90 characters per language |
A wide card makes sense once you upload a banner or video; compact is enough for an extension without media.
Media rules
| Kind | Format and size | Rule |
|---|---|---|
banner | png, jpeg, webp · ≤ 2 MB | width ≥ 640 px, aspect ratio 1.6–2.2 (about 16:9, e.g. 1280×720). One banner; a new one replaces the old one. |
video | mp4, webm · ≤ 20 MB | plays muted, automatically and looped in the wide card (don't rely on sound). One video; a new one replaces the old one. |
screenshot | png, jpeg, webp · ≤ 2 MB | at most 8 screenshots; shown on the detail page |
- The type is detected from the content (the file's first bytes), not the file name; a jpeg named
.pngcounts as jpeg, and unrecognized files are rejected. - Errors:
415 bad_type(wrong type),413 too_large(size),400 bad_aspect(banner width or ratio),400 limit(more than 8 screenshots). - Media URLs change with the content; the same URL always serves the same file.
Where to change it
In the app
Profile › Developer › Store presentation: pick your extension, save the card style and tagline (Turkish/English), and upload or delete the banner, video and screenshots. If a media item was hidden, the reason is shown here.
From the CLI
# card style and tagline (without options: shows the current listing)
nuvaka-ext listing tarikgkhsn.github-watcher --style wide --tagline-tr "Depolarının yeni sürümlerini kaçırma" --tagline-en "Never miss a new release"
# media
nuvaka-ext media upload tarikgkhsn.github-watcher --kind banner banner.png
nuvaka-ext media upload tarikgkhsn.github-watcher --kind video promo.mp4
nuvaka-ext media upload tarikgkhsn.github-watcher --kind screenshot shot1.png
nuvaka-ext media list tarikgkhsn.github-watcher
nuvaka-ext media delete tarikgkhsn.github-watcher <mediaId>These commands use your saved developer token (nuvaka-ext login or NUVAKA_TOKEN). --tagline-en "" removes the tagline for that language; if you pass only one language, the other keeps its value. Details: CLI › listing and media.
Endpoints (user session or developer token): PUT /api/ext/v1/dev/extensions/{id}/listing, GET|POST /api/ext/v1/dev/extensions/{id}/media (?kind=banner|video|screenshot, raw body), DELETE /api/ext/v1/dev/extensions/{id}/media/{mediaId}.
Media reports and hiding
- Any signed-in user can report a Store media item or a review image/video; each person can report the same item once.
- A media item reported by 5 different users is hidden automatically. Administrators can also hide it with a reason, or show it again.
- Hidden media return
404and disappear from cards and the detail page. You see the reason in Store presentation (hiddenReason); upload a suitable replacement.
Dark theme
The Nuvaka UI is dark. Extensions whose manifest says "themes": ["dark"] (or ["dark", "light"]) open dark and appear under the Store's "Has dark theme" filter. For extensions without dark, users see "This app has no dark theme" before installing. See Manifest › themes.
How the Store looks to users
Shelves
The Store home page is made of these shelves, in this order (at most 18 extensions each; empty shelves are not shown):
| Shelf | Contents |
|---|---|
official | Nuvaka verified extensions or ones published by the Nuvaka team |
new | newly published |
top_rated | at least 3 ratings, ordered by Bayesian average (a barely-rated extension can't top the list with a single 5-star rating) |
most_installed | most installed |
recently_updated | recently updated |
Filters and sorting
- Compatible with this version — on by default: only extensions whose
minAppVersionfits the user's app version are listed. Don't setminAppVersionhigher than you need, or users on older versions won't see your extension. - Nuvaka verified, Has dark theme, maximum risk (low / medium / high), minimum rating, category and search (name, description, publisher username, ID).
- Sorting: Recommended, Most installed, Top rated (Bayesian average), Newest, Recently updated.
Publisher profile
Clicking the publisher name on a card or the detail page opens the publisher profile: member since, published extensions, number of verified extensions, total installs and average rating.
Detail page and reviews
- The detail page shows the banner/video, screenshots, version history and change notes (
--changelog), permissions with reasons, dangerous pair warnings, the rating distribution and the 3 most helpful reviews. - Users who installed the extension can give 1–5 stars and a review (≤ 2000 characters); one review per person, which they can update. The publisher can reply.
- A review can carry at most 2 images (png/jpeg/webp, ≤ 2 MB each) and 1 video (mp4/webm, ≤ 5 MB). Review media can be reported and are hidden by the same rules.
- Reviews can be sorted by newest, most helpful, highest or lowest rating, and filtered to reviews with media.
Nuvaka Apps API v1 · last updated 2026-09-27