<!-- llms-txt: https://hydron.app/llms.txt -->
<!-- llms-full-txt: https://hydron.app/llms-full.txt -->
<!-- canonical: https://hydron.app/docs/projects -->

# Projects

Projects are the top-level organizational unit in Hydron. Every deployment, conversation, and infrastructure plan belongs to a project.

## Creating a project

To create a new project:

1. Navigate to the **Projects** dashboard
2. Click **New Project**
3. Enter a project name
4. Select the project type

### Project types

Choose the type that best matches your application:

| Type | Best for |
|------|----------|
| **Web App** | Full-stack web applications (frontend + backend) |
| **Microservice** | Individual API services or backend components |
| **Static Site** | HTML/CSS/JS sites, SPAs, documentation |
| **Kubernetes** | Container orchestration workloads |
| **Data Analytics** | Data processing and analysis pipelines |
| **ML Inference** | Machine learning model serving |
| **Batch Worker** | Background job processors and task queues |
| **Data Storage** | Databases and storage services |

The project type helps the AI optimize its code analysis and infrastructure recommendations.

## Projects dashboard

The Projects dashboard is your home screen after signing in. It provides several ways to browse and organize your projects.

![The Projects dashboard with project cards, search, and filtering options](/images/docs/projects-dashboard.png)

### View modes

Switch between two view modes:

- **Card view** — Visual cards showing project name, type, and status
- **List view** — Compact list with more projects visible at once

### Sorting

Sort your projects by:

- **Last activity** — Most recently active projects first (default)
- **Name** — Alphabetical order
- **Creation date** — Newest projects first

### Searching

Use the search bar to filter projects by name. The search updates in real-time as you type.

### Filtering

Filter projects by their environment status to quickly find projects in a specific state.

## Favorites

Mark frequently accessed projects as **favorites** by clicking the star icon. Favorited projects appear in a dedicated section at the top of the dashboard and in the sidebar for quick access.

## Project settings

Access project settings by clicking the gear icon or navigating to **Settings** within a project.

![Project settings page with name, description, and configuration options](/images/docs/project-settings.png)

Available settings include:

### General

- **Name** — Rename your project
- **Description** — Add a description for reference
- **Type** — Change the project type

### Services

- View and manage all services linked to the project
- Add new services or remove existing ones
- Configure service-specific settings

### AI Settings

- **Model** — Choose the AI model for conversations
- **System prompt** — Customize the AI's behavior for this project
- **Temperature** — Adjust creativity vs. determinism

### Linked servers

- View which servers from your inventory are linked to this project
- Link or unlink servers

### Danger zone

- **Delete project** — Permanently delete the project and all associated data

## Managing projects from the sidebar

The left sidebar in the chat interface provides quick access to:

- All your projects with favorites at the top
- Recent chats within each project
- Quick project switching without leaving the chat

You can **rename** or **delete** projects directly from the sidebar context menu.

## Best practices

- **One project per application** — Keep related services together in one project
- **Use descriptive names** — "E-commerce API" is better than "Project 1"
- **Favorite active projects** — Keep your current work easily accessible
- **Archive completed work** — Delete projects you no longer need to keep the dashboard clean
