# Flutter SDK quick start

Get started with the Pushwoosh Flutter SDK using this quick and simple example

## Prerequisites

To integrate the Pushwoosh Flutter SDK into your app, you will need the following:

<TranslatedFragment id="prerequisites-plugins" />

## Download the example project

```bash
# Clone the SDK repository and navigate to the example project
git clone https://github.com/Pushwoosh/pushwoosh-flutter

# Navigate to example directory
cd pushwoosh-flutter/Source/pushwoosh/example
```

## Configure the project

Install the dependencies:

```bash
flutter pub get
```

Open **lib/main.dart** and update the Pushwoosh.initialize call:

```dart
Pushwoosh.initialize({"app_id": "XXXXX-XXXXX"});
```

Replace the `app_id` value with your **Pushwoosh App Code**.

### iOS

###### 1. Install dependencies

Navigate to the ios directory and install the dependencies:

```bash
cd ios && pod install --repo-update
```

###### 2. Set the Bundle Identifier

Open the **ios/Runner.xcworkspace** file in Xcode.

Set the **Bundle Identifier** for each target:

- `Runner`: your app's package name. (eg. com.example.pushwoosh)
- `NotificationService`: your app's package name with `.NotificationServiceExtension` (eg. com.example.pushwoosh.NotificationServiceExtension)
- `StopwatchWidgetExtension`: your app's package name with `.StopwatchWidget` (eg. com.example.pushwoosh.StopwatchWidget)

###### 3. Set the API Token

In your `ios/Runner/Info.plist` set the `Pushwoosh_API_TOKEN` key to the [Pushwoosh Device API Token](/developer/api-reference/api-access-token/#device-api-token)



### Android

###### 1. Setup google-services.json

Copy your `google-services.json` file to the **android/app** directory

###### 2. Set the package name

Open **android/app/build.gradle** and set the **applicationId** to your app's package name. (eg. `com.example.pushwoosh`)

###### 3. Set the API Token

Open your **android/app/src/main/AndroidManifest.xml** file and add the following metadata inside the `<application>` tag:

```xml title="AndroidManifest.xml"
<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__" />
```
Replace `__YOUR_PUSHWOOSH_DEVICE_API_TOKEN__` with your [Pushwoosh Device API Token](/developer/api-reference/api-access-token/#device-api-token).


## Run the project

1. Build and run the project.
2. The app will have two tabs: "Actions" and "Settings". Navigate to the **Settings** tab.
3. Tap the **Register for Pushes** button.
4. Grant permission for push notifications. The device will be registered with Pushwoosh.

## Send a push notification

Go back to the Pushwoosh Control Panel and [send a push notification](/product/messaging-channels/push-notifications/send-push-notifications/one-time-push) to your registered device.