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

# Getting Started

> Install the CamoAg iOS app, grant location access, and set the four preferences that shape how the map behaves in the field.

The CamoAg iOS app is built for working from the truck: a full-screen map, your
saved contacts, farms and notes one tap away, and turn-by-turn directions to
anything you can find. This page covers installing the app and the handful of
settings worth getting right before your first drive.

<Note>
  Not every feature of the CamoAg platform is available in the app. See
  [CamoAg iOS App for Apple](/mobile/camoag-ios-app-for-apple) for the full
  desktop-versus-app comparison and the download links.
</Note>

## Install and sign in

<Steps>
  <Step title="Download the app">
    Install [CamoAg from the App Store](https://apps.apple.com/us/app/camoag/id6745523708),
    or search the App Store for "camo ag."

    If you previously added the CamoAg web platform to your home screen, delete
    that shortcut first.
  </Step>

  <Step title="Sign in">
    Sign in with your CamoAg email and password, Google, Apple, or through your
    organization's single sign-on if your company uses it.
  </Step>

  <Step title="Turn on Face ID or Touch ID (optional)">
    Under **Settings**, enable **Use Face ID to Unlock** so you don't have to
    retype your password each time. This option doesn't appear for single
    sign-on accounts.
  </Step>
</Steps>

## Allow location sharing

The map centers on you, the **Nearby** lists measure distance from you, and
turn-by-turn navigation routes from you — all of which need location access.

The first time you open the map, iOS asks for permission and shows CamoAg's
reason: *"We need your location to show your position on the map and track your
movement."*

<CardGroup cols={2}>
  <Card title="While Using the App" icon="location-arrow">
    The minimum for the map, Nearby lists, and navigation while the app is open
    on screen.
  </Card>

  <Card title="Always" icon="location-crosshairs">
    Keeps your position updating when the app is in the background — which is
    what keeps navigation and CarPlay accurate when you switch away to take a
    call.
  </Card>
</CardGroup>

If you tapped "Don't Allow" and the map won't follow you, re-enable it in the
iOS **Settings** app under **CamoAg → Location**.

On the map, the **GPS** button in the upper-right column re-centers the map on
your location and resumes following you after you've panned away.

## Face my direction vs. Face north

**Default Compass Behavior** controls which way the map points:

| Option                | What it does                                    |
| --------------------- | ----------------------------------------------- |
| **Face North**        | North stays at the top of the map.              |
| **Face my direction** | The map rotates to match the way you're facing. |

Set the default under **Settings → Default Compass Behavior**. You can flip
between the two at any time by tapping the compass icon on the map — the setting
only decides where you start.

<Tip>
  The same preference drives CarPlay. Toggling **North Always Up** from the
  CarPlay Settings screen changes the orientation on your phone too, and vice
  versa.
</Tip>

## Set your default locations

Default locations are counties. They tell CamoAg where you work, which
determines the farms and data surfaced to you first and where the map opens when
your location isn't available.

<Steps>
  <Step title="Open Settings">
    Scroll to **Default Locations** at the top of the settings screen.
  </Step>

  <Step title="Tap Add Location">
    Search for a county by name and select it.
  </Step>

  <Step title="Add as many as you cover">
    Locations are listed in order as Location 1, Location 2, and so on. Tap the
    remove button next to any location to delete it.
  </Step>
</Steps>

Default locations are stored on your CamoAg account, so they follow you between
the app and the web platform.

## Default Directions App

**Default Directions App** decides what opens when you tap **Directions** on a
contact, farm, parcel, or operation:

* **Ask each time** — CamoAg prompts you to choose at the moment you tap.
* **CamoAg** — routes inside the app, with turn-by-turn guidance that carries
  over to CarPlay.
* **Apple Maps**
* **Google Maps**

<Note>
  Tapping **Directions** on a detail card *in CarPlay* always uses CamoAg's
  in-app navigation, regardless of this setting — handing the route off to
  another app mid-drive isn't safe on the car screen.
</Note>

<Frame>
  <iframe src="https://www.youtube.com/embed/N8LCqMEDXFQ" title="Directions to a farm with the CamoAg app" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />
</Frame>

## Getting around the map

<CardGroup cols={3}>
  <Card title="Layers" icon="layer-group">
    The stacked-squares button in the upper right opens map filters — which data
    layers are drawn and which base map you're on.
  </Card>

  <Card title="GPS" icon="crosshairs">
    Re-centers on your location and resumes following.
  </Card>

  <Card title="Compass" icon="compass">
    Toggles between Face North and Face my direction.
  </Card>
</CardGroup>

The sheet at the bottom of the map is the main control panel. Drag it up for
search and your full lists; the three buttons across it open
[Contacts](/ios/contacts), [Farms](/ios/farms), and [Notes](/ios/notes). The
notes button floating above the sheet starts a new note from wherever you are.

## Keep going

<CardGroup cols={2}>
  <Card title="CarPlay" icon="car" href="/ios/carplay">
    Run CamoAg on the car screen — Explore, Nearby lists, voice search, and
    turn-by-turn.
  </Card>

  <Card title="Notes" icon="microphone" href="/ios/notes">
    Record a visit by voice and let CamoAg write the summary.
  </Card>
</CardGroup>

More how-to videos live on our YouTube channel in the
[CamoAg App with CarPlay](https://www.youtube.com/playlist?list=PLMzwUQrbGI2qQNzHnI6sfrFlRsWqGZzlK)
playlist.