Project Setup

Projects are the foundation of your CloudInfraOS workspace. They group related apps, cloud resources, and provider connections under a single organizational unit.

Creating a Project

From the dashboard, click New Project. You'll be prompted to enter:

• Name — a descriptive name for your project (e.g., "Production Infrastructure")
• Description — optional context about the project's purpose

Projects belong to your organization and are visible to all organization members with the appropriate role.

Managing Apps

Each project can contain multiple apps. An app typically represents a deployed service or application (e.g., a Next.js frontend, an API server, or a background worker). Apps can be linked to GitHub repositories and associated with specific provider connections.

To add an app, open a project and click Add App. Provide a name and optionally link a GitHub repository for source tracking.

Provider Connections

Apps within a project connect to cloud providers through encrypted provider connections. Each connection stores the credentials and configuration needed to sync resources, track costs, and monitor health for that provider. See the Provider Connections guide for setup details.

Project Views

The dashboard supports two project views:

• Grid view — card-based layout showing project details at a glance
• List view — compact table layout for scanning many projects

Switch between views using the toggle in the dashboard toolbar. You can also hide projects you don't need to see regularly without deleting them.

Deleting Projects

Deleting a project removes it and all associated apps, provider connections, and synced resources. This action cannot be undone — a confirmation dialog ensures you don't delete projects accidentally.