> For the complete documentation index, see [llms.txt](https://codemash.gitbook.io/codemash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codemash.gitbook.io/codemash/cloud/projects.md).

# Projects

Your account home — every project of the account, and the button to create a new one.

**Where:** menu bar → **Projects** · `/`

A **project** is one backend: its modules, data, users and messages all live inside it ([Projects and environments](/codemash/cloud/concepts/projects-and-environments.md)). **Projects** is the first screen after sign-in. It shows one card per project of the account, after the **Create a new PROJECT** card.

<figure><img src="https://712692422-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHy372bqsaex2cqS3ikhL%2Fuploads%2Fgit-blob-2e6a573e490f4cfd0cd529e06608cad08be197a2%2Fprojects-list-1.png?alt=media" alt="Projects screen with the Create a new PROJECT [3/25] card and the cards test, Acme Store and Bookshop with their region badges"><figcaption><p>Three projects; 3 of 25 allowed are used.</p></figcaption></figure>

## Columns, search and filters

Each card shows:

| Part   | What it shows                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name   | The project name, for example `Acme Store`.                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Badge  | One green badge per region of an active project (for example `nb-eu-germany`). Instead: **PROVISIONING** — the managed database is still being set up (the list refreshes itself every 30 seconds until it is ready); **SETUP FAILED** — the database setup did not finish; **NO DATABASE** — the project has no database yet; **DISABLED** — the project is switched off ([Termination](/codemash/cloud/project/settings/termination.md)). A self-hosted project has no region badge. |
| Footer | **modules** and **team members** counters.                                                                                                                                                                                                                                                                                                                                                                                                                                             |

The **Create a new PROJECT** card shows a counter on the managed service, for example `[3/25]`: active projects / projects your subscription allows. On a self-hosted installation the cap comes from the licence.

There is no search or filter: every project is on one screen. Press a card to open the project ([Project](/codemash/cloud/project.md)).

{% hint style="warning" %}
The **modules** and **team members** counters always show 0 today, even when modules are on. Open the project to see its modules.
{% endhint %}

## What you can do here

* [Create a project](/codemash/cloud/project/create.md) — the New Project wizard.
* [Open a project and enable modules](/codemash/cloud/project.md).
* [Change a project's settings](/codemash/cloud/project/settings.md).
* [Disable or delete a project](/codemash/cloud/project/settings/termination.md).

## Use it from code

```ts
const { list } = await norbix.hub.account.getProjects({});
console.log(list.map((p) => [p.viewId, p.name, p.projectStatus]));
// [["pr_3LWFC8SZXKOOJM6Xj5jIyH","test","Active"],["pr_QkocqVu7PUBxxT3cz5EJZ","Bookshop","Active"],["pr_7FUKofhEBNMnISkqust2De","Acme Store","Active"]]
```

```sh
norbix account projects
```

The client setup is on the [Account page](/codemash/cloud/account.md#use-it-from-code). API: [Get Projects](/codemash/api-reference/account/projects/get-projects.md)