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

# Quickstart

> From sign-up to your first matched install in about fifteen minutes.

<Steps>
  <Step title="Create your app">
    Sign in at [app.trueorigin.dev](https://app.trueorigin.dev) and create an app. Find it
    in the App Store search and the details fill in; an app that is not live yet can be
    entered by hand.

    The **Link name** becomes the first part of every tracking link,
    `appdownload.link/{link name}/…`. It cannot change later.

    When the app is created, the dashboard shows your **SDK key** (`to_…`) once. Copy it.
    If you lose it, rotate it in **Settings → SDK key**.
  </Step>

  <Step title="Add the SDK">
    <Tabs>
      <Tab title="Swift">
        In Xcode: **File → Add Package Dependencies…**, paste
        `https://github.com/trueorigin-dev/trueorigin-ios` and add the package. Then
        configure it at launch:

        ```swift theme={null}
        import TrueOrigin

        TrueOrigin.configure(apiKey: "to_…")
        ```
      </Tab>

      <Tab title="React Native">
        ```bash theme={null}
        npx expo install @trueorigin/react-native
        npx expo prebuild
        ```

        Then configure it at the top of your root layout:

        ```ts theme={null}
        import TrueOrigin from '@trueorigin/react-native'

        TrueOrigin.configure('to_…')
        ```

        This needs a new native build; Expo Go does not include the module.
      </Tab>
    </Tabs>

    Details: [iOS SDK](/sdk/ios), [React Native](/sdk/react-native).
  </Step>

  <Step title="Create a tracking link">
    In **Tracking links → New link**, choose a path (for example `summer`) and enter your
    App Store URL. The link is live within about 15 seconds:
    `https://appdownload.link/{link name}/summer`.
  </Step>

  <Step title="Test it on an iPhone">
    Tap the tracking link on an iPhone, then install your build on that same iPhone and
    open it. The match shows in **Live activity** within seconds.
  </Step>

  <Step title="Put the link in your ads">
    Use the link as the ad's website URL and add the network's URL parameters, so every
    install carries its campaign, ad set and ad. See [Tracking links](/tracking-links).
  </Step>
</Steps>

## Then

<CardGroup cols={3}>
  <Card title="RevenueCat" icon="coins" href="/revenuecat">
    Trials and revenue per campaign.
  </Card>

  <Card title="Postbacks" icon="arrow-right-arrow-left" href="/postbacks">
    Send installs and purchases back to Meta and TikTok.
  </Card>

  <Card title="Ad spend" icon="chart-line" href="/ad-spend">
    CPI and ROAS from a Meta or TikTok CSV.
  </Card>
</CardGroup>