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.

Add an fc:miniapp meta tag to the <head> of every page you want to be launchable from a feed (X, Telegram, Discord, Farcaster). When the URL is shared, those platforms render a preview card with a CTA that opens your Mini App. The Startale App does not parse this tag, it is a Farcaster standard. Startale verifies the embed is live during QA before approving your listing.

​
Tag

All fields are delivered as a single stringified JSON object: 
<meta name="fc:miniapp" content='{"version":"1","imageUrl":"...","button":{...}}' />

​
Required fields

String-length values below come from the Farcaster Mini App spec. They are not enforced by the Startale parser, but staying within them is recommended for consistent display across feeds and the launcher splash.
FieldTypeConstraints
versionstringMust be "1".
imageUrlstringPreview image shown in the social feed. HTTPS, 3:2 aspect ratio. Recommended ≤1024 chars.
button.titlestringLabel on the CTA button. Plain text, recommended ≤32 chars.
button.action.typestringOne of "launch_frame" or "view_token".
button.action.namestringApp name shown on the splash screen after the user taps the CTA. Plain text, recommended ≤32 chars.
button.action.urlstringHTTPS launch URL when the button is tapped. Defaults to the page URL if omitted. Recommended ≤1024 chars.

​
Optional fields

FieldTypeConstraints
button.action.splashImageUrlstringCentered splash icon. PNG, 200×200 px.
button.action.splashBackgroundColorstringHex color for the splash background.

​
Example

<meta name="fc:miniapp" content='{
  "version": "1",
  "imageUrl": "https://your-app.com/preview.png",
  "button": {
    "title": "Play Now",
    "action": {
      "type": "launch_frame",
      "name": "Your App Name",
      "url": "https://your-app.com",
      "splashImageUrl": "https://your-app.com/splash.png",
      "splashBackgroundColor": "#1a1a2e"
    }
  }
}' />

​
Troubleshooting previews

Test your embed tag at app.startale.com/developers/embed before sharing anywhere.
  • The image must be reachable over HTTPS with a valid certificate.
  • Cache headers matter. Feeds reuse stale previews. Set Cache-Control: public, max-age=60 on preview images while iterating.
  • Test your embed by sharing the URL into a private cast on Farcaster or a saved-messages chat on Telegram.