guava-themes

A few Emacs themes inspired by guavas (and other plants).

Table of Contents

• Introduction
• Installation
• Screenshots
• Contributions
• Image Attributions
• License

Introduction

This package began as an specific idea: what if I could create an Emacs theme based on my favorite fruit? And what if it was a light theme, but not too light?
So here it is. My first Emacs package / pack of themes.
Originally conceived as a tribute to the guava fruit, this pack of themes ended up being inspired by different types of plants I found eye-catching.
And so, the package name became an Artifact Title, as is known in the tropes community.

Installation

• You can make use of the macro use-package to automatically install guava-themes from MELPA:

(use-package guava-themes
  :ensure t
  :custom
  (ring-bell-function #'guava-themes-change-visible-bell)
  (visible-bell t)
  :config
  (load-theme 'guava-themes-psidium t)
  )

• You can also install guava-themes with this code:

(unless (package-installed-p 'guava-themes)
  (package-install 'guava-themes))

(require 'guava-themes)

(setopt ring-bell-function #'guava-themes-change-visible-bell)
(setopt visible-bell t)
(load-theme 'guava-themes-psidium t)

Screenshots

• Guava Psidium Theme

• Guava Jacaranda Theme

• Guava Prunus Theme

• Guava Dracaena Theme

• Guava Acer Theme

• Guava Cordyline Theme

• Guava Rhododendron Theme

• Guava Ceiba Theme

• Guava Citrus Theme

• Guava Solanum Theme

• Guava Vaccinium Theme

• Guava Rubus Theme

• Guava Pyrus Theme

• Guava Petunia Theme

• Guava Malus Theme

• Guava Eucalyptus Theme

TODO

• Add themes: Ficus.
• (Emacs 31) Add header-line-active and header-line-inactive faces
• (Emacs 31) Add tab-line-active and tab-line-inactive faces

Contributions

Issues, pull requests, and forks are welcome.

Here is a tentative list of things to consider when contributing:

• When adding or modifying something that changes the visuals of Emacs (e.g. a face), make sure to include screenshots of the original and changed versions.
• When making a pull request, make sure the commits adhere to the Conventional Commits specification.
• Make sure commits are modular; one feat/fix/doc/etc at a time.

Image Attributions

Unless otherwise stated, all images used, linked, displayed, and/or referenced in this repository were created by me (https://github.com/bormoge) under the CC BY-SA 4.0 license.

License

SPDX-License-Identifier: GPL-3.0-or-later

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.