はじめての%BRAND%アプリを作る
Web ページと%BRAND%の SDK で小さなアプリを作りましょう。ログイン、スパークでの支払い(50% があなたの収益)、AI、データ保存が使え、コマンドひとつで公開できます。
%BRAND%のアプリマーケットにあるアプリは、どれも普通の Web ページ(HTML / JS / CSS)と SDK でできています。ホスティングは無料。ユーザーは%BRAND%のアカウントでログインし、スパークで支払います。アプリ内で使われたスパークの 50% があなたの収益です。
1. 準備
- デスクトップ版(ダウンロード)にはコマンドライン
widgetstoreが入っています。「Agents → コマンドライン」でインストールしてアカウントを接続してください。 - インストールしなくても、デベロッパーセンターでアプリを作って zip をアップロードできます。
- コーディングエージェント(Claude Code、Codex、Cursor、私たちの Agents)を使う場合は、まず AGENTS.md を読ませてください。
2. テンプレートから始める
widgetstore app init my-app --template sparks # blank / sparks / ai
cd my-app
widgetstore app dev # http://127.0.0.1:5178/
ローカルプレビューは%BRAND%を模擬します。ユーザー、スパーク(確認画面は出ますが実際には引き落とされません)、AI はすべてダミーです。
3. マニフェストと SDK
ルートに置く widgetstore.app.json:
{ "name": "My App", "version": "1.0.0", "entry": "index.html", "icon": "icon.svg",
"permissions": ["login", "sparks", "storage"], "network": [] }
ページで https://widgetstore.net/apps/sdk/v1.js を読み込み、次のように使います。
await ws.ready(); // 言語、テーマ
const { user } = await ws.login(); // ニックネーム、アイコン、このアプリだけで有効な匿名 ID
await ws.sparks.charge({ amount: 50, reason: 'プレミアムテーマを解放' }); // ユーザーが確認してから支払い
const { text } = await ws.ai.run({ prompt: 'おはようの一言を書いて' }); // 使用量に応じてユーザーのスパークから
await ws.storage.set('notes', ['…']); // ユーザーごとのデータ(最大 512 KB)
アプリは独立した安全なサンドボックスで動き、ユーザーの%BRAND%のログイン情報やほかのデータにはアクセスできません。外部サイトに接続するときは、そのドメインを network に書いてください(最大 5 個、審査で確認します)。
アプリのファイルはアプリごとの専用アドレス https://<slug>.youos.link から配信されます(%BRAND%とも、ほかのアプリとも別のサイトです)。ユーザーはこれまでどおり widgetstore.net/apps/<slug> からアプリを開きます。そのため slug に使えるのは英小文字・数字・単独のハイフンだけで、ハイフンで終わる名前や、www・mail・cdn のようなサービス名に見えるものは使えません。
4. 公開
widgetstore app publish --slug my-app # 初回:アプリを作成(widgetstore.net/apps/my-app)
widgetstore app publish # 2 回目以降:新しいバージョン
どのバージョンも自動チェック(マニフェスト、ファイルの種類、サイズ、不審なコード)を受けます。初めての掲載と権限の変更は担当者が審査し、通常 1 日以内に終わります。承認されると自動で公開され、デベロッパーセンターから段階リリースやロールバックができます。
5. 収益と出金
- 支払いのたびに 50% があなたの取り分です。購入したスパークで支払われた分は出金でき、ログインボーナスなど無料のスパークで支払われた分は記録のみです。自分のアプリへの支払いは分配されません。
- 収益は 30 日間保留されます(その間はユーザーに返金できます)。500,000 スパーク(約 50 ドル)から出金を申請でき、担当者が確認して手動で送金します。
ルール
%BRAND%やほかのブランドになりすまさないこと、パスワード・カード番号・確認コードを求めないこと、スパークを使ってもらう前に何が得られるかをはっきり書くこと。ユーザーのデータを保存する場合はプライバシーポリシーを用意してください。ルールに違反したアプリは公開を停止します。
最終更新:2026年11月19日