Studio · Project management

Project settings

Project leads and administrators can change project settings. Open Members to manage access and Settings to configure development work.

Members and visibility

Search for existing members and add them to the project. New members must join Studio; an invitation can also assign them to a project.

  • Everyone: all workspace members can view the project.
  • Project members only: access is limited to project members and administrators.
  • Project lead: choose a project member. Assign a new lead before removing the current one.

Change status, priority, and dates in the project properties.

Project members and lead
Project members and lead

Configure the project

SectionSettings
GeneralName, description, and default commit attribution
Code repositoriesRepositories, checks, branch rules, and previews
Agent run variablesEnvironment variables and secrets for development tasks
Default skillsSkills used by runs in the project or a repository
Configure checks, branch rules, and previews on each repository
Configure checks, branch rules, and previews on each repository

The first repository is the primary repository. Removing a link does not delete the repository on the Git platform. See Checks and CI and Skills for their configuration.

Connect an existing repository

In New project, choose Existing repository and select a repository available through the Git connection. For an existing application, usually choose no initialization.

To add application scaffolding, choose NocoBase application or prompt-based initialization. The Agent preserves existing files and submits changes through a branch and PR for the owner to accept. You can also add a repository later. To start with an empty application, see Create your first project.

Commit attribution

Use the member's identity alone or include the Agent as a co-author. A member's personal preference takes priority over the project default.

Agent run variables

Set variables for the whole project or a single repository. For the same name, repository values override project values; Agent values override both.

  • Values are hidden after saving. Revealing a secret records who viewed it and when.
  • For values supplied by a runtime, use nocobase-runner env set NAME on that runtime.
  • Restrict a variable to shared runtimes when work using it must not run on personal runtimes.

Configure preview and test application variables in Hosted environments or the application settings.

Delete a project

Administrators can delete a project from its additional actions. Tasks remain but leave the project. Git repositories are unaffected.

NocoBase docs assistant

Ask anything about NocoBase…

Each question is answered independently, without earlier questions or answers. Include all relevant context.