Overhaul Mini Apps IA and scaffold new docs | WIP #207
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,16 @@ | ||
| --- | ||
| title: Design Patterns for Mini Apps | ||
| description: Principles and patterns to build social, repeat-use experiences | ||
| --- | ||
|
|
||
| Importing core content from Thinking Social. | ||
|
|
||
| <Note> | ||
| This page will summarize design principles and link to the detailed guide below. | ||
| </Note> | ||
|
|
||
| <Card title="Build Viral Mini Apps (detailed guide)" icon="users" href="/base-app/build-with-minikit/thinking-social" /> | ||
|
|
||
| TODO: Add condensed patterns and examples tailored to Mini Apps (identity, co‑creation, rituals). | ||
|
|
||
|
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: Language and Tone | ||
| description: Copy guidelines for concise, friendly Mini App experiences | ||
| --- | ||
|
|
||
| TODO: Provide copy patterns for onboarding, errors, and social sharing within Mini Apps. | ||
|
|
||
|
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: OnchainKit Usage in Mini Apps | ||
|
There was a problem hiding this comment. nit: I think it's enough to say "OnchainKit" / drop "Mini Apps" from most titles to make everything easier to skim. The pages are under "Mini Apps" tab so it's implied that they're for mini apps. |
||
| description: How to leverage OnchainKit components and MiniKit together | ||
| --- | ||
|
|
||
| TODO: Document recommended OnchainKit components for Mini Apps, integration tips, and examples. | ||
|
|
||
|
|
||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,8 @@ | ||
| --- | ||
| title: UI Patterns for Mini Apps | ||
| description: Compact, touch-first interfaces that fit Mini App contexts | ||
| --- | ||
|
|
||
| TODO: Safe area insets, primary button usage, compact layouts, input ergonomics, and accessibility considerations. | ||
|
|
||
|
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,42 @@ | ||
| --- | ||
| title: Authentication | ||
| description: Let users start fast and ask for a wallet only when needed | ||
| --- | ||
|
|
||
| ## Authentication guidance from Base App | ||
|
|
||
| <Warning> | ||
| Save authentication that requires an interaction for interactions that require it (e.g., buying something, viewing personalized pages). | ||
| </Warning> | ||
|
|
||
| Supported approaches: | ||
|
|
||
| <Tabs> | ||
| <Tab title="Sign In with Farcaster / Quick Auth"> | ||
| Base App supports SIWF in‑app, enabling social identity without leaving the app. Quick Auth can issue a JWT to persist session state. | ||
| </Tab> | ||
|
|
||
| <Tab title="Wallet Auth"> | ||
| Base App provides an in‑app smart wallet. Use wallet auth for a persisted session when necessary, but avoid gating initial exploration behind connect. | ||
| </Tab> | ||
|
|
||
| <Tab title="Context Data"> | ||
| All hosts return context data (including user). Use it for analytics or lightweight session hints, but do not treat as primary auth. | ||
| </Tab> | ||
| </Tabs> | ||
|
|
||
| Best practices: | ||
|
|
||
| - Gate wallet only at the point of onchain action | ||
| - Prefer SIWF/Quick Auth for low‑friction identity | ||
| - Use context for analytics; avoid using it as primary auth | ||
|
|
||
| Further reading: | ||
|
|
||
| <CardGroup cols={2}> | ||
| <Card title="useAuthenticate" icon="book-open" href="/mini-apps/technical-reference/minikit/hooks/useAuthenticate" /> | ||
| <Card title="Provider & Initialization" icon="cog" href="/mini-apps/technical-reference/minikit/provider-and-initialization" /> | ||
| </CardGroup> | ||
|
|
||
|
|
||
|
|
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Let’s make sure there’s no duplicate content between "quality-bar" and "submission-guidelines". We can keep things clearer by having one distinct checklist for each purpose e.g. one for Launch, one for Submission—this way, it’s easier for builders to follow and for our team to iterate on together.