# Kavita Themes
This will serve as a central hub to store all community made themes

**Themes are provided as-is. Any issues with the themes need to be directed to the theme's author.**

---
## Native Themes
| Theme Name | Author | Description                                         | Kavita Compatibility | Preview | Total Installs |
|------------|--------|-----------------------------------------------------|----------------------|---------|----------------|
| Light      | [gmahomarf](https://github.com/gmahomarf)     | A light theme for those that don't like—or can't use—dark themes | 0.8.8               | [Preview](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/Light/preview.png) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=Light"/> |
| Dark-Pre-Overhaul     | [majora2007](https://github.com/majora2007)     | The dark theme from v0.8.2 for those that don't like the newer dark theme | 0.8.2               | [Pre1](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/Dark-Pre-Overhaul/preview1.png) [Pre2](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/Dark-Pre-Overhaul/preview2.png) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=Dark-Pre-Overhaul"/> |
| DarkNight  | [Elry](https://github.com/ElryWeeb)             | A very Dark Theme, for the Darkmode lovers.         | 0.7.14               | [Pre1](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/DarkNight/preview1.png) [Pre2](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/DarkNight/preview2.png) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=DarkNight"/> |
| CutePink	 | [Elry](https://github.com/ElryWeeb)             | A cute and soft Pink Theme.						 | 0.7.14               | [Preview](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/CutePink/preview.png) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=CutePink"/> |
| Brilliance | [Elry](https://github.com/ElryWeeb)             | A modern theme for e-ink devices.				     | 0.7.14               | [Preview](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/Brilliance/preview.png) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=Brilliance"/> |
| E-Ink      | [majora2007](https://github.com/majora2007)     | A simplified theme for e-ink devices                | 0.8.2                | [Preview](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/E-Ink/preview.jpg) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=E-Ink"/> |
| Nord       | [ice45core0](https://github.com/ice45core0)     | A dark pastel theme using the Nord color palette    | 0.7.14               | [Preview](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/Nord/preview.png) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=Nord"/> |
| Dracula    | [Matguitarist](https://github.com/matguitarist) | A Dracula inspired theme                            | 0.7.14               | [Preview](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/Dracula/preview.jpg) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=Dracula"/> |
| Overseerr  | [Matguitarist](https://github.com/matguitarist) | A Overseer inspired theme                           | 0.7.14               | [Preview](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/Overseerr/preview.jpg) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=Overseerr"/> |
| Aquamarine | [Matguitarist](https://github.com/matguitarist) | An Aquamarine theme                                 | 0.7.14               | [Preview](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/Aquamarine/preview.jpg) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=Aquamarine"/> |
| Solarized  | [Matguitarist](https://github.com/matguitarist) | A Solarized theme                                   | 0.7.14               | [Preview](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/Solarized/preview.jpg) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=Solarized"/> |
| DarkPink   | [Matguitarist](https://github.com/matguitarist) | A Darkpink theme                                    | 0.7.14               | [Preview](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/DarkPink/preview.jpg) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=DarkPink"/> |
| Battery-Saver-Dark-Mode | [RPLgrime](https://github.com/RPLgrime) | A dark mode with gray text and reduced brightness on images.  | 0.8.2  | [Preview](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/Battery-Saver-Dark-Mode/preview.jpg) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=Battery-Saver-Dark-Mode"/> |
| No-Colorscape | [RPLgrime](https://github.com/majora2007) | Everything Kavita but with the Colorscape system turned off  | 0.8.3  | [Preview 1](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/No-Colorscape/preview-1.png) [Preview 2](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/No-Colorscape/preview-2.png) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=No-Colorscape"/> |
| Chapter-List-View | [Zeoic](https://github.com/Zeoic) | Changes the chapter card view into a list without thumbnails | 0.8.3  | [Preview](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/Chapter-List-View/preview.png) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=Chapter-List-View"/> |
| ElegantFin | [enieuwy](https://github.com/enieuwy/) | Soft "glass" header, decluttered covers, long multi-line titles, rounded corners, cover mouse-over animations, & space-saving for first-class library view on mobile | 0.8.9.0 | [Library, mobile](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/ElegantFin/Library,%20mobile.png) [Library, large](https://github.com/Kareadita/Themes/blob/main/Native%20Themes/ElegantFin/Library,%20large.png) | <img src="https://img.shields.io/endpoint?url=https://stats.kavitareader.com/api/ui/theme-users?theme=ElegantFin"/> |


### Native Theme Installation (pre-v0.8.2.0)
1. Download the `theme-name.css` file.
2. Place it in the `/config/themes` folder of your [Kavita](https://github.com/Kareadita/Kavita) installation.
3. Within Kavita, navigate to your user settings and click the Theme tab.
4. Click the Scan button.
5. Apply and/or Set Default your newly added theme.

### Native Theme Installation (v0.8.2.0+)
1. In the upper right corner of Kavita, drop down your Username > Settings > Theme tab, then download and apply the desired theme from this repo.

---

## Style Injected Themes
| Theme Name | Author | Description                                         | Kavita Compatibility | Preview | 
|------------|--------|-----------------------------------------------------|----------------------|---------|
| Plex-like      | [MrRobotjs](https://github.com/MrRobotjs)    | A Plex-inspired theme                | ?           | [Preview](https://github.com/Kareadita/Themes/blob/main/Style%20Injected%20Themes/Plex-like/preview.png)
|            |        |                                                     |                      |

### Style Injected Theme Installation
1. Install a style injector extension for your browser, like [xStyle](https://chrome.google.com/webstore/detail/xstyle/hncgkmhphmncjohllpoleelnibpmccpj/related?hl=en)
2. Download the theme scss/css.
3. If necessary edit the theme with the domain where your Kavita install is running.
4. If scss, compile to css using your preferred method. [You can do it online.](https://www.cssportal.com/scss-to-css/)
5. Install the theme in the style injector extension.
6. Load/Refresh your Kavita site.

---
## Contributing
1. Clone the repo.
2. Create a folder with your theme name in the appropriate top level folder (native or style injected).
3. Add your `theme-name.css` file inside the created folder with the appropriate filename. 
    - You can optionally add a preview image with the following format: `preview.ext` (feel free to add multiple showcasing your theme)
4. Add your theme to the `README.md` table with all fields filled out. Ensure the Theme Name matches the Folder name exactly.
5. Submit a PR.

! Note: Your folder name and theme filename should match for the theme to work correctly in Kavita.

---
## Issues
If you have an issue, raise an Issue with the theme name in the title i.e. `[Light] Side Nav not readable on mobile` and tag the person from the Readme table. 
Kavita team does not provide support on any themes, even those created by majora2007. 

If you identify bugs in the themeing, please raise an Issue on the Kavita Github for support or development work. Theme feature requests belong on the Kavita Discussions. 

---
## Creating a Theme
Please follow the documentation on our Wiki: https://wiki.kavitareader.com/guides/themes
