# Uniform projects

> A project is the basic unit of organization in Uniform and represents a digital experience.

Source: https://docs.uniform.app/docs/guides/projects

A project is a collection of configurations to drive an experience. In Uniform, most of the settings that control [classification](./classification), [personalization](./personalization) and [layout](./composition) for your web application are set and stored in a project. To configure these things, you need a project.

## About projects

When logging into the Uniform app, you will be taken to the [team dashboard](https://docs.uniform.app/docs/guides/teams#team-dashboard), where you can see the list of projects you can access.

If you are member of multiple teams, you can switch between teams using the team switcher in the header.

## Project dashboard

Video: [Overview of the project dashboard](https://vimeo.com/1088092524)

Your project dashboard brings together everything you need to manage your content effectively. Find recent work faster, access key project areas with one click, and stay on top of releases and product updates—all from a single, organized view:

- **Quick content access** - Navigate instantly to compositions, entries, and assets with dedicated buttons
- [**My recents**](https://docs.uniform.app/docs/guides/content-organization/my-recents) - View your recently modified items with timestamps to pick up where you left off, and switch to **Favorites** to see just your [favorited](https://docs.uniform.app/docs/guides/content-organization/favorites) items
- **Embedded project map** - Access your project structure directly from the dashboard
- **Release planning** - See upcoming releases with dates and item counts
- **Quick create shortcuts** - Create compositions, components, signals, tests, and read-only API keys with one click
- **Product updates** - Stay informed with the latest Uniform releases and access the changelog
- **Scout tab** - If your team has [AI credits](https://docs.uniform.app/docs/guides/ai/ai-credits), the dashboard includes a dedicated [Scout](https://docs.uniform.app/docs/guides/ai/scout) tab with a prompt input and your recent threads

## Manage projects

### Create a project

1. In Uniform, go to the dashboard of the [team](https://docs.uniform.app/docs/guides/teams#team-dashboard) you want to add the project to.

   > **Note:**
   >
   > You can get to the teams page by clicking the Uniform logo
   > in the upper right-hand corner of the Uniform header.
2. Click **Add new project**.
3. Enter the following values:

   | Field | Value |
   | --- | --- |
   | Give your project a name | The name this will be used to identify your project in Uniform. |
   | Choose project type | The available project types depend on your Uniform license. |
4. Click **Continue**.

### Delete project

> **Backup your project first:**
>
> Before deleting a project, make sure you have a backup of your project. You can backup your project by using the [Uniform CLI](https://docs.uniform.app/docs/guides/cli/common-tasks#backup-and-restore).

1. In Uniform, navigate to **Settings > General**.
2. Click the **Delete project** button. You will be presented with a confirmation message where you need to enter a deletion code to ensure you want to complete the action.

> **This is a breaking change:**
>
> By deleting a project all content and settings will be permanently deleted.
>
> Any code relying on this project or its project ID will break and users with permissions to this project will lose access.

## Project settings

Using the **Settings** item in the main navigation menu you can access the following project settings:

- [General](#general-settings): Change the project name and type.
- [Preview](https://docs.uniform.app/docs/guides/composition/visual-editing/preview-mode#configure-project-preview-settings): Manage preview settings for your project.
- [Localization](https://docs.uniform.app/docs/guides/composition/localization#locales): Manage locales and locale groups.
- [Project map](https://docs.uniform.app/docs/guides/project-maps): Manage project map settings.
- [Integrations](https://docs.uniform.app/docs/integrations): Install and manage integrations
- [Webhooks](https://docs.uniform.app/docs/guides/webhooks): Create and manage webhooks
- [Workflows](https://docs.uniform.app/docs/guides/workflows): Create and manage workflows
- [Prompts](https://docs.uniform.app/docs/guides/ai/ai-prompts#manage-prompts): Legacy feature - Create and manage AI prompts
- [Publishing history](#publishing-history): View the publishing history of your project.

### General settings

- **Update project name**: Change how your project is identified in Uniform. This name is used in the project switcher in the global header and in the project dashboard.
- **Access project ID**: Retrieve the unique identifier for your project, useful for developer tasks or when communicating with Uniform support.
- [**Change project type**](#change-project-type): Change the project type to manage entitlements to and usage limits for your project.

#### Change project type

The project type determines the Uniform features your project can use. This value is set when the project is created. You can change it at any time.

> **Info:**
>
> Which project type you have access to will be based on your team's subscription.
>
> If you have any questions about the project types available to you, please [contact us](mailto:support@uniform.dev?subject=Uniform+project+types).

Project types will be based on different pricing tiers and wether they are **Production** or **Non-production** projects:

- **Production**: Production projects are used for live environments.
- **Non-production**: Non-production projects are used for development and testing environments.

> **Note:**
>
> Changing the project type won't delete any data. If you exceed the new project limits, you can't publish changes until you're back under the limit.

### Publishing history

> **Dive deeper into logs with webhooks:**
>
> Did you know that our [webhooks](https://docs.uniform.app/docs/guides/webhooks) can offer more detailed logs of all the actions that occur in your project? Simply configure a webhook with the events that you would like to monitor, and at any point you can query the history for that event from the time the webhook was created.

The publishing history provides access to details about the most recent 50 times the publishing process was triggered. The following information is available:

- What entity type was published
- When it was published

To see the publishing history:

1. In Uniform, open your project.
2. Navigate to the **Settings** tab.
3. In the left menu, click **Publishing History**.

![](https://docs.uniform.app/images/guides/projects/publishing-history.png)