Appearance Settings
Customize the visual appearance of the Pieces Desktop App, including theme mode, accent colors, font size, font weight, and visual density. Adjust these settings to match your preferences and create a comfortable work environment.
To access Appearance settings, click your User Profile in the top left, then hover over Settings and select Appearance.
Appearance settings showing Theming, Fonts, and Spacing sections
Theme changes are automatically saved when adjusted, and settings are stored locally, not synced with Pieces Cloud.
Theming
Customize the overall theme and accent color of the Pieces interface. Choose between dark, light, or system themes, and select an accent color that matches your preferences.
Theme Mode
Choose how Pieces displays its theme. You can select Dark, Light, or System mode, which automatically matches your operating system's theme preference.
Click your `User Profile` in the top left, then hover over `Settings` and select `Appearance`.
In the *Theming* section, find the "Theme Mode" option showing your current mode (e.g., "Theme Mode: System").
Click the `Dropdown Arrow` next to the current theme mode to open the theme options.
Choose from the following options:
* **Dark**: Dark theme for low-light environments
* **Light**: Light theme for bright environments
* **System**: Automatically matches your operating system's theme preference
Accent Color
Customize the accent color used throughout the Pieces interface. The accent color affects interactive elements like buttons and highlights, but not the entire UI.
Click your `User Profile` in the top left, then hover over `Settings` and select `Appearance`.
In the *Theming* section, find the "Accent Color" option showing your current color (e.g., "Accent Color: Blue") with a color swatch.
Click the `Dropdown Arrow` next to the accent color to open the color picker, which displays a grid of available colors.
Click on any color in the grid to select it. The selected color will be marked with a checkmark, and your accent color will update immediately.
Fonts
Adjust the size and weight of text throughout the Pieces Desktop App to improve readability and match your preferences.
Font Size
Adjust the size of all text in the Pieces Desktop App. This is helpful for different screen sizes, resolutions, or if you prefer larger or smaller text for readability.
Click your `User Profile` in the top left, then hover over `Settings` and select `Appearance`.
In the *Fonts* section, find the "Font Size" option showing your current size (e.g., "Font Size: 100%").
Use the controls to change the font size:
* Click the `Minus Button` (`-`) to decrease the font size
* Click the `Plus Button` (`+`) to increase the font size
* The current percentage is displayed between the buttons
You can also use keyboard shortcuts to zoom: `⌘+,+` (macOS) or `ctrl+,+` (Windows/Linux) to zoom in, and `⌘+,-` (macOS) or `ctrl+,-` (Windows/Linux) to zoom out.
Font Weight
Adjust the thickness of text throughout the Pieces Desktop App. Choose from Thin, Normal, Medium, or Bold to match your reading preferences.
Click your `User Profile` in the top left, then hover over `Settings` and select `Appearance`.
In the *Fonts* section, find the "Font Weight" option showing your current weight (e.g., "Font Weight: Normal").
Click the `Dropdown Arrow` next to the current font weight to open the font weight options.
Choose from the following options:
* **Thin**: Lightest font weight for minimal visual weight
* **Normal**: Standard font weight (default)
* **Medium**: Slightly bolder than normal
* **Bold**: Heaviest font weight for maximum emphasis
Spacing
Adjust the spacing and layout density of the Pieces interface. Control how much information is displayed and how much space elements take up.
Visual Density
Adjust the spacing and layout density of the Pieces interface. Choose between Tight, Compact, or Standard to control how much information is displayed and how much space elements take up.
Click your `User Profile` in the top left, then hover over `Settings` and select `Appearance`.
In the *Spacing* section, find the "Visual Density" option showing your current density (e.g., "Visual Density: Standard").
Click the `Dropdown Arrow` next to the current visual density to open the density options.
Choose from the following options:
* **Tight**: Maximum density with minimal spacing, showing more content in less space
* **Compact**: Moderate density with reduced spacing
* **Standard**: Default density with comfortable spacing (default)
Controls spacing, padding, and overall compactness of the interface. Tight = minimal spacing, Compact = balanced, Standard = generous spacing.
Next Steps
Now that you understand how to customize Appearance, learn about Models to configure AI models and processing modes, or explore Troubleshooting to access support resources and view app information.
