# Workspaces

**Page:** kit/workspaces

[Download Raw Markdown](./kit/workspaces.md)

---

# Workspaces

**You don't install an operating system anymore. You open a URL.**

Traditional desktops are trapped on a single machine. Remote desktops require VPN tunnels, VNC viewers, specialized clients. Hoody Workspaces is none of that. It's a full operating system running in a browser tab — drag-and-drop layouts, multi-container views, every Kit service embedded as a panel. Open it from any device, anywhere.

---

## Access Your Workspace

Workspaces runs at a single URL:


  
    ```
    https://app.hoody.icu
    ```
    Log in with your Hoody account. All your projects, containers, and services appear instantly.
  
  
    ```
    https://PROJECT_ID-CONTAINER_ID-workspaces-1.SERVER.containers.hoody.icu
    ```
    Each container has its own workspace instance — accessible directly via its service URL, like every other Kit service.
  



Workspaces is the visual layer on top of Hoody's HTTP services. Every panel is an iframe embedding a Kit service URL. The workspace remembers your layout, panel sizes, and which services are open.


---

## What You Can Do

- **Unified Dashboard** — See all containers, projects, and servers in one place
- **Drag-and-Drop Layouts** — Arrange terminal, display, files, and code panels however you want
- **Multi-Container Views** — Embed services from different containers side-by-side in one workspace
- **Shareable URLs** — Share your entire workspace layout with a URL
- **Any Device** — Desktop, tablet, phone — if it has a browser, it runs Workspaces
- **Service Quick-Launch** — Open any Kit service (terminal, display, files, SQLite, code) with one click
- **Project Switching** — Jump between projects and containers instantly

---

## The Workspace Model

Every panel in a workspace is just a URL. Terminal? URL. Display? URL. File manager? URL. Code editor? URL. The workspace arranges them:

```
┌─────────────────────────────────────────────┐
│ Workspace: "My Dev Environment"             │
├──────────────────┬──────────────────────────┤
│ Terminal-1       │ Display-1                │
│ (shell access)   │ (GUI desktop)            │
├──────────────────┼──────────────────────────┤
│ Files            │ Code-1                   │
│ (file manager)   │ (VS Code)               │
└──────────────────┴──────────────────────────┘
```

Each panel maps to a Kit service URL:

```
Terminal:  https://PROJECT-CONTAINER-terminal-1.SERVER.containers.hoody.icu
Display:   https://PROJECT-CONTAINER-display-1.SERVER.containers.hoody.icu
Files:     https://PROJECT-CONTAINER-files-1.SERVER.containers.hoody.icu
Code:      https://PROJECT-CONTAINER-code-1.SERVER.containers.hoody.icu
```

The workspace saves the layout. Close the tab, reopen it — everything is exactly where you left it.

---

## Key Concepts

### Panels

Each panel embeds a Kit service URL. Add panels for:
- **Terminals** — any instance: terminal-1, terminal-2, etc.
- **Displays** — remote desktop for any display instance
- **Files** — file manager
- **SQLite** — database UI
- **Code** — VS Code editor
- **Browser** — browser automation view
- **Any custom URL** — embed anything with a URL

### Layouts

Arrange panels in rows, columns, and grids. Resize by dragging borders. Save layouts to switch between different working modes — a development layout, a monitoring layout, a presentation layout.

### Multi-Container

A single workspace can embed services from **different containers**. Monitor multiple environments, compare outputs, or manage a distributed system from one screen. Each panel points to a different container's service URL — the workspace doesn't care which container it's talking to.

---

## Common Patterns

### Development Workspace

Terminal + Code + Display for full-stack development with live GUI preview. Write code in one panel, run it in another, see the output in a third.

### Monitoring Dashboard

Multiple terminals showing logs from different containers, plus a browser panel for status pages. One screen, full visibility across your infrastructure.

### Presentation Mode

Share a workspace URL with a client to give them a live view of your infrastructure — without giving direct access. They see what you see. Nothing more.

---

## What's Next


  
  
  
  


---

> **Your desktop is a URL now.**
> **Open it from any device. Arrange it however you want. Share it with anyone.**
> **No VNC. No RDP. No VPN. Just a browser tab.**