Skip to main content
Testing your mini app before launch ensures it functions correctly, displays properly, and provides the user experience you intended. You can test your app using a few different methods, each suited for different stages of development and testing needs. The only requirement is to have your mini app publicly accessible URL via https://.

Base Build Preview Tool

Preview and debug your mini app to ensure it displays correctly in the Base App using the Preview Tool.
Your browser’s console won’t show Base-specific logs. Base.dev console provides logs specific to how your mini app works within the Base app, including user context and Base app-specific functionality.

Best for

  • Validating correctness of manifest files and required fields
  • Using an interactive console for viewing logs
  • Signing your app’s manifest

Not ideal for testing

  • Full look and feel on your app in Base app
  • Chat and Base app specific functionality
  • User context functionality

Steps

  1. Navigate to Base.dev/preview
  2. Log in using your Base app account
  3. Paste your app’s url in the field
  4. Click Submit

Base app

Preview how your app would function directly using the Base App.

Best for

  • Keeping your app private from the feed
  • Preview in-app functionality (UX)
  • Chat-based applications
  • Apps that require user and Base app context

Not ideal for testing

  • Logs
  • Validating correctness of manifest file

Steps

  1. Enable Developer Mode: Open Base App > Privacy & Security > toggle Developer Mode
  2. Open preview: Settings > Developer > Preview
  3. Enter the URL of your mini app
  4. Click Preview

In-feed and DMs

Preview your app by posting the URL directly in the Base app feed or by sending a DM to another user.

Best for

  • Requesting feedback from the public
  • Apps that require user and Base app context
  • Testing edge cases

Not ideal for

  • Viewing logs
  • Validating correctness of manifest file