Applications
The Applications section of C3 Code covers two routes: the applications list (/applications) and the application detail page (/applications/:id). From the applications list, you manage all your applications. From the application detail page, you manage workspaces, deployments, collaborators, and application settings for a specific application.
Applications page
The Applications page (/applications) lists all applications you have access to.
Header controls:
- Search: Filters the application list by name as you type.
- Create application button: Opens the Create application modal. Enter a name and optional description to create a new application. After you create the application, C3 Code opens the Workspaces tab.
Application cards:
Each application appears as a card showing the application name and a preview thumbnail. Select a card to navigate to the application detail page. The card context menu (...) provides one action:
- Settings: Navigates to the Settings tab on the application detail page.
Application detail page
The Application detail page (/applications/:id) provides access to all resources and settings for a single application. A breadcrumb at the top shows Applications / [Application name]. The page contains four tabs:
- Workspaces: Lists all workspaces for this application (default tab).
- Deployments: Lists all deployments for this application.
- Collaborators: Manages users who have access to this application.
- Settings: Shows application configuration and the option to remove the application.
Workspaces tab
The Workspaces tab lists all workspaces associated with this application. Workspaces are isolated development environments where you build, iterate on, and test your application.
Header controls:
- Search: Filters the workspace list by name.
- Create workspace button: Opens the Create workspace modal. Enter a workspace name to create a new workspace for this application.
Workspace cards:
Each workspace appears as a card showing:
- Workspace name.
- Status indicator: A colored dot reflecting the workspace's current state:
- Ready (green)
- Starting, Restarting, and Upgrading (blue)
- Stopping (amber)
- Stopped (gray)
- Error (red)
- Degraded or Unknown (amber)
The card context menu (...) provides the following actions:
- Workspace settings: Navigates to the Settings tab for this workspace.
- Start workspace: Starts the workspace. Visible only when the workspace is stopped, degraded, or in an unknown state.
- Stop workspace: Stops a running workspace.
- Restart workspace: Restarts the workspace.
- Rename workspace: Opens an inline editor to rename the workspace.
- Delete workspace: Opens a confirmation modal. Deleting a workspace permanently removes it and its local file history.
Select a workspace card to open the workspace.
For more information, see Workspace.
Deployments tab
The Deployments tab lists all deployments created from this application's workspaces.
Deployments table columns:
- Name: The deployment name. Select to open the deployment.
- Workspace: The workspace the deployment was created from.
- Environment: The target environment (Staging or Production).
- Status: Current deployment status (Running, Pending, Failed, and others).
- Last deployed: The date and time of the most recent deployment action.
To manage deployments across all your applications, see Deployments.
Collaborators tab
The Collaborators tab manages who can access this application and its workspaces.
Collaborators table:
Each row shows:
- User: The collaborator's name and email address.
- Role: Either Admin or Collaborator.
- Admin: Full access: can manage workspaces, collaborators, and application settings.
- Collaborator: Can access workspaces but cannot manage collaborators or delete the application.
Controls:
- Add collaborator button (+): Opens the Add collaborator modal. Search for a user by name or email, select their role, and confirm to grant access.
- Role dropdown (per row): Change a collaborator's role between Admin and Collaborator.
- Remove (per row): Removes the collaborator's access to this application.
Settings tab
The Settings tab shows the application's configuration and provides the option to remove it.
General Settings:
- Application name: Displays the current application name (read-only).
- Remove application button: Opens a confirmation modal. Removing an application permanently deletes it, all its workspaces, and all associated deployments. This action cannot be undone.