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

# General

A project is the container for one shopping experience — its data, its API surface, its releases, and its settings. This page covers creating a new project and the general settings that live at the project root.

## Create a project

From the [admin app](https://app.frontic.com), open **Settings → Projects** and click **Add Project**.

<Screenshot name="essentials/setup/settings-add-project" alt="Create Project dialog with name, description, and Active toggle" view="dialog" />

<Frame>
  <img src="https://mintcdn.com/frontic/ubHGK0ZpbAzUx53w/images/essentials/setup/settings-add-project-light.png?fit=max&auto=format&n=ubHGK0ZpbAzUx53w&q=85&s=12450b35782198161ddf537ad660c1cc" className="dark:hidden block mx-auto mt-5 mb-5" style={{ maxWidth: "360px" }} alt="Create Project dialog with name, description, and Active toggle" width="1144" height="868" data-path="images/essentials/setup/settings-add-project-light.png" />

  <img src="https://mintcdn.com/frontic/ubHGK0ZpbAzUx53w/images/essentials/setup/settings-add-project-dark.png?fit=max&auto=format&n=ubHGK0ZpbAzUx53w&q=85&s=cf01a7c1167f4aae07f0ef9dac62a1a5" className="hidden dark:block mx-auto mt-5 mb-5" style={{ maxWidth: "360px" }} alt="Create Project dialog with name, description, and Active toggle" width="1144" height="866" data-path="images/essentials/setup/settings-add-project-dark.png" />
</Frame>

Give the project a name and a short description. Toggle **Active** on to start using it right away — the admin app switches to the new project automatically.

If you have access to more than one project, the active project is shown as the first item in the breadcrumb at the top of every page. Click it to open a dropdown listing your projects and switch with one click — grouped by organization when you belong to multiple. The project picker in the user menu (top-right) still works as before.

**When to create a new project:** pair each project with a codebase. The Client SDK generated for the project type-checks against that repo, Release Control aligns with the repo's deploy pipeline, and the GitHub integration assumes the same 1:1 pairing. Add a new project when you're starting a new codebase — not when you need another market, language, or brand inside an existing experience. Those compose inside the project via [regions](/project-settings/regions), [locales](/project-settings/locales), [domains](/project-settings/domains), and scopes.

## General settings

Every project has a small set of root-level settings that don't belong to a specific subsystem. You'll find them under **Settings → General**.

* **Name** — the human-readable project name shown in the picker and across the admin app.
* **Description** — a short sentence to help teammates recognize the project. Optional.
* **Active** — whether the project is active. Inactive projects are hidden from the picker by default and stop serving public traffic.

## What to configure next

General settings are intentionally thin — most of a project's configuration lives in dedicated sections:

<CardGroup cols={2}>
  <Card title="Scopes" icon="layer-group" href="/project-settings/scopes">
    Segmentation layers for the project — B2B vs B2C, multi-brand, and
    the default `public` scope.
  </Card>

  <Card title="Regions" icon="earth-americas" href="/project-settings/regions">
    Geographic markets inside a scope, each with its own currency and
    supported locales.
  </Card>

  <Card title="Locales" icon="language" href="/project-settings/locales">
    The language catalog every region picks from.
  </Card>

  <Card title="Domains" icon="globe" href="/project-settings/domains">
    Map incoming URLs to a scope / region / locale triple.
  </Card>

  <Card title="Data Types" icon="shapes" href="/project-settings/data-types">
    Composites and enums you reference when declaring storage fields.
  </Card>

  <Card title="Limits & Quotas" icon="gauge" href="/admin/limits">
    Plan limits that apply to the project.
  </Card>
</CardGroup>
