MiniApps Sandbox

Development sandbox for Farcaster Mini Apps with Startale App

---

📋 Overview

Build and test Farcaster Mini Apps that integrate with Startale App for wallet authentication and Soneium blockchain interactions.

Key Features:

• 🔐 Startale Wallet Authentication
• ⛓️ Soneium Network Support
• 🔗 Wagmi Integration
• 📱 Mini Apps Gallery

---

🚀 Quick Start

Start All Services

./start.sh

This starts:

• Sandbox at http://localhost:3100 — host/client UI
• Notify at http://localhost:3200 — notification service

To stop:

./stop.sh

Manual Development

Sandbox only:

pnpm install
pnpm dev

With notifications (separate terminals):

# Terminal 1
pnpm dev

# Terminal 2
cd notify
pnpm install
pnpm dev

---

📱 Add Your Mini App

Edit src/pages/configMiniApps.ts and add your Mini App to the gallery.

---

🔑 Login Flow

The sandbox demonstrates authentication using Startale SDK:

1. Connect - Users connect via Startale App (RainbowKit UI)
2. Smart Contract Wallet - Startale returns a smart contract wallet address (not EOA)
3. Session - Access the address via const { address } = useAccount()

---

📚 Documentation

Build Your Own Mini App

INTEGRATION.md — Step-by-step guide:

• Creating and signing a Farcaster Mini App
• Integrating Startale SDK
• Wagmi configuration
• Code examples

Notifications

NOTIFICATIONS.md — How to use notifications:

• Enable notifications in your Mini App
• Send notifications from client or backend
• Rate limits and best practices

---

📄 License

MIT

---

Built with ❤️ for the Startale ecosystem