Skip to main content
Seemodo uses cloud sandboxes to run your generated applications. Each sandbox provides a complete development environment with a Vite dev server, package management, and AI integration.

​
Available Providers

​
Provider Comparison

FeatureModalE2BVercel
Default Timeout1 hour60 min15 min
Max Timeout24 hours60 min15 min
Seemodo AI✅ Built-in❌❌
Git Integration✅ Auto-commit❌❌
Package Managerpnpmnpmnpm
Startup Time~5 seconds~10 seconds~3 seconds
Best ForFull AI workflowQuick prototypesNext.js apps

​
Sandbox Lifecycle

​
Creating a Sandbox

A sandbox is automatically created when you:
  1. Generate a HiFi screen
  2. Click Generate Flow with HiFi mode
The process:
  1. Request new sandbox from provider
  2. Wait for container startup
  3. Initialize Vite dev server
  4. Start Seemodo AI (Modal only)
  5. Return preview URL

​
Sandbox States

StateDescription
InitializingSandbox is starting up
ReadyAll services running, preview available
ActiveUser is interacting with the sandbox
IdleNo recent activity
TerminatedSandbox has been stopped

​
Pre-installed Template

Modal sandboxes come with a pre-configured Vite + React + Tailwind template: 
/root/vite-app/
├── src/
│   ├── main.jsx
│   ├── App.jsx
│   └── index.css
├── public/
├── index.html
├── package.json
├── vite.config.js
├── tailwind.config.js
└── postcss.config.js

​
Configuration

All sandbox settings are in config/app.config.ts: 
export const appConfig = {
  // Modal Configuration
  modal: {
    timeoutMinutes: 60,
    backendUrl: process.env.MODAL_BACKEND_URL,
    vitePort: 5173,
    viteStartupDelay: 5000,
    workingDirectory: '/root/vite-app',
  },
  
  // E2B Configuration
  e2b: {
    timeoutMinutes: 60,
    vitePort: 5173,
    viteStartupDelay: 10000,
    workingDirectory: '/home/user/app',
  },
  
  // Vercel Configuration
  vercelSandbox: {
    timeoutMinutes: 15,
    devPort: 3000,
    devServerStartupDelay: 7000,
    workingDirectory: '/app',
  },
};

​
Terminal Access

Open the terminal to run commands directly in the sandbox:
  1. Click the Terminal button after a sandbox is active
  2. Use the built-in terminal or AI chat
Common commands: 
# View files
ls -la src/

# Install a package
pnpm add lodash

# Check for errors
cat vite.log

# View git history
git log --oneline

​
Downloading Your Project

Export your project as a ZIP file:
  1. Open the Sandbox Panel
  2. Click the Download button
  3. Receive a complete ZIP with:
    • All source files
    • package.json with dependencies
    • Configuration files
    • Git history (Modal only)
Run the downloaded project locally: 
unzip project.zip
cd project
pnpm install
pnpm dev

​
Troubleshooting

  • Check your provider API key/URL is correct
  • Verify the Modal backend is deployed
  • Check network connectivity
  • Look at browser console for errors
  • Wait for the Vite server to start (may take 5-10 seconds)
  • Check for build errors in the logs
  • Ensure the sandbox hasn’t timed out
  • Try refreshing the preview iframe
  • Verify the package name is correct
  • Check for network issues in the sandbox
  • Use pnpm instead of npm (Modal)
  • Restart Vite after installation
  • Ensure you’re using Modal provider
  • Wait for full sandbox initialization
  • Check Seemodo AI URL is available
  • Look for connection errors in the panel

​
Environment Variables

Sandboxes support environment variables for:
  • API keys (for external services)
  • Configuration flags
  • Feature toggles
Create a .env file in the sandbox or ask the AI to set up environment variables.
Never commit real API keys to generated code. Use environment variables and .env files.