# Test & Preview Your Project

> Choose the right testing method based on your target: web app/PWA, native iOS-Android app, or Windows desktop application.


https://docs.pandasuite.com/essentials/project-management/test-and-preview-your-project/

**An interface that seems perfect in the editor may behave differently on an iPhone SE, Surface Pro, or a slow browser. Testing early and on the right device prevents surprises during deployment.**

[Video: Getting started tutorial: testing your PandaSuite application before publishing it](https://www.youtube.com/embed/aAjCnxoKAeo?&hl=en&cc_lang_pref=en&cc_load_policy=1)

## Overview

When you create a PandaSuite project, it can be delivered in several formats:

1. as a **website or web app** (browser),
2. as a **mobile application** (iOS & Android),
3. as a **Windows application** (`.exe` file).

PandaSuite handles the technical aspects (generating the appropriate code for each platform), but **you** ensure everything functions on the target devices before publishing or deploying.

---

## Testing Modes Overview

PandaSuite offers you several ways to test your project based on the intended format:

| Distribution Format | Where to Test Quickly?                              |
| ------------------- | --------------------------------------------------- |
| **Web app / PWA**   | Web Preview (in Studio) + Share Link                |
| **iOS**             | PandaSuite Viewer (iPhone/iPad) or TestFlight build |
| **Android**         | PandaSuite Viewer (Android) or APK/AAB build        |
| **Windows**         | Share Link (Chrome/Edge) then .exe build            |

---

## Testing the Web Version

### Integrated Preview (in PandaSuite Studio)

[Video: Preview opens the app in a phone frame over the Studio, a tap on Procedure changes screen, the cross closes it]

1. Click on the **Preview** icon ▶️ in the top bar of Studio.
2. The preview opens above your workspace, in a phone frame.
3. Click the cross at the top right to return to editing.

> **Info: Display another screen**
>
> The preview starts from the selected screen. To display another screen that is
> not accessible via navigation, use the side panel or select that screen and
> relaunch **Preview**.

> **Info: Test responsiveness**
>
> Click on **Predefined screens** to switch from an iPhone SE (375×667) to an
> iPad Pro (1024×1366) or a computer (1280×800). Activate **Responsive** to grab
> the handle and manually resize the window.

> **Warning: Simulation Limitations**
>
> Hardware sensors (gyroscope, GPS, push notifications…) are not simulated here.
> Switch to PandaSuite Viewer when your prototype uses them.

### Share Link (Browser Outside Studio)

[Image: Share the project window in Studio: the Web link of the project, its Copy button and its QR code are framed]

1. In Studio, click **Share** in the top bar.
2. Keep **Web** selected, then copy the link with **Copy** or scan the **QR code**.
3. Open it in Chrome, Safari, Edge… on a computer, tablet, or mobile **without installing anything**.

Advantages:

- Nothing to install.
- The link automatically reflects each new **Save**: no need to resend it.
- Ideal for checking the web app/PWA under real network conditions.

---

## Testing on Native iOS & Android

[Image: PandaSuite Viewer on an iPad and an iPhone: the account's project list, downloaded or with an update available]

### Open the project from Studio

1. Save your project in Studio.
2. Click the arrow next to **Preview** ▶ in the top bar. The **Test on your phone** menu shows a QR code.
3. Scan the code with your phone’s camera: the project opens in PandaSuite Viewer. Without the app, it opens in the browser.

[Image: Test on your phone menu open from the arrow next to Preview in the Studio: the arrow and the QR code of the project are framed]

The code opens the version you are editing, as last saved, not the production version. To copy its link, click the icon next to the link.

Don’t have the app yet? In the same menu, click **Install** next to **PandaSuite Viewer**: scan the code that appears to install the free app, or use the **App Store** and **Google Play** buttons, then scan the project’s code.

### Open the project from the app

1. Install **PandaSuite Viewer** from the App Store or Google Play.
2. Log in with the **same account** as in Studio.
3. Tap your project: it downloads and then opens.

Points to check:

- Touch gestures (scrolling, pinching, rotating).
- Offline functionality: put the device in Airplane mode and relaunch.
- Sensors: camera, microphone, GPS if your app uses them.

> **Info: Export IPA and APK**
>
> PandaSuite Viewer is perfect for testing: it reproduces the final behavior of
> your application. Once everything is validated, you will create a **final
> build** (IPA or APK/AAB file) to test via Testflight (iOS), deploy directly,
> or publish on the App Store and Google Play.

---

## Testing the Windows Version (EXE)

1. Open your **share link** in Edge or Chrome: this is often sufficient for visual control and navigation.
2. Before production, export a **.exe file** from your Dashboard, install it on a PC, and ensure:
   - Full-screen or windowed display.
   - Mouse usage (right-click, scroll wheel).
   - Offline access if necessary.

---

## Sharing with Other Testers

1. In Studio, click **Share**.
2. Copy the link, show its QR code, or send it with **Send e-mail**. Choose **Mobile** for testers who use PandaSuite Viewer: the link opens the project in the app when it is installed.

Learn more in [Sharing Link](https://docs.pandasuite.com/essentials/project-management/sharing-link/).

---

## Branding

Whatever the preview mode (share link, PandaSuite Viewer), your project opens in a **PandaSuite-marked testing environment**:

- URL in `*.pandasuite.com`
- PandaSuite Viewer icon and splash screen
- PandaSuite logo in the share link

To publish **white-label** (custom URL, your choice of icon and splash screen, mention removal), you’ll need to **export or publish** your project and have a suitable **distribution plan**.

---

## Checklist for Your Tests

For each platform, remember to check:

- [ ] Smooth navigation from one screen to another
- [ ] Readable text and clear images
- [ ] Responsive and interactive buttons
- [ ] Sounds/videos playing correctly
- [ ] Offline behavior (if your app should work without a network)
- [ ] Sensors or system permissions accepted (camera, microphone, GPS…)
- [ ] No slowdowns or crashes after several minutes of use

---

## Recommended Testing Cycle

1. **Micro-checks**: after each action or component added, make a quick Preview.
2. **Real Devices**: test your project on multiple devices different from your target and format of destination.
3. **Save Your Versions**: duplicate your project and keep old versions before major updates.
   > **Info**
   >
   > If you notice unusual behavior/bug, fill out the bug form and provide as
   > much detail as possible (version, device, etc.):
   > <https://pandasuite.com/dashboard/report-bug>
