Documentation Index
Fetch the complete documentation index at: https://www.qovery.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The workspace editor is your development environment in the browser. It provides terminals, AI-assisted coding, and a live preview of your running application - all in one interface. No local setup or IDE installation required.Editor Layout
The editor uses a resizable split layout with two main panels:- Left panel - Terminal tabs for shells, AI chat, and custom commands
- Right panel - Live preview of your running application rendered in an iframe
Top Bar
The top bar provides workspace-level controls:| Element | Description |
|---|---|
| Logo | Click the logo to navigate back to the workspace dashboard |
| Workspace name | Displays the current workspace name |
| Status badge | Shows the current workspace state (Running, Deploying, etc.) |
| Publish | Start the publish workflow to deploy your application |
| Actions menu | Click the ellipsis (…) icon to access workspace actions: Restart, Stop, and Delete |
| User avatar | Your account menu |
Terminal Tabs
The left panel contains tabbed terminals configured by your admin. Click any tab to switch between tools. Common tabs include:Chat
The Chat panel is powered by OpenCode running inside your workspace container. It has full access to your project files and codebase context. Use it to:- Ask questions about your project structure and code
- Generate code snippets and boilerplate
- Debug errors by pasting stack traces
- Get explanations of unfamiliar code
Claude Code
Claude Code is an AI-assisted terminal powered by Anthropic’s Claude. Unlike the Chat panel, Claude Code operates as an interactive terminal session where the AI can directly create files, edit code, run commands, and navigate your project. Use it for:- Hands-on coding tasks (“create a REST API endpoint for users”)
- Refactoring and code modifications
- Running and interpreting test results
- Exploring and understanding your codebase
Terminal
A standard bash shell running in your workspace container. You have full access to your project files and any development tools pre-installed by the blueprint (Node.js, Python, Git, Docker, etc.). Use it for:- Running dev servers and build commands
- Installing packages
- Git operations
- Any command-line task
Custom Tabs
Your admin may configure additional tabs that run specific commands when opened. For example, a tab might automatically start a development server, run a test suite, or launch a linting tool.Each terminal tab runs as a separate shell session. They share the same filesystem but have independent processes and environment state.
Working with the Editor
Starting Your Dev Server
Most blueprints require you to start a development server before the live preview will show your application. Open the Terminal tab and run the appropriate command for your stack:- Node.js
- Python
- Go
- Ruby
Reconnecting
If a terminal tab disconnects (due to network interruption or idle timeout), refresh the browser page to re-establish the connection. Your workspace and all running processes continue in the background - only the terminal connection is interrupted.File Persistence
All files in your workspace persist as long as the workspace exists. Changes survive:- Terminal disconnections
- Page refreshes
- Workspace stop/start cycles
Keyboard Shortcuts
| Shortcut | Action |
|---|---|
| Cmd+S (macOS) / Ctrl+S (Windows/Linux) | Save a git snapshot of your current workspace state |
Next Steps
Live Preview
Viewport switching, auto-refresh, and testing responsive layouts.
Publishing Your App
Deploy your application to a production URL.
Git History & Snapshots
Save, browse, and restore previous versions of your work.