Running Your App

After App Factory generates your app, follow these instructions to run it locally for testing and development.

Mobile Apps (App Builder)

Mobile apps are built with Expo and React Native. You can test on iOS and Android simulators or physical devices.

Prerequisites

  • Node.js 18 or later
  • iOS Simulator (macOS) or Android Emulator
  • Expo Go app on physical device (optional)

Commands

Navigate to your app directory:

cd builds/<your-app-slug>

Install dependencies:

npm install

Start the development server:

npx expo start

What to Expect

Expo will start a development server and display a QR code. Press i for iOS Simulator, a for Android Emulator, or scan the QR code with Expo Go on your phone.

Web3 Apps (dApp Builder)

Web3 apps are built with Next.js and include wallet integration. They run in any modern browser.

Prerequisites

  • Node.js 18 or later
  • A crypto wallet (MetaMask, Rainbow, etc.)
  • Modern browser (Chrome, Firefox, Safari, Edge)

Commands

Navigate to your dApp directory:

cd dapp-builds/<your-app-slug>

Install dependencies:

npm install

Start the development server:

npm run dev

What to Expect

Next.js will start on http://localhost:3000. Open this URL in your browser and connect your wallet to test the full experience.

AI Agents (Agent Builder)

AI agents are Node.js applications that can run standalone or be integrated into other systems.

Prerequisites

  • Node.js 18 or later
  • API keys for any integrated services (check README.md)

Commands

Navigate to your agent directory:

cd outputs/<your-agent-name>

Install dependencies:

npm install

Start the agent:

npm start

Configuration

Check the agent's README.md for configuration options. Most agents use environment variables for API keys and settings. Copy .env.example to .env and fill in required values.

Mini Apps (Mini App Builder)

Mini apps run inside the Base app and are built with Next.js and MiniKit SDK.

Prerequisites

  • Node.js 18 or later
  • Vercel account for deployment
  • Base app account (for publishing)

Commands

Navigate to your mini app directory:

cd builds/miniapps/<your-app-slug>/app

Install dependencies:

npm install

Start the development server:

npm run dev

What to Expect

Next.js will start on http://localhost:3000. For full testing, you'll need to deploy to Vercel and test within the Base app. See the artifacts/DEPLOYMENT.md file for deployment instructions.

Websites (Website Builder)

Production-ready websites built with Next.js 14, Tailwind CSS, and optimized for Core Web Vitals.

Prerequisites

  • Node.js 18 or later
  • Modern browser for testing

Commands

Navigate to your website directory:

cd website-builds/<your-site-slug>

Install dependencies:

npm install

Start the development server:

npm run dev

What to Expect

Next.js will start on http://localhost:3000. The website is optimized for Core Web Vitals and WCAG 2.1 AA accessibility. Check the audits/ directory for skills audit reports.

Common Issues

“Cannot find module” errors

Run npm install again. If the issue persists, delete node_modules and package-lock.json, then reinstall.

Expo won't connect to device

Ensure your computer and phone are on the same WiFi network. Try tunnel mode: npx expo start --tunnel

Wallet connection fails

Make sure your wallet browser extension is installed and unlocked. For mobile wallets, ensure you're using the wallet's built-in browser.

More Troubleshooting

Next Steps

What Gets GeneratedTroubleshootingFAQ