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

# Project Settings

> Configure your app's identity, permissions, and capabilities

# Project Settings

Project Settings is where you configure everything about your app — its name, icon, what device features it can access, and more.

## Accessing Settings

1. Open your project in Nativeline
2. Click the **Settings** tab in the sidebar
3. Browse the settings categories

***

## Settings Categories

<CardGroup cols={2}>
  <Card title="App Identity" icon="id-card" href="/features/app-identity">
    Name, icon, version, bundle ID
  </Card>

  <Card title="Permissions" icon="lock" href="/features/permissions">
    Camera, location, photos, etc.
  </Card>

  <Card title="Capabilities" icon="wand-magic-sparkles" href="/features/capabilities">
    Push notifications, Sign in with Apple, etc.
  </Card>

  <Card title="Appearance" icon="palette" href="/features/appearance">
    Light mode, dark mode, colors
  </Card>
</CardGroup>

***

## App Identity

Control how your app identifies itself:

| Setting          | Description                     |
| ---------------- | ------------------------------- |
| **Display Name** | Name shown under app icon       |
| **App Icon**     | The icon users see              |
| **Version**      | Version number (1.0, 1.1, etc.) |
| **Build Number** | Internal build identifier       |
| **Bundle ID**    | Unique app identifier           |

[Learn more about App Identity →](/features/app-identity)

***

## Permissions

Control what device features your app can access:

| Permission        | Use Case                  |
| ----------------- | ------------------------- |
| **Camera**        | Taking photos/videos      |
| **Photo Library** | Selecting existing photos |
| **Location**      | Maps, local content       |
| **Microphone**    | Audio recording           |
| **Contacts**      | Accessing address book    |
| **Calendar**      | Reading/writing events    |
| **Notifications** | Push alerts               |

Each permission requires a **usage description** — a message explaining why your app needs access.

[Learn more about Permissions →](/features/permissions)

***

## Capabilities

Advanced iOS features that require special entitlements:

| Capability             | What It Enables         |
| ---------------------- | ----------------------- |
| **Push Notifications** | Send alerts to users    |
| **Sign in with Apple** | Apple ID authentication |
| **HealthKit**          | Access health data      |
| **HomeKit**            | Smart home control      |
| **CloudKit**           | iCloud storage          |
| **In-App Purchase**    | Selling content         |

Some capabilities require an Apple Developer account.

[Learn more about Capabilities →](/features/capabilities)

***

## Appearance

Control your app's visual presentation:

| Setting             | Options               |
| ------------------- | --------------------- |
| **Appearance Mode** | Light, Dark, System   |
| **Accent Color**    | Primary app color     |
| **Status Bar**      | Light or dark content |

[Learn more about Appearance →](/features/appearance)

***

## When to Use Settings vs Chat

### Use Settings For:

* Changing app name/icon
* Adding permissions
* Enabling capabilities
* Setting appearance mode

### Use Chat For:

* Designing UI
* Adding features
* Creating screens
* Business logic

***

## Settings and TestFlight

Before publishing to TestFlight, review:

1. **App Identity** — Name and icon correct?
2. **Version** — Updated version number?
3. **Permissions** — All needed permissions enabled?
4. **Capabilities** — Required capabilities active?

[Publishing to TestFlight →](/publishing/testflight/overview)

***

## Common Settings Tasks

<AccordionGroup>
  <Accordion title="Change my app's name" icon="signature">
    Settings → App Identity → Display Name
  </Accordion>

  <Accordion title="Update the app icon" icon="image">
    Settings → App Identity → App Icon → Upload new image
  </Accordion>

  <Accordion title="Add camera access" icon="camera">
    Settings → Permissions → Camera → Enable
  </Accordion>

  <Accordion title="Enable push notifications" icon="bell">
    Settings → Capabilities → Push Notifications → Enable

    *Requires Apple Developer account*
  </Accordion>

  <Accordion title="Support dark mode" icon="moon">
    Settings → Appearance → Mode → System (or Dark)
  </Accordion>
</AccordionGroup>

***

## Related Pages

<CardGroup cols={2}>
  <Card title="App Identity" icon="id-card" href="/features/app-identity">
    Name, icon, and identifiers
  </Card>

  <Card title="Permissions" icon="lock" href="/features/permissions">
    Device feature access
  </Card>

  <Card title="Capabilities" icon="wand-magic-sparkles" href="/features/capabilities">
    Advanced iOS features
  </Card>

  <Card title="Appearance" icon="palette" href="/features/appearance">
    Visual settings
  </Card>
</CardGroup>