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

# Projects

> How DocDiagram organizes your diagrams.

<Frame caption="A project holds your diagrams plus the brand and theme settings they share">
  <img src="https://mintcdn.com/docdiagram/41jLckNKrw3Njatp/images/diagrams/projects-light.svg?fit=max&auto=format&n=41jLckNKrw3Njatp&q=85&s=af72e5726880602ddda750988f74e48b" alt="Project container with diagrams, brand, theme, and members" className="block dark:hidden" width="760" height="340" data-path="images/diagrams/projects-light.svg" />

  <img src="https://mintcdn.com/docdiagram/41jLckNKrw3Njatp/images/diagrams/projects-dark.svg?fit=max&auto=format&n=41jLckNKrw3Njatp&q=85&s=90ca909025e4e992e862c762806ec5c3" alt="Project container with diagrams, brand, theme, and members" className="hidden dark:block" width="760" height="340" data-path="images/diagrams/projects-dark.svg" />
</Frame>

A **project** is the unit of organization in DocDiagram. Everything that should share branding, conventions, and access lives in the same project.

## What a project contains

* **Diagrams** — every diagram you generate or save.
* **Brand settings** — palette, fonts, and logo (see [Themes & branding](/quickstart/themes-and-branding)).
* **Default theme** — light, dark, or auto.

## When to use multiple projects

* **One product, one project.** Most teams need exactly one.
* **Multiple products or brands.** Split into one project per product so brand tokens don't bleed across.
* **Client work.** Agencies typically create one project per client.

## What's shared across projects

Your account-level credit balance is shared across every project you own. So is your account-level theme preference for the editor UI itself.

## Coming soon

* **Team projects** — shared editing across multiple users in your org.
* **Project-level access controls** — view-only vs. edit roles.

## Next

<Card title="Credits" icon="coins" href="/concepts/credits">
  How DocDiagram charges for generation.
</Card>
