> ## 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**.

**essentials/setup/settings-add-project**

Create Project dialog with name, description, and Active toggle

![Create Project dialog with name, description, and Active toggle](https://mintcdn.com/frontic/ubHGK0ZpbAzUx53w/images/essentials/setup/settings-add-project-light.png?fit=max\&auto=format\&n=ubHGK0ZpbAzUx53w\&q=85\&s=12450b35782198161ddf537ad660c1cc)

Give the project a name and toggle **Active** on to start using it right away - the admin app switches to the new project automatically. The dialog asks for nothing else: add a description and pick an Experience Integration afterwards, when you edit the project (see [General settings](#general-settings)).

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 team when you belong to more than one. This is also where you switch between [teams](https://docs.frontic.com/admin/teams.md).

**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](https://docs.frontic.com/project-settings/regions.md), [locales](https://docs.frontic.com/project-settings/locales.md), [domains](https://docs.frontic.com/project-settings/domains.md), and scopes.

## General settings

Every project has a small set of root-level settings that don't belong to a specific subsystem. Change them from **Settings → Projects**: open the project's menu and choose **Edit Project**.

* **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, and only set here: the Create Project dialog doesn't ask for it.
* **Active** - whether the project is active. Inactive projects are hidden from the picker by default and stop serving public traffic.
* **Avatar** - a round image for the project, shown in the project switcher and on the project cards in **Settings → Projects**. To set it, open **Settings → Projects**, choose **Edit Project** from a project card's menu, and click the avatar at the top of the sheet. Drop or choose an image (PNG, JPEG, or WebP, up to 5 MB), crop it to the circle, and click **Save**. Without an image, the project shows its initials on a colored circle that stays the same for everyone. **Remove** brings the initials back.
* **Experience Integration** - the integration the [Experience Designer](https://docs.frontic.com/designer/overview.md) builds and publishes against. New experiences inherit it, so with one connected shop you never pick an integration per experience.

## What to configure next

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

> [card] [Scopes](https://docs.frontic.com/project-settings/scopes.md)
>
> Segmentation layers for the project - B2B vs B2C, multi-brand, and
> the default `public` scope.

> [card] [Regions](https://docs.frontic.com/project-settings/regions.md)
>
> Geographic markets inside a scope, each with its own currency and
> supported locales.

> [card] [Locales](https://docs.frontic.com/project-settings/locales.md)
>
> The language catalog every region picks from.

> [card] [Domains](https://docs.frontic.com/project-settings/domains.md)
>
> Map incoming URLs to a scope / region / locale triple.

> [card] [Data Types](https://docs.frontic.com/project-settings/data-types.md)
>
> Composites and enums you reference when declaring storage fields.

> [card] [Limits & Quotas](https://docs.frontic.com/admin/limits.md)
>
> Plan limits that apply to the project.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.