Scaffold Stark React Native
This documentation is currently hosted within the Scaffold Stark docs. In the future, it may be moved to a dedicated documentation site for Scaffold Stark React Native. Bookmark the GitHub repository for the latest updates and announcements.
Scaffold Stark React Native (scaffold-stark-rn) is a mobile development framework built on top of Scaffold Stark 2, designed to help developers rapidly build and deploy mobile dApps on the Starknet blockchain.
Overview
Scaffold Stark React Native combines the power of React Native with Expo to provide a seamless mobile development experience for Starknet. It shares the same smart contract infrastructure (snfoundry package) with the web version while providing mobile-optimized hooks and components.
Create a new project in seconds with the CLI:
npx create-stark-rn my-dapp
| packages/rn (React Native App) | packages/snfoundry (Smart Contracts) |
|---|---|
| Expo 54 | Cairo Contracts |
| React Native 0.81 | Deployment Scripts |
| NativeWind | Testing with snforge |
| Starknet-React | Shared with SS2 |
Key Differences from Scaffold Stark 2 (Web)
| Feature | Scaffold Stark 2 (Web) | Scaffold Stark RN (Mobile) |
|---|---|---|
| Framework | Next.js | React Native + Expo |
| Routing | Next.js App Router | Expo Router (file-based) |
| Styling | Tailwind CSS | NativeWind (Tailwind for RN) |
| Wallet Support | Browser Extensions | Cavos Aegis (WaaS) + Burner Wallet |
| Platform | Web Browsers | iOS & Android |
| State Management | Zustand | Zustand |
| Storage | localStorage | expo-secure-store |
| Smart Contracts | packages/snfoundry | packages/snfoundry (identical) |
Target Audience
Scaffold Stark React Native is designed for:
- Mobile dApp Developers: Build native iOS and Android applications that interact with Starknet smart contracts
- Web3 Developers: Extend your existing Scaffold Stark 2 projects to mobile platforms
- Startups & Teams: Rapidly prototype and ship mobile blockchain applications
- Learning & Experimentation: Explore mobile Web3 development with a complete, working template
Use Cases
- DeFi Mobile Apps: Trading, lending, and portfolio management on the go
- NFT Marketplaces: Browse, mint, and trade NFTs from mobile devices
- Gaming dApps: Mobile-first blockchain games on Starknet
- Social dApps: Decentralized social platforms with mobile-native UX
- DAO Tools: Governance and voting apps for community participation
Features
- CLI Scaffolding: Create new projects instantly with
npx create-stark-rn— interactive prompts for project name, smart contracts inclusion, and package manager - Pre-configured Expo Project: Ready-to-run mobile app with Starknet integration
- Scaffold Stark Hooks: Familiar hooks adapted for React Native (
useScaffoldReadContract,useScaffoldWriteContract, etc.) - Wallet-as-a-Service: Built-in Cavos Aegis integration for seamless wallet management
- Burner Wallet: Local devnet testing with secure storage via
expo-secure-store - Transaction Sponsorship: AVNU integration for gasless transactions
- Debug Contracts UI: Built-in contract debugging page with auto-generated forms from ABI
- Theme Support: Light/dark mode with ThemeProvider and consistent color system
- Local Development: Full local devnet support for rapid iteration
- Type-Safe Contracts: Auto-generated TypeScript types from Cairo contracts
Status
Scaffold Stark React Native is currently marked as experimental. While fully functional, the API may change as the project evolves. Production usage should be approached with appropriate testing and caution.
Quick Links
Next Steps
Ready to build your first mobile dApp on Starknet? Head to the Installation Guide to get started.