V
Vibeview
Pricing
Sign In

Getting Started with VibeView

VibeView is a cloud simulator streaming platform that lets you run iOS and Android simulators in the browser, install your apps, and run AI-powered tests against them. This guide walks you through the core workflow from signup to your first AI test.

Prerequisites

  • A modern web browser (Chrome, Firefox, Safari, or Edge).
  • An .app bundle for iOS (simulator build), or an .apk file for Android, ready to upload.

1. Sign Up and Join an Organization

  1. Navigate to the VibeView login page and click Sign Up.
  2. Enter your email and create a password.
  3. An organization is created automatically when you sign up. All your apps, devices, and tests are scoped to this organization.
  4. You are signed in immediately, and VibeView sends a verification email to your address. Until you verify, the dashboard shows a Verify your email screen.
  5. Open the email from noreply@info.vibeview.io and click the verification link. Once your email is verified, the dashboard unlocks.

If you are joining an existing team, ask your organization admin to invite you. You will receive an invitation email with a link to complete your account setup. Because the invitation is bound to your email address, no separate email verification is needed — your account works right away.

Verifying your email

If the verification link has expired or you did not receive the email: click Resend verification email on the Verify your email screen. Verification links expire after 24 hours; once you click a valid link, your account is fully activated.

2. Upload Your First App

  1. From the sidebar, navigate to Apps.
  2. Click Upload App.
  3. Drop in or select your build file:
    • iOS: .app bundle (exported as simulator build from Xcode)
    • Android: .apk
  4. Optionally add a note describing the build (e.g., a version or branch name).
  5. Click Upload. The file is validated and stored, and the app name and package identifier are extracted from the binary automatically. Uploads are limited to 500 MB.

Each upload creates a new build version, so you can track changes over time and install any version on a simulator later.

3. Launch a Simulator

  1. From the sidebar, navigate to Device Sandbox.
  2. Pick a device from the device menu — models are grouped by platform (iOS Phones, iOS Tablets, Android Phones, Android Tablets, and TV devices).
  3. Click Start Session.

The simulator boots in the cloud and streams to your browser via low-latency WebSocket streaming. You can interact with it directly — tap, swipe, type, and press hardware buttons — just as you would on a physical device. This is how you explore a bare device without any app installed.

4. Install and Run Your App

To run your app, launch the sandbox from the Apps page instead — it is the app-centric entry point, and the sandbox installs your app automatically:

  1. From the sidebar, navigate to Apps.
  2. Click the Start (play) button on your app’s card. To test a specific build instead of the latest, open the app and click the play button next to that build in Build History.
  3. The Device Sandbox opens with your app preselected. Pick a device and click Start Session.
  4. Once the session is active, the selected build installs and launches automatically. You can interact with it in real time through the browser.

5. Run Your First AI Test

VibeView includes an AI agent that can execute test steps on a simulator using natural language instructions.

  1. From the sidebar, navigate to Apps and open your app.
  2. Click New Suite and give it a name.
  3. Open the suite (the Cases tab opens by default) and click Record New Test Case. The Device Sandbox opens with recording enabled.
  4. Perform the flow you want to test — your taps, swipes, and typing are captured as you go. When you’re done, stop the recording and click Generate AI Test.
  5. Review the generated plain-language steps, for example:
    • Tap the "Sign In" button
    • Type "user@example.com" into the email field
    • Assert that the text "Welcome" is visible
  6. Click Save as AI Test, then run the case from its suite page.

The AI agent launches a simulator, installs your app, and executes each step. It reads the UI tree to locate elements, performs actions, and evaluates assertions. Results appear in a step-by-step timeline showing pass/fail status for each step.

Execution Modes

When running a test, you choose the execution mode:

  • Hybrid (default): Replays previously recorded actions first, then falls back to the AI agent for any steps that cannot be replayed. This is the fastest option for regression testing.
  • AI Only: Every step is handled by the AI agent from scratch. Use this when testing new flows or when the UI has changed significantly.

A third mode — replay-only (recorded actions with no AI fallback, for deterministic regression runs) — is available when triggering runs via the API or CLI.

Next Steps

  • Choose your AI setup — AI tests work out of the box on VibeView-provided models, billed to your plan’s included usage credit. Prefer your own provider account? Add an API key for Anthropic, OpenAI, Google, or OpenRouter under Settings → AI Configuration (BYOK) — BYOK runs bypass usage credit entirely.
  • Invite your team — Add teammates to your organization so they can access shared apps, devices, and test results.
  • Explore test suites — Group related test cases into suites, run them in batch, and review results across builds.
  • Integrate with your CI pipeline — Use the VibeView CLI to upload builds and run tests from your build system — see the Integration Guide.