kage-css

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 114 Open GitHub ↗

This custom CSS theme significantly enhances the user experience of the "Kagi" search engine by incorporating glassmorphism visuals, modern animations and customisable colour options.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<p align="center">    
<strong>Kage CSS (影 = Shadow) — Custom Glassmorphism CSS</strong>
<p>

A polished, animated glassmorphism theme for the Kagi search engine. Clean UI, subtle motion, consistent styling across results, images, videos, news, and podcasts.

## Gallery (Static Images)

- Start page
![Start Page](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/startpage.png)

- Search results
![Search Results](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/search-results.png)

- Searchbar
![Searchbar](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/search-bar.png)

- Quick Answer
![Comments](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/quick-answer.png)

- Domain info
![Domain Info](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/domain-info.png)

- Dropdowns
![Dropdown](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/dropdown.png)

- Glassy Dropdown
![Glassy Dropdown](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/glassy-dropdown.png)

- Assistant
![Assistant](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/assistant.png)

- Assistant Prompt Box
![Assistant Prompt Box](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/prompt-box.png)

- News Tab
![News](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/news.png)

- Podcasts Tab
![Podcasts](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/podcasts.png)

## Overview

kage-css is a custom stylesheet that gives Kagi a refined glassmorphism look with smooth transitions and a cohesive UI.

## Features

- Glassmorphism visuals for navigation, settings, and key UI elements
- Thoughtful documentation and structure for easy customization
- Smooth animations and hover effects
- Enhanced buttons, search bar, and results layout
- Responsive across desktop and mobile
- Easy color customization via variables at the top of the file
- Uniform styling for results, images, videos, news, and podcasts

## Installation

1) Download custom.css from this repository.
2) In Kagi, enable custom CSS: https://kagi.com/settings?p=custom_css
3) Paste the entire CSS into the input field.
4) Save and refresh Kagi.

Recommended setting: Set URL placement to “Above Title” under Appearance for best visual alignment. (With the latest update, the theme can now be used without the following setting.)

![URL Positioning](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/url-positioning.png)

Recommended setting for mobile devices: For best results, set the search bar position to "bottom".

