A project is the top-level organizational unit in Unkey Deploy. Each project maps to a single codebase (typically a GitHub repository) and groups the apps, environments, and configuration needed to build, deploy, and run your application.
Project hierarchy
Projects live inside a workspace. A project contains one or more apps, and each app has its own environments, deployments, and configuration.
Workspace
└── Project (one per codebase)
└── App (deployable service)
├── Environments (production, preview, custom)
│ ├── Deployments
│ ├── Variables
│ └── Custom domains
└── Configuration (build, runtime, Sentinel)
Create a project
- Navigate to your workspace’s Projects page.
- Click New project.
- Enter a project name. Unkey generates a URL-friendly slug from the name, which you can edit.
- Connect your GitHub account if you haven’t already. You can skip this step and connect later.
- Select the repository to deploy from your connected GitHub accounts.
- Configure initial build and runtime settings. You can change these later.
- Click Deploy to trigger your first deployment.
The slug must be unique within your workspace and can only contain lowercase letters, numbers, and hyphens.
Project dashboard
After creation, the project dashboard gives you four tabs:
| Tab | What it shows |
|---|
| Deployments | Active and past deployments across all environments, with commit info and status |
| Logs | Runtime logs from your running instances |
| Requests | HTTP request analytics processed by the Sentinel |
| Settings | Build, runtime, and advanced configuration. See Settings for details |
Delete a project
Deleting a project permanently removes all deployments, environments, custom domains, variables, and associated data. This action cannot be undone.
- Open the project actions menu (three-dot icon on the project card).
- Select Delete project.
- Check the confirmation box acknowledging the permanent deletion.
- Confirm the deletion.
Deletion is asynchronous. Unkey removes all associated resources (deployments, environments, domains, variables) in the background. The project disappears from your workspace immediately, but cleanup of underlying resources completes shortly after. 
