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

# Create a project

> Create a new project in the Nexus console.

A project represents a single application or product - with its own services, environments, secrets, configs, and feature flags.

## Steps

<Steps>
  <Step title="Open the Projects page">
    In the left sidebar, click **Projects**.

    Then click the **+ New Project** button in the top-right corner.
  </Step>

  <Step title="Name your project">
    Enter a name for your project. This is used as an identifier - for example in the CLI - so short and descriptive works best.
  </Step>

  <Step title="Choose a tier">
    Select the tier that matches your needs. Each tier defines your resource quotas: number of services per environment, secrets, configs, flags, and audit history length.

    <img className="block dark:hidden" src="https://mintcdn.com/westyx/6oY3xqlJDchRixx-/images/how-to/create-project/light-new-project.png?fit=max&auto=format&n=6oY3xqlJDchRixx-&q=85&s=d2f67f72551a7648f840495344e6de79" alt="New project dialog" style={{ borderRadius: '8px', margin: '1rem 0' }} width="531" height="787" data-path="images/how-to/create-project/light-new-project.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/westyx/6oY3xqlJDchRixx-/images/how-to/create-project/dark-new-project.png?fit=max&auto=format&n=6oY3xqlJDchRixx-&q=85&s=ca38388ee15a57a00e9381fa94176d56" alt="New project dialog" style={{ borderRadius: '8px', margin: '1rem 0' }} width="536" height="788" data-path="images/how-to/create-project/dark-new-project.png" />

    Use the **Compare all tiers →** link to open the full Plans & Tiers page in the console.

    | Tier   | Environments                                      | Notes                       |
    | ------ | ------------------------------------------------- | --------------------------- |
    | `free` | develop                                           | Always free, no card needed |
    | `xs`   | develop, prod                                     | First paid tier             |
    | `s`    | develop, test, prod                               | Adds test environment       |
    | `m`    | develop, test, staging, prod                      | Mid-scale                   |
    | `l`    | develop, test, staging, qa, prod-blue, prod-green | Large scale                 |
    | `xl`   | All of the above                                  | Unlimited resources         |

    You can upgrade the tier at any time from Project Settings.
  </Step>

  <Step title="Choose an authentication mode">
    | Mode        | Description                                                                                                                                                                                 |
    | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **API Key** | Services authenticate with secret key (`wxs_`, backend) or public key (`wxp_`, frontend) pairs. Simple to set up.                                                                           |
    | **WIF**     | Workload Identity Federation - keyless authentication via OIDC trust. Compatible with GCP, AWS, Azure, and Kubernetes. More secure since no static API keys are stored in your deployments. |

    <Note>
      WIF requires the **L** or **XL** tier, or the **Security Add-On** (\$5 / project / month) on lower tiers.
    </Note>

    You can migrate between modes later from the project's **Auth** tab.
  </Step>

  <Step title="Set the timezone">
    The project timezone defaults to your tenant's timezone. Override it here if the project serves a different market or region.

    This setting is used by the anomaly detection system: activity outside of business hours in the configured timezone may trigger a suspicious behaviour alert.
  </Step>

  <Step title="Create the project">
    Click **Create project**. You will be returned to the Projects list.

    Click on your new project to open it. From here you can manage services, environments, members, security, add-ons, snapshots, logs, and settings.

    <img className="block dark:hidden" src="https://mintcdn.com/westyx/6oY3xqlJDchRixx-/images/how-to/create-project/light-empty-project.png?fit=max&auto=format&n=6oY3xqlJDchRixx-&q=85&s=97522cd25065eca099a3a37d8c7a9a76" alt="Project detail page" style={{ borderRadius: '8px', margin: '1rem 0' }} width="1602" height="825" data-path="images/how-to/create-project/light-empty-project.png" />

    <img className="hidden dark:block" src="https://mintcdn.com/westyx/6oY3xqlJDchRixx-/images/how-to/create-project/dark-empty-project.png?fit=max&auto=format&n=6oY3xqlJDchRixx-&q=85&s=6ff59969f21308b505d95eed49d0730e" alt="Project detail page" style={{ borderRadius: '8px', margin: '1rem 0' }} width="1602" height="825" data-path="images/how-to/create-project/dark-empty-project.png" />
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Create a service" icon="gear" href="/how-to/create-service">
    Add a backend or frontend service to your project.
  </Card>

  <Card title="Plans & Tiers" icon="chart-bar" href="https://nexus.westyx.dev/plans">
    Compare all available tiers and quotas.
  </Card>
</CardGroup>