Complete Tutorial

How to Create Mini Apps on Base App & Farcaster

This guide walks you through the end-to-end process of creating, configuring, and publishing a Mini App that works seamlessly on Farcaster and Base App, using Ohara.ai as the app builder.

Step 1
Create Your Mini App on Ohara.ai

Build your app foundation

1.1 Access Ohara.ai

  • Open https://ohara.ai
  • Log in using your preferred wallet or authentication method

1.2 Create a New App

  • Click Create App
  • Choose a template or start from a blank project
  • Define the core purpose of your Mini App (e.g. game, utility, leaderboard, content saver)

1.3 Design & Logic

  • Build your UI (mobile-first is highly recommended)
  • Ensure responsive layout (works well inside embeds)
  • Simple navigation (Mini Apps should feel instant)
  • Add required logic (API calls, wallet connection, Farcaster identity, etc.)

1.4 Publish the App

  • Once ready, click Publish
  • Make sure the app is publicly accessible (no auth wall)
  • After publishing, your app will have a live URL
Step 2
Configure App Settings on Ohara

Set up your app configuration

2.1 Open App Configuration

  • Go to your app dashboard on Ohara
  • Click Configure → Settings

2.2 Copy the App URL

  • Copy the Production URL (this is critical)
  • This URL will be used for: Farcaster Embed, Farcaster Manifest, Base App Mini App loader
  • 💡 Tip: Make sure the URL uses HTTPS and loads fast. Slow apps may fail to render in embeds.
Step 3
Register the App on Farcaster Web

Make your app discoverable on Farcaster

3.1 Open Farcaster Developer Portal

  • Go to Farcaster Web
  • Navigate to Developer section

3.2 Configure Embed Tool

  • Find Embed Tool
  • Paste your Ohara app URL
  • Define embed behavior: Title, Description, Preview (if supported)
  • This allows your app to render inline inside Farcaster clients

3.3 Add Manifest Configuration

  • Open Manifest settings
  • Paste the same app URL
  • Fill required metadata: App name, Short description, Icon (square, optimized for small sizes), Permissions (only what you need)
  • Your manifest tells Farcaster how to treat your app as a Mini App
Step 4
Account Association Setup

Link your Mini App to your Farcaster identity

4.1 Required Information

  • You may need: Farcaster FID, Wallet address (if signing is required), Domain or app URL verification

4.2 Complete the Association

  • Follow the Farcaster Developer flow to: Sign a message, Verify ownership of the app
  • Ensure status shows Verified / Associated
  • Once completed, your app is officially recognized as yours
Tap for More Detail Instruction
Step 5
Test Your Mini App

Verify everything works perfectly

5.1 Open on Farcaster

  • Open Farcaster (web or client)
  • Paste your app link or open via embed
  • Check: UI rendering, Interaction, Loading speed

5.2 Open on Base App

  • Open Base App
  • Load the Mini App using the same URL
  • Ensure compatibility: Mobile UX, Wallet interactions (if any)
Step 6
Add Mini App to Your Account

Make it accessible to users

6.1 Add to Farcaster Profile

  • Open your Mini App
  • Click Add Mini App (or equivalent)
  • The app will now appear as part of your Farcaster experience

6.2 Share & Distribute

  • Share the Mini App link in casts
  • Encourage users to: Open, Add, Interact
  • Mini Apps grow best through social distribution
Best Practices & Tips
Keep Mini Apps simple and fast
Design for vertical mobile screens
Avoid heavy animations
Always test inside Farcaster, not just browser
Clear CTA: what should users do in 5 seconds?
Final Result

Once all steps are completed:

  • Your Mini App is live on Ohara
  • Embedded and registered on Farcaster
  • Accessible on Base App
  • Added to your Farcaster account

🚀 Your Mini App is now ready to scale through the Base & Farcaster ecosystem!