Interface Overview

The Zed Interface Philosophy

Zed's interface was designed around a few core principles:

• Minimalism: Reduce visual noise to focus on your code
• Performance: GPU-accelerated rendering for smooth experiences
• Keyboard-driven: Efficient workflows without leaving the keyboard
• Discoverability: Features are accessible through intuitive commands

The result is a clean workspace that stays out of your way while providing powerful features when needed.

Workspace Overview

The Zed workspace consists of several key components:

1. Project Panel

   Located on the left side of the window, the Project Panel displays your project's file structure in a hierarchical tree view. This panel can be toggled with ⌘\\.

   

2. Editor Area

   The central area where you edit your code. Zed supports multiple editor panes arranged in splits, allowing you to view multiple files side by side.

   You can split the editor vertically with ⌘\\ or horizontally with ⌘Shift\\.

3. Command Bar

   Access the Command Bar with ⌘P to open files or ⌘ShiftP to execute commands. This is the primary way to interact with Zed's features beyond basic editing.

   

4. Status Bar

   Located at the bottom of the window, the Status Bar provides information about the current file, including language, line/column position, Git branch, and collaboration status.

5. Terminal Panel

   Toggle the integrated terminal with Ctrl`. The terminal provides a full-featured command line interface without leaving Zed.

   

Navigation Components

Project Panel

The Project Panel helps you navigate your project's files and directories:

• Expanding/Collapsing: Click on folders or use arrow keys to expand/collapse directories
• Opening Files: Click on files to open them in the editor
• Context Menu: Right-click on files or folders for additional options
• File Operations: Create, rename, or delete files and directories

Tabs and Editor Groups

Zed organizes open files in tabs within editor groups:

• Tabs: Each open file appears as a tab at the top of an editor group
• Editor Groups: Split panes that can contain their own set of tabs
• Tab Navigation: Switch between tabs with ⌘Shift[ and ⌘Shift]

Command Bar and Palette

The Command Bar is one of Zed's most powerful interface elements:

File Search

Press ⌘P to open the fuzzy file finder:

• Type part of a filename to find it quickly
• Use arrow keys to navigate results
• Press Enter to open the selected file

Command Palette

Press ⌘ShiftP to open the Command Palette:

• Access all of Zed's commands and features
• Type to search for specific commands
• See keyboard shortcuts for commands

Symbol Search

Press ⌘ShiftO to search for symbols in the current file:

• Quickly jump to functions, classes, and methods
• See symbol hierarchy and structure

Status Bar Information

The Status Bar provides contextual information about your current state:

• File Information: File type and encoding
• Position: Current line and column numbers
• Git Status: Current branch and file changes
• Collaboration: Number of connected collaborators
• Language Server: Status of language server and diagnostics

Notifications and Dialogs

Zed uses several types of notifications to communicate with you:

Toast Notifications

Brief messages that appear in the corner of the screen to provide temporary feedback.

Dialogs

Modal windows that require your attention or input before continuing.

Status Messages

Persistent messages that appear in the status bar for ongoing processes.

View Management

Zed allows you to customize your workspace view in several ways:

Splits and Panes

Create multiple editor panes to view different files side by side:

• Vertical Split: ⌘\\
• Horizontal Split: ⌘Shift\\
• Navigate Between Splits: ⌘1, ⌘2, etc.

Zen Mode

Enter distraction-free editing with Zen Mode:

• Press ⌘ShiftP and search for "Zen Mode"
• Hides UI elements for focused editing
• Toggle panels as needed without exiting Zen Mode

Theme and Appearance

Zed comes with several built-in themes and appearance options:

Changing Themes

Access themes through the Command Palette:

1. Press ⌘ShiftP
2. Type "theme"
3. Select "Preferences: Color Theme"
4. Choose from available themes

UI Scaling

Adjust the UI scale through Settings:

1. Press ⌘, to open Settings
2. Look for "UI Font Size" and "Buffer Font Size" settings

What's Next?

Now that you're familiar with Zed's interface, you're ready to learn about editing features that will help you write code more efficiently.