Projects
In Camunda Hub, a project is a type of folder that contains a set of related files you can work on and deploy as a single bundle.

For example, a project for a consumer loan application might consist of a BPMN diagram as an entry point and a number of additional supporting files, such as DMN diagrams and forms.

Project development lifecycle
In Camunda Hub, you can quickly develop project releases through the stages of a typical development lifecycle.
Create a project
Get started by creating a new project.
- When you create a project, you must select a cluster to use for deployment during development.
- You can add files to the project as required.
Validate and deploy your project
Validate your project in development before deploying it to testing, staging, or production.
Project versioning
Use versioning to save a single snapshot of all the project files in one action.
Known limitations
You should be aware of the following limitations when working with projects.
General limitations
- Self-Managed does not support defining cluster stages, identifying clusters by tags, or cluster promotion.
Deployment limitations
- Projects can only be deployed to a Zeebe cluster in version 8.4.0 or higher.
- The overall size of the deployment bundle is limited due to a maximum record size of 4 MB in Zeebe.
- The limit is effectively between 2 and 3 MB, as Zeebe writes more data to the log stream than just the raw deployment.
- If you exceed the limit, you are shown an error message:
Command 'CREATE' rejected with code 'EXCEEDED_BATCH_RECORD_SIZE'.