Skip to content

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

Notifications You must be signed in to change notification settings

pdanzma/kage-css

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

73 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Kage CSS (影 = Shadow) — Custom Glassmorphism CSS

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

  • Search results Search Results

  • Searchbar Searchbar

  • Quick Answer Comments

  • Domain info Domain Info

  • Dropdowns Dropdown

  • Glassy Dropdown Glassy Dropdown

  • Assistant Assistant

  • Assistant Prompt Box Assistant Prompt Box

  • News Tab News

  • Podcasts Tab Podcasts

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

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

Search Bar Positioning

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.

/* If Firefox has problems with the blur effect, comment out this code. <--- delete this line

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

delete this line too ---> */

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:

--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.

Buy Me A Coffee

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

08. October 2025

v3.1 kagi update hotfix

This hotfix adapts to changes in Kagi Search and Assistant. These include the new Assistant layout and the "Quick Answer" button. And the search bar on mobile devices has been improved and made semi-transparent. For best results, set the search bar position to "bottom". Additionally, the following bugs have been fixed:

  • paywall popup now adapts to dark mode
  • website ranking adjustments now have a smooth transition

@Temanor:

  • "I think the assistant got some changes. Model selection and file attachment looks strange."

Cakeboss:

  • "I found another issue on mobile when using brave on assistant. When making tables it will not let me scroll to the right. But when I turn off css it allows me to scroll to the right"

Daniel Travassos:

  • "I prefer to use Microsoft Edge with the zoom set to 125%; I reverted to 100% but some issues persist."

@Zeuhx:

  • "Alignment here too"
  • "Text alignment when I click on "More""

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 :)

About

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

Topics

Resources

Stars

Watchers

Forks

Contributors 2

  •  
  •  

Languages