---
name: example-runner
description: Run and test spotify_sdk integration using the companion example app.
---

# Example App Runner (`example-runner`)

Run and test the plugin using the companion application in [example/](example).

## Setup

Create `.env` file at [example/.env](example/.env):
```ini
CLIENT_ID=your_spotify_client_id
REDIRECT_URL=your_spotify_redirect_url
```

## Running the App

### Mobile
```bash
cd example && flutter run
```

### Web
Run on Chrome with loopback IP for Spotify Web SDK compatibility:
```bash
cd example && flutter run -d chrome --web-hostname=127.0.0.1 --web-port=8080
```