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

# Projects

> The backbone of Pixwel — how a project contains assets, and how assets contain the files that get localized and delivered.

Almost everything in Pixwel hangs off a three-level hierarchy: a **project** contains **assets**, and an asset contains **files**. Understanding this relationship makes the rest of the platform easier to follow.

```mermaid theme={null}
graph TD
  Studio["Studio"] --> Project["Project<br/><i>e.g. a film campaign</i>"]
  Project -->|has many| Asset["Asset<br/><i>e.g. the US trailer</i>"]
  Project -.->|logo &amp; loose files| File["File"]
  Asset -->|has many| File["File<br/><i>a localized / encoded rendition</i>"]
  Asset -->|has many| Preview["Preview<br/><i>lightweight web playback</i>"]
  Asset -->|original + translations| Translation["Translation<br/><i>subtitles, dialogue, graphics</i>"]
```

<CardGroup cols={3}>
  <Card title="Assets" icon="clapperboard" href="/features/projects/assets">
    The individual pieces of creative within a project.
  </Card>

  <Card title="Files" icon="file" href="/features/projects/files">
    The real, downloadable deliverables of an asset.
  </Card>

  <Card title="Scripts" icon="file-lines" href="/features/projects/scripts">
    The source-language text that localization is built from.
  </Card>
</CardGroup>

## Project

A **project** represents one campaign — typically a single film — and is owned by a [studio](/glossary). It's the container everything else lives in.

<Frame caption="The projects grid — each tile is one project, shown with its logo (key art).">
  <img src="https://mintcdn.com/pixwel/LCc2un8fWfvdWtLT/img/projects-grid.png?fit=max&auto=format&n=LCc2un8fWfvdWtLT&q=85&s=dad76a443026efcb9bc8394dff328dd7" alt="Pixwel projects grid showing film campaign tiles" width="2578" height="1534" data-path="img/projects-grid.png" />
</Frame>

A project holds:

* Many **[assets](/features/projects/assets)** (the trailers, TV spots, posters, and other media for the campaign)
* A **logo** file (the project's poster or key art)
* Occasionally, **loose files** attached directly to the project rather than to an asset

## How they relate

| Relationship        | Cardinality | Meaning                                        |
| ------------------- | ----------- | ---------------------------------------------- |
| Studio → Project    | one to many | A studio owns many projects                    |
| Project → Asset     | one to many | A project contains many assets                 |
| Asset → File        | one to many | An asset has many file renditions              |
| Project → File      | one to many | Files can also attach directly to a project    |
| Asset → Preview     | one to many | An asset has previews per language/revision    |
| Asset → Translation | one to many | An asset has an OV plus localized translations |

The shape to remember: **one project, many assets; one asset, many files** — and each file is a specific localized or encoded version of its asset.

<Info>
  This page describes the concepts.
</Info>