Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.startale.com/llms.txt

Use this file to discover all available pages before exploring further.

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

FeatureSandboxProduction Startale App
sdk.context.startale.starPointsHardcoded 100Real STAR Points balance
sdk.context.startale.eoaWalletsNot providedProvided as string[] of verified addresses
Wallet connectionWagmi + Startale connectorSmart account via host
EIP-1193 signingRoutes through your local wagmi clientRoutes 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.