> ## Documentation Index
> Fetch the complete documentation index at: https://docs.beyondwords.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting started

You will first need to have created a [project](/docs-and-guides/getting-started/concepts#projects) with some [articles](/docs-and-guides/getting-started/concepts#articles) generated.

## First steps

### Add the dependency to your Podfile

```javascript theme={null}
target 'MyApp' do
  pod 'BeyondWordsPlayer'
end
```

As an alternative you can also use the XCFramework attached to the assets of the latest [GitHub Release](https://github.com/beyondwords-io/player-ios/releases/)

### Add PlayerView to your view hierarchy

```javascript theme={null}
let playerView = PlayerView()
playerViewParent.addSubview(playerView)
```

### Load your content into the player

```javascript theme={null}
playerView.load(PlayerSettings(
    projectId: <ID>,
    contentId: <ID>
))
```

You will need to replace the `<ID>` placeholders with the real identifiers for your project and content.

After running the app, the player should load.

## How it works

The PlayerView uses a WKWebView under the hood to load the [Web Player](https://github.com/beyondwords-io/player?tab=readme-ov-file) and provides a Swift interface which binds to the underlying JavaScript API.

You can check the API compatibility between the iOS and the Web player in the [compatibility settings](/docs-and-guides/distribution/player/sdk/javascript/player-settings#player-settings-compatibility-across-sdks).

To understand how the underlying Web Player works, please refer to its [documentation](/docs-and-guides/distribution/player/sdk/javascript/getting-started).

## How to configure it

The preferred way to configure the player is by logging into the BeyondWords dashboard, going to the Player tab, and changing its settings.

However, you can also override properties at the app level, for example:

```javascript theme={null}
playerView.load(PlayerSettings(
    projectId: <ID>,
    contentId: <ID>,
    playerStyle: "large",
    callToAction: "Listen to this recipe",
    backgroundColor: "yellow",
))
```

These settings will take precedence over those specified in the dashboard and allow more flexibility.

These settings can also be changed after loading the player, for example:

```javascript theme={null}
playerView.setPlayerStyle("large")
playerView.setBackgroundColor("yellow")
playerView.setPlaybackRate(1.5F)
```

You can also refer to [example app](https://github.com/beyondwords-io/player-ios/tree/main/Example) which showcases the core functionality of the player, including how to build a custom UI.

## iOS SDK Github repository

<Card title="iOS SDK Documentation" icon="apple" href="https://github.com/beyondwords-io/player-ios" target="_blank">
  View the iOS SDK documentation in our GitHub repository
</Card>

Compatability