An open API service indexing awesome lists of open source software.

https://github.com/beeper/themes

Custom CSS for Beeper Desktop by the community
https://github.com/beeper/themes

Last synced: about 2 months ago
JSON representation

Custom CSS for Beeper Desktop by the community

Awesome Lists containing this project

README

          

# Community-built themes for Beeper Desktop

> [!NOTE]
> Community-built themes are not entitled to the usual level of customer support on Beeper. If you need help with themes, please join [#beeper:beeper.com] instead of contacting support via usual methods.

Beeper Desktop is fully customizable. You can use custom CSS to give Beeper Desktop a personalized look. If you build a nice theme, consider submitting a pull request to this repo to share it with other Beeper users!

### How to use themes
1. Click [Themes](./current-v4) → select the theme you would like to try
2. Select the text content and copy. This code is called CSS.
3. Open Beeper Desktop → Settings → Appearance
4. Scroll to the `Custom CSS` section.
5. Click `Open CSS file in editor`.
6. Replace the file's contents by pasting the CSS you copied earlier and save the file.
7. Click `Reload CSS` (*not* `Reset CSS`) in the Beeper Desktop → Settings → Appearance menu.
8. Enjoy your newly installed theme!

> [!NOTE]
> Custom themes may cause visual bugs on Beeper Desktop. If you encounter issues with a theme, you can reset to the default Beeper Desktop theme by clicking `Reset CSS` in the Beeper Desktop → Settings → Appearance menu under the `Custom CSS` section.

### How to submit a new theme

Submit a Pull Request to this repository with the CSS file, a screenshot of your theme, and short description.

View [variables.css](https://github.com/beeper/themes/tree/main/current-v4/variables.css) for default values excerpted from the [Beeper Texts Theme.](https://github.com/beeper/themes/tree/main/current-v4/texts.css)

---

### Try the Beeper Texts Theme

The [Beeper Texts Theme](https://github.com/beeper/themes/tree/main/current-v4/texts.css) is a custom CSS theme for Beeper Desktop v4 that transposes the best parts of the legacy [Texts.app](https://texts.com/) theme to work with Beeper.

#### Recommended Appearance Settings

Use the settings recommended below in Beeper Desktop → Settings → Appearance for the best look:

Chat List
Conversation View

#### Theme Previews

**Light Mode**

Screenshot 2025-10-08 at 17 33 56

**Dark Mode**

Screenshot 2025-10-08 at 17 33 47