WidgetStore - Widgets, animated icons, dashboards and personal pages for Notion

Build your first WidgetStore app

Build a small app with a web page and the WidgetStore SDK: sign-in, Sparks payments (you keep 50%), AI and storage, published with one command.

Every app in the WidgetStore app market is a regular web page (HTML / JS / CSS) plus our SDK. Hosting is free, people sign in with their WidgetStore account and pay with Sparks, and you keep 50% of the Sparks people spend in your app.

1. Get set up

  • The desktop app (download) includes the widgetstore command line: install and connect it under Agents → Command line.
  • Or skip it: create an app and upload a zip in the developer center.
  • Using a coding agent (Claude Code, Codex, Cursor, our Agents)? Have it read AGENTS.md first.

2. Start from a template

widgetstore app init my-app --template sparks   # blank / sparks / ai
cd my-app
widgetstore app dev                              # http://127.0.0.1:5178/

The local preview simulates WidgetStore: a fake user, fake Sparks (the confirmation still appears, nothing is charged) and fake AI.

3. Manifest and SDK

widgetstore.app.json at the root:

{ "name": "My App", "version": "1.0.0", "entry": "index.html", "icon": "icon.svg",
  "permissions": ["login", "sparks", "storage"], "network": [] }

Load https://widgetstore.net/apps/sdk/v1.js in your page, then:

await ws.ready();                                   // language, theme
const { user } = await ws.login();                  // nickname, avatar, an anonymous ID that only works in your app
await ws.sparks.charge({ amount: 50, reason: 'Unlock premium themes' });  // charged only after the user confirms
const { text } = await ws.ai.run({ prompt: 'Write a good-morning line' }); // charged to the user's Sparks by usage
await ws.storage.set('notes', ['…']);              // each user's own data, up to 512 KB

Apps run in their own secure sandbox and can't see the user's WidgetStore sign-in or other data. To reach another site, list its domain in network (up to 5; checked in review).

Each app's files are served from its own address, https://<slug>.youos.link — a separate site from WidgetStore and from every other app. People still open your app at widgetstore.net/apps/<slug>. That's why a slug can only use lowercase letters, numbers and single hyphens, can't end with a hyphen, and can't be a service-like name such as www, mail or cdn.

4. Publish

widgetstore app publish --slug my-app   # first time: creates the app (widgetstore.net/apps/my-app)
widgetstore app publish                 # every time after: a new version

Each version is checked automatically (manifest, file types, size, suspicious code). The first listing and permission changes are reviewed by a person, usually within a day. Approved versions go live automatically; in the developer center you can release to a share of users (canary) or roll back.

5. Earnings and payouts

  • You get 50% of every payment. The part paid with purchased Sparks can be withdrawn; the part paid with free Sparks (daily check-ins and so on) is counted only. Paying in your own app isn't shared.
  • Earnings are on hold for 30 days (you can refund users during that time). From 500,000 Sparks (about $50) you can request a payout, which we review and pay by hand.

Rules

Don't pretend to be WidgetStore or another brand, never ask for passwords, card numbers or verification codes, and say clearly what people get before charging Sparks. If you store user data, provide a privacy policy. Apps that break the rules are removed.

Last updated: Nov 19, 2026