첫 %BRAND% 앱 만들기
정적 웹 페이지와 %BRAND% SDK로 작은 앱을 만들어요. %BRAND% 로그인, 스파크 결제(50%가 내 수익), AI, 데이터 저장을 쓸 수 있고, 데스크톱 앱 명령줄이나 원하는 코딩 에이전트로 만들어 명령어 하나로 마켓에 공개해요.
%BRAND% 앱 마켓의 앱은 모두 평범한 웹 페이지(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: 'Unlock premium themes' }); // 사용자가 확인한 뒤에만 결제
const { text } = await ws.ai.run({ prompt: 'Write a good-morning line' }); // 사용량만큼 사용자의 스파크에서
await ws.storage.set('notes', ['…']); // 사용자마다 따로 저장, 최대 512KB
앱은 따로 분리된 안전한 샌드박스에서 실행되고, 사용자의 %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 # 그다음부터: 새 버전
모든 버전은 자동 검사(매니페스트, 파일 종류, 크기, 의심스러운 코드)를 거쳐요. 처음 올릴 때와 권한이 바뀔 때는 담당자가 심사하고, 보통 하루 안에 끝나요. 승인되면 자동으로 공개되고, 개발자 센터에서 단계적 공개와 되돌리기를 할 수 있어요.
5. 수익과 출금
- 결제될 때마다 50%가 내 몫이에요. 구매한 스파크로 낸 부분은 출금할 수 있고, 출석 체크 같은 무료 스파크로 낸 부분은 기록만 돼요. 내 앱에 직접 낸 결제는 나누지 않아요.
- 수익은 30일 동안 보류돼요(이 기간에는 사용자에게 환불할 수 있어요). 500,000 스파크(약 50달러)부터 출금을 신청할 수 있고, 담당자가 확인해서 직접 보내요.
규칙
%BRAND%나 다른 브랜드를 사칭하지 말고, 비밀번호나 카드 번호, 인증 코드를 요구하지 마세요. 스파크를 받기 전에 무엇을 얻는지 분명히 알려 주세요. 사용자 데이터를 저장한다면 개인정보 처리방침이 있어야 해요. 규칙을 어긴 앱은 내려가요.
최종 업데이트: 2026년 11월 19일