Publishing guidelines
Want your widget in the gallery? Submit it through the submission form. We review every widget by hand — these are the things we check, so getting them right means a faster approval.
Requirements
- A valid
manifest.json. CorrectmanifestVersion, a unique reverse-domainid, plusname,version,entryanddefaultSize. See the manifest reference. - The entry HTML loads cleanly. No errors in the console, no missing files.
- Request only the permissions you use. Unused permissions are a reason to send a widget back.
- Include a clear preview image. Reference it with
previewin the manifest so people can see what they’re installing. - Keep it self-contained. Bundle your assets. No loading remote code, no analytics or tracking, and no network calls beyond what the widget genuinely needs.
- Handle the empty state. Show something sensible when nothing is playing
(
track === null).
Packaging
Zip the .nepget folder so the archive contains the bundle (manifest at the top
level). Keep the whole thing under 8 MB — that’s the upload limit on the
submission form.
What happens next
Submit via /widgets/submit. We’ll email you about the review. Once a widget is approved, it appears in the gallery with credit to you as the author.