This guide introduces the key concepts that make Mini Apps succeed. Each section leads with the value, then points you to a focused feature guide. No code here—follow the links to implement.

​
Authentication

Authenticate when it unlocks value, not before. Fast, optional sign‑in keeps momentum and lets users act the moment onchain interactions are needed.

Farcaster sign‑in (reference)

​
Wallets

Enable onchain actions without getting in the way. Prompt progressively and avoid gates that block exploration.

Provider & Initialization

​
Manifest

Your manifest powers saving, discovery, and rich embeds. A strong manifest includes complete fields, valid assets, and noindex: true during testing.

Manifest

​
Embeds & Previews

Distribution starts in the feed: compelling previews with a clear image and launch button turn impressions into launches.

Embeds & Previews

​
Search & Discovery

Be found across surfaces: set a primary category, share once to trigger indexing, and keep assets valid to appear in search and categories.

Search & Discovery

​
Sharing & Social Graph

Design for social lift: native share flows and social navigation turn single‑player moments into threads and returns.

Sharing & Social Graph

​
Notifications (coming soon)

Re‑engage saved users with relevant, rate‑limited notifications at the right moments.

Notifications

​
UX Best Practices

Build for compact, touch‑first contexts: respect safe areas, keep interfaces concise, and emphasize clear primary actions.

UI Patterns

Design patterns for Mini Apps

​
Performance & load polish

Perceived speed drives retention: target fast first paint, avoid layout shift, and minimize blocking work.

Troubleshooting

​
Quality Bar Check

Meet the standard for wide distribution: stable, instrumented, discoverable, shareable, and polished.

Quality Bar

Get Featured