========
Projects
========

A **project** is the top-level organizational unit in Eyrie. Every deployment
group, deployment, repository, and cloud provider belongs to a project.

Creating a Project
==================

Click **New Project** from the dashboard or the project list. You need to
provide:

- **Name** — a human-readable name (e.g. "My Company").
- **Slug** — a DNS-safe identifier used in URLs and subdomains. Must be unique
  and contain only lowercase letters, numbers, and hyphens.

The portal sends a ``POST`` to ``/_eyrie/api/projects`` to create the project.

.. image:: /static/img/project_list.png
   :alt: TODO — screenshot of the project list

.. image:: /static/img/create_project_dialog.png
   :alt: TODO — screenshot of the create project dialog

Project Settings
================

Open a project and navigate to **Settings** to configure:

- **Name** and **Slug** — can be updated after creation (slug changes affect
  all URLs).
- **Domain** — the base domain used for deployment subdomains.
- **Primary Deployment** — the deployment treated as the "main" instance for
  this project.

.. image:: /static/img/project_detail.png
   :alt: TODO — screenshot of the project detail page

Project Owner vs Members
========================

The user who creates a project becomes the **owner**. Owners have full control,
including the ability to delete deployment groups and manage billing. Other
users are added as **members** with specific roles (see :doc:`team`).