Scaffold a new SBC App Kit project with one command.
npm install create-sbc-appThe easiest way to get started with SBC Account Abstraction. Create feature-complete applications with gasless transactions in seconds.
``bashCreate a new SBC app
npx create-sbc-app my-app
CLI Options
`bash
Usage: npx create-sbc-app [project-directory] [options]Create a new SBC App Kit project with an opinionated template
Arguments:
project-directory Directory to create the new app in
Options:
-V, --version output the version number
-t, --template Template to use: react, react-dynamic, react-para, or react-turnkey
-c, --chain Chain to use: baseSepolia, base, or radiusTestnet
--api-key Your SBC API key for immediate configuration
--wallet Wallet integration (not yet implemented)
-h, --help display help for command
Examples:
$ npx create-sbc-app my-app
$ npx create-sbc-app my-app --template react --chain radiusTestnet
$ npx create-sbc-app my-app --template react-dynamic --chain base
$ npx create-sbc-app my-app --template react-para --api-key your-key
$ npx create-sbc-app my-app --template react-turnkey --chain base
Available Templates:
- react React + Vite template with SBC integration
- react-dynamic React + Vite with Dynamic wallet integration
- react-para React + Vite with Para wallet integration
- react-turnkey React + Vite + Express backend with Turnkey embedded wallets
Available Chains:
- baseSepolia Base Sepolia testnet (default)
- base Base mainnet
- radiusTestnet Radius testnet (react template only - not supported by Dynamic, Para, or Turnkey)
`✨ Features
The React template includes comprehensive, production-ready examples:
$3
- Smart Account Management - Automatic account creation and management
- Gasless Transactions - Send ETH and interact with contracts without gas fees
- Gas Estimation - Preview transaction costs before sending
- Batch Transactions - Send multiple operations in a single transaction
- Real-time Balance Tracking - Monitor account balances and transaction status
- Error Handling - Comprehensive error messages and recovery suggestions
$3
- Modern UI Design - Beautiful, responsive interfaces
- Form Validation - Real-time address and input validation
- Loading States - Clear feedback during operations
- Success/Error Feedback - Visual confirmation of transaction status
- Block Explorer Integration - Direct links to view transactions
- Copy-to-Clipboard - Easy address and hash copying
$3
- TypeScript Support - Full type safety
- Environment Configuration - Secure API key and settings management
- Debug Logging - Comprehensive development logging
- Hot Reload - Fast development iteration
- Production Ready - Optimized builds and deployment preparation
🚀 Templates
$3
Best for: Client-side applications, rapid prototyping, and production use
`bash
npx create-sbc-app my-app
`Supported Chains: Base Sepolia, Base, Radius Testnet
Features:
- Fast development setup
- Hot module replacement
- Direct wallet connection (MetaMask, Coinbase, WalletConnect)
- Built-in testing framework
- Easy deployment to static hosts
- Modern React patterns and hooks
$3
Best for: Applications requiring embedded wallets with social logins
`bash
npx create-sbc-app my-app --template react-dynamic
`Supported Chains: Base Sepolia, Base (Radius Testnet not supported)
Features:
- Dynamic SDK integration for embedded wallets
- Social login support (Google, Twitter, Discord, etc.)
- Email/SMS wallet creation
- All standard SBC features
Additional Requirements: Dynamic Environment ID from Dynamic Dashboard
$3
Best for: DeFi applications leveraging EIP-2612 permits
`bash
npx create-sbc-app my-app --template react-para
`Supported Chains: Base Sepolia, Base (Radius Testnet not supported)
Features:
- Para wallet integration
- EIP-2612 permit signatures
- Gasless token approvals
- All standard SBC features
Additional Requirements: Para API Key from Para
$3
Best for: Production applications requiring embedded wallets with biometric authentication and backend infrastructure
`bash
npx create-sbc-app my-app --template react-turnkey
`Supported Chains: Base Sepolia, Base (Radius Testnet not supported)
Features:
- Turnkey embedded wallet integration with passkey authentication
- Express backend server for secure Turnkey API operations
- Two authentication methods: biometric passkeys (Face ID/Touch ID) or wallet connection (MetaMask/Coinbase)
- Account history and multi-account management
- Full-stack development with
dev:fullstack script
- ERC-4337 smart accounts with gasless transactions
- All standard SBC featuresAdditional Requirements:
- Turnkey Organization ID and API Keys from Turnkey Dashboard
- Backend deployment for production use (Railway, Render, Vercel, etc.)
Architecture:
- Frontend: React + Vite (port 5173)
- Backend: Express server (port 3001)
- Runs both services concurrently with
npm run dev:fullstack📝 Configuration
$3
The template includes comprehensive environment configuration:
#### Required
`bash
Your SBC API key (get from SBC dashboard)
VITE_SBC_API_KEY=your_api_key_hereSupported chains: "baseSepolia" | "base" | "radiusTestnet"
VITE_CHAIN="baseSepolia"
`📱 UI Components
The template includes:
- Account information display with copy functionality
- Transaction forms with validation
- Gas estimation interfaces
- Success/error feedback with block explorer links
- Responsive design with dark mode support
🚀 Development Workflow
$3
`bash
npx create-sbc-app my-sbc-app
cd my-sbc-app
`$3
`bash
Copy environment template
cp .env.template .envthen ensure your .env has the environment variables set up
Supported chains: "baseSepolia" | "base" | "radiusTestnet"
VITE_CHAIN="baseSepolia"
Custom RPC URL (optional) - e.g. get one from Alchemy at https://dashboard.alchemy.com/apps
VITE_RPC_URL=
Get your SBC API Key at https://dashboard.stablecoin.xyz
VITE_SBC_API_KEY=
`$3
`bash
npm install
npm run dev
``- Connect and view your smart account
- Try sending test transactions
- Experiment with gas estimation
- Test batch transactions
- Modify the UI to match your needs
- Add your own smart contract interactions
- Build for production
- SBC Documentation - Official docs
- GitHub Repository - AppKit API Reference. Source code and examples
MIT - Built with ❤️ by the SBC team