Projects

A project is one app. It has a list of variable names and a set of contexts. Each variable can have a value in each context.

• Variable: a name, like DATABASE_URL. Defined once per project. Use uppercase letters, numbers and underscores, like API_KEY. Start with a letter or underscore. The dashboard uppercases names as you type and turns spaces and hyphens into underscores. The CLI refuses other names, and import lists the ones it skips.
• Context: a place the app runs, like Development, Staging, or Customer Acme.
• Value: the encrypted value of one variable in one context.

One Vault password per account unlocks your private key on your device. Each context has its own key, and each reader gets their own sealed copy. Readers are you, each member and each server token that may read that context. See Vault.

From Projects in the dashboard, choose Rename. Variables, contexts, and tokens stay bound to the same project id.

From Projects, delete a project and confirm by typing its name. That removes its variables, contexts, backups, and webhooks, also for members you shared it with. Only the owner can delete it.