![Search Bar Positioning](https://raw.githubusercontent.com/pdanzma/kage-css/main/images/search-bar-positioning.png)

> [!IMPORTANT]
> The theme only works correctly if you set it to dark mode.

If you encounter problems with glass morphing in Firefox, this is not a problem and does not prevent you from using this theme. Simply add this element to the css.

```css
@-moz-document url-prefix() {
  .backdrop-blur-elements {
    backdrop-filter: none !important;
    -webkit-backdrop-filter: none !important;
    background: var(--backdrop-fallback) !important;
  }
} 
```

compressed version:
```css
@-moz-document url-prefix(){.backdrop-blur-elements{backdrop-filter:none!important;-webkit-backdrop-filter:none!important;background:var(--backdrop-fallback)!important}}
```

## Customization

Feel free to customize the theme's colors as you wish. To do this, you can adjust the variables at the beginning of the CSS file. Here you will also find a short description for each variable:

```css
--bg-primary: #17191e;                          /* Main page background */
--bg-secondary: #1A1B22;                        /* App background */
--bg-tertiary: #1e2028;                         /* Input fields, secondary areas */
--bg-container: #24252F;                        /* Containers, cards, panels */
--bg-elevated: #2A2B36;                         /* Elevated elements (hover, active) */
--bg-modal: #121213;                            /* Modal background */
--bg-dropdown: #34373f;                         /* Dropdown hover */
--bg-special: #28282a;                          /* Wikipedia results */
--bg-citation: #2d2f2f;                         /* Citation background */
--bg-separator: #222222;                        /* Separators, gaps */

--text-primary: #EAEAEA;                        /* Primary text (light) */
--text-secondary: #A0A0B4;                      /* Secondary text */
--text-muted: #b3b7bb;                          /* Summary text */
--text-citation: #8d9191;                       /* Citation text */
--text-dark: #1b1b1b;                           /* Dark text on light buttons */
--text-very-dark: #232325;                      /* Very dark text */
--text-light: #fdfdfd;                          /* Very light text (tooltips) */

--button-bg: #6B7280;                           /* Default button background */
--button-hover: #9CA3AF;                        /* Button hover background */
--link-visited: #8B89A3;                        /* Visited links */
--link-hover: #9CA3AF;                          /* Link hover color */
--source-highlight-color: #A1A1AA;              /* Source highlight */
--theme-switch-hover: #2a2d38;                  /* Theme switch hover */

--status-good: #a5d46a;                         /* Normal */
--status-mid: #ffdf80;                          /* Warning */
--status-danger: #ffa080;                       /* Danger */
--auto-suggestion: rgba(29, 237, 131, 0.2);     /* Auto-completion */

--timestamp-bg: rgba(49, 49, 53, 0.8);          /* Timestamp background */
--backdrop-fallback: rgba(30, 32, 40, 0.95);    /* Backdrop without blur */
--dropdown-bg: rgba(30, 32, 40, 0.32);          /* Dropdown background */
--border-thread: rgba(255, 255, 255, 0.28);     /* Thread menu border */

--shadow-medium: rgba(0, 0, 0, .2);             /* Light shadow */
--shadow-strong: rgba(0, 0, 0, .4);             /* Medium shadow */
--shadow-dark: rgba(0, 0, 0, .6);               /* Strong shadow */
--shadow-very-dark: rgba(0, 0, 0, .7);          /* Very strong shadow */
```

## Donation

This theme took a great deal of time to get to the level it is at today. I don't expect any payment and did everything purely to support the Kagi Network. If you use one of my themes and would like to support me financially, you are welcome to do so via the button below.

I am very grateful for every donation! If you would like your name to be displayed below as a sponsor, feel free to write to me on Discord or Reddit, and I will add you here as a sponsor.

The theme will continue to be updated, even without a single donation! This is just meant to be an option, not an obligation. A donation does not unlock any additional features or a "special version" of the theme.

## Animations

- Results fade-in as they load
- Pleasant hover transitions on links and buttons
- Subtle tile and component motion for a lively feel

## What’s New

### 21. October 2025

**v3.3 bug fixed and comeback of addons**

This update reintroduces the addons. Unfortunately, I can't provide the complete theme as a single CSS file because of the 40,000 character limit for Custom CSS. Therefore, the least used page is now available as an addon (Podcast-addon.css). Currently, it is not possible to use the addon and the custom.css at the same time. To do so, you have to remove individual elements from the custom.css and replace them with the compressed version from the addon. The compressed version can be found at the end of the podcast-addon.css document. Please forgive me for this inconvenience.

The following elements have been adjusted:
- The clear button for selecting search parameters has been adjusted.
- The timestamps have been color-adjusted (see Discord poll)

Additionally, the following bugs have been fixed:
@Temanor:
- "The active page button is a bit low contrast when you hover over it."
- "Info icon in quick answers is barely visible."

@Zeuhx:
- "Some problem with the light when I click on the tab"
- "On Kagi search, image tab, when I want to upload a image"

And as always, thank you all for your support on Discord!!

## Roadmap

### Near-term
- [ ] Reduce the performance impact
- [ ] Optional compact density mode (tighter paddings and gaps)
- [ ] Fix z-index bugs

### Mid-term

### Omnipresent

- [ ] Always update to the latest changes of Kagi
- [ ] Adapt bug report from discord thread

## Tips & Notes

- Not affiliated with Kagi. This is a community theme.

## Contributing

Issues and ideas are welcome. If you spot a bug or have suggestions, reach out on Discord in kagi-discussions → “UI Design Ideas for my custom css”.

Discord thread: https://discord.com/channels/1256077108111868035/1265596713083732060

## Credits

Created by pdanzma. Inspired by modern search UIs (e.g., Google and Brave) with many original touches.

## License

See LICENSE file for terms. Feel free to fork this project and change it to your needs :)

kage-css

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README