Creating and Managing Projects
Learn how to create, edit, search, and delete projects in Devpilot, and how to work with project keys and secrets.
Projects are the organizational containers that group related apps together inside a workspace. This guide covers creating projects, managing their settings, working with project keys, and keeping your workspace tidy as it grows.
Creating a project
Open the Projects page
From your workspace dashboard, select Projects in the sidebar. You will see every project in the current workspace, along with a summary of how many apps each one contains.
Click Create Project
Click the Create Project button in the top-right corner of the page to open the creation dialog.
Name your project
Enter a clear, descriptive name — for example, Marketing Site, Customer Portal, or Client: Acme Corp. Names can be up to 255 characters and can be renamed later.
Upload a logo (optional)
You can upload a logo image (JPEG, PNG, GIF, WebP, or SVG, up to 5 MB). The logo appears next to the project name throughout Devpilot. Logos are optional and can be changed later.
Create
Click Create. Devpilot generates a unique project key and project secret automatically and opens the project detail page so you can start adding apps.
The number of projects you can create depends on your workspace plan. When you reach the limit, Devpilot will prevent you from creating more until you upgrade or remove an existing project.
Project keys and secrets
Every project has two auto-generated identifiers, both visible in the project's Keys panel.
| Identifier | Prefix | What it is used for |
|---|---|---|
| Project Key | PK_ | A public, URL-safe identifier that references the project in the API and webhook URLs. |
| Project Secret | PS_ | A confidential token Devpilot uses to verify signed webhook payloads and deploy triggers. |
Each app inside the project also has its own AK_ (app key) and AS_ (app secret) pair, which you can see on the app page.
Never share your project secret in client-side code, public repos, or screenshots. Treat it like a password.
Viewing and editing a project
Open any project from the Projects list to reach its detail page. From there you can:
- See every app in the project, along with its platform and server.
- Open the Keys panel to copy the project key, the project secret, or any app's keys.
- Open the Settings panel to rename the project or replace its logo.
- View project-level statistics (apps, deployments, and activity summaries).
To rename a project or change its logo, open Settings, edit the fields you want to change, and click Save.
Searching and sorting projects
The Projects page supports:
- Search — type any part of a project's name to filter the list in real time.
- Ordering — sort by newest, oldest, or alphabetical order.
- Pagination — large workspaces are paginated so the list stays fast.
Deleting a project
Deleting a project removes every app inside it, along with their app configs, domains, detected environment variables, and deployment history. This cannot be undone.
Open the project
Navigate to the project you want to delete and open its Settings panel.
Use the delete option
Click Delete Project. Devpilot will ask you to confirm. Once confirmed, the project and all of its apps are soft-deleted and hidden from the workspace.
If you only want to stop deploying an app temporarily, set the app's status to Inactive instead of deleting the project. See Managing Apps.
Moving apps between projects
You can move an app to another project in the same workspace without losing its configuration, domains, or deployment history. The move is available from the app's Actions menu — see Managing Apps for the full steps, including the bulk-move option that handles several apps at once.
Best practices
- Name projects by product, client, or domain so they stay meaningful as your team grows.
- Group related apps together — keep the web app, API, and workers of one system in the same project.
- Review regularly — delete old projects that are no longer needed to free up your plan quota.
- Rotate exposed secrets — if a project or app secret ends up somewhere it should not, delete and recreate the resource to get a fresh pair.