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.

A Startale Mini App is a web application that runs inside the Startale App on mobile and desktop, in an embedded frame. It uses the host’s wallet, has access to user STAR Points, and can read the user’s verified linked EOAs. Mini Apps follow the Farcaster Mini App specification, with Startale-specific extensions documented here.
Protocol foundation. Startale uses the Farcaster Mini App protocol as a technical communication standard, not as a social platform. Users do not need a Farcaster account to use your Mini App. Farcaster social features (sign-in with Farcaster, cast composition, social graph) are not available inside the Startale App. The protocol provides the iframe communication standard and manifest format only.

​
Why ship a Mini App

Build a Mini App whenStay a standalone application when
Your audience already lives in the Startale AppYou need cross-wallet support beyond Startale
You want to read user STAR Points or verified EOAsYou need full control of the auth layer
You are running a campaign with StartaleYou require a non-EVM stack
You want native distribution in the explorerYou have an existing user base outside Startale

​
How a Mini App differs from a standalone application

  • Authentication is shared with the Startale App, no separate sign-in.
  • The wallet popup is replaced by the host’s approval UI.
  • The signer is always the user’s smart account; linked EOAs are read-only.
  • A handful of EIP-1193 methods (wallet_switchEthereumChain, wallet_addEthereumChain) are not available inside the host.
See Wallet integration for the full surface.

​
What you ship

  1. A web application served over HTTPS.
  2. A signed manifest at /.well-known/farcaster.json.
  3. An fc:miniapp meta tag on shareable pages.
  4. A submission to Startale.

​
Reusing a Farcaster or Base manifest

If your project already lives on Farcaster or Base, your existing farcaster.json works on Startale. Add Startale-specific fields inside a startale object within your existing frame object. A single file works on all three platforms. See Manifest.

​
Get started

Quickstart

Build, sign, register, and run a Mini App in the local sandbox.

Manifest reference

Every field, what is required, what is optional, what gets used.

Preview your Mini App

Load any URL in the Startale App frame and test the wallet handshake.

Developer tools

Manifest validator, embed validator, and Mini App preview in one place.