Sandbox

The miniapp-sandbox is a local approximation of the Startale App host. It loads your Mini App in an iframe with the right sandbox attributes, simulates sdk.context, and exercises the full Mini App handshake.

Run it

No local setup needed: preview your Mini App directly at app.startale.com/developers/preview.

For a fully local environment:

git clone https://github.com/StartaleGroup/miniapp-sandbox.git
cd miniapp-sandbox
pnpm install
pnpm dev

Sandbox runs at localhost:3100.

Register your Mini App

Edit src/pages/configMiniApps.ts:

export const MINI_APPS: MiniAppConfig[] = [
  { url: 'http://localhost:5173/' },
]

The sandbox auto-fetches your Mini App’s /.well-known/farcaster.json to populate the launcher card.

What the sandbox simulates

Feature	Sandbox	Production Startale App
`sdk.context.startale.starPoints`	Hardcoded `100`	Real STAR Points balance
`sdk.context.startale.eoaWallets`	Not provided	Provided as `string[]` of verified addresses
Wallet connection	Wagmi + Startale connector	Smart account via host
EIP-1193 signing	Routes through your local wagmi client	Routes through the user’s smart account

Known gaps

eoaWallets is not simulated. Test EOA-discovery flows against staging or production.
Notifications via addMiniApp work locally only if you have configured a webhook endpoint reachable from the sandbox.
sendToken and swapToken actions return not_supported in the sandbox.

Iframe sandbox attributes

The sandbox loads your Mini App with:

sandbox="allow-scripts allow-forms allow-popups allow-popups-to-escape-sandbox allow-same-origin"
allow="clipboard-read; clipboard-write"

Your Mini App must function with these attributes. For example, popups opened from inside the iframe escape the sandbox, which is required for the Startale wallet popup.

Overview

Manifest

Runtime

Notifications

Ship it

Run it

Register your Mini App

What the sandbox simulates

Known gaps

Iframe sandbox attributes

​Run it

​Register your Mini App

​What the sandbox simulates

​Known gaps

​Iframe sandbox attributes

Run it

Register your Mini App

What the sandbox simulates

Known gaps

Iframe sandbox attributes