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

# Projects

> Organize apps and sessions inside a Synheart Platform project

Projects are the unit of work in the platform. They group the apps you've registered and the sessions those apps produce. Every project lives inside a [tenant](/platform/organizations-and-tenants) inside an organization, a logical grouping for one product or initiative.

```text theme={null}
Project
  ├── Apps      (one or more registered Apps, each with its own platform `app_id`)
  └── Sessions  (usage events with biosignals + emotions)
```

## Create a project

From the developer portal, open **Projects** and choose **New project**. You'll set:

* **Name** and optional **description**.
* **Region**: where this project's data is stored. New projects default to **N. Virginia (`us-east-1`)**. Choosing a different region is an **Enterprise** feature; Enterprise plans can pick from the standard region list (e.g. `eu-west-1`, `ap-southeast-2`, `ca-central-1`). Need a region that isn't listed? Contact support.
* **Tenant**: which tenant workspace inside your org owns the project.
* **Status**: `active`, `archived`, or `setup_incomplete` for a project you're still wiring up.

A project starts empty. Add apps next.

## Add apps to a project

Each registered App in a project has a platform `app_id` assigned by the dashboard. Register one from inside the project; see [Register an app](/platform/developer-portal#register-an-app). One project can hold multiple apps; a given `app_id` belongs to exactly one project at a time.

## Wearables

For connecting wearable integrations and viewing the data they produce, see [Connect wearables & view data](/platform/connect-and-view-data), which covers the full setup flow end to end.

## Sessions

A session is one usage event captured on-device and ingested into the platform. Sessions surface under the project's **Sessions** tab once the apps in the project ingest them via an allowlisted API key. See [API keys → Ingestion access](/platform/api-keys#ingestion-access) for how that allowlist works, and [Synheart Session](/synheart-session/overview) for how sessions are produced on-device.

## Project settings

Each project exposes a settings page for renaming, archiving, and managing access. Archive projects you're no longer working in rather than deleting them; archived projects stay readable but step out of the active list.

## Patterns that work well

* **One project per environment**: keep dev, staging, and prod data isolated.
* **Project per study or cohort**: for research, give each cohort its own project so you can scope keys and access cleanly.

## Next

<CardGroup cols={2}>
  <Card title="API keys" icon="key" href="/platform/api-keys">
    Generate scoped keys for the apps in your project.
  </Card>

  <Card title="Connect wearables & view data" icon="route" href="/platform/connect-and-view-data">
    Connect a wearable integration and explore the session data it produces.
  </Card>

  <Card title="Synheart Session" icon="heart-pulse" href="/synheart-session/overview">
    See how sessions are produced on-device before they reach the platform.
  </Card>
</CardGroup>
