Skip to content

A userstyle that enhances Coolify's UI by applying opinionated tweaks, spacing, colors, and layout fixes, to make the UI more polished and user-friendly.

License

Notifications You must be signed in to change notification settings

techwithanirudh/coolify-tweaks

Repository files navigation

banner

Coolify Tweaks

version stars forks install with Stylus install from userstyles.world

About

A userstyle that enhances Coolify's UI by applying opinionated tweaks, spacing, colors, and layout fixes, to make the UI more polished and user-friendly.

View Screenshots →

Backstory

With Coolify v5's redesign set for 2026, I couldn't just sit around waiting for the visual upgrades. Coolify is really powerful, but a lot of people in the community feel like the UI gets in the way sometimes.

Instead of waiting for the official update, I decided to take things into my own hands. Coolify Tweaks isn't a full redesign, it's a restyle. It's a preview of what Coolify v5 might look and feel like.

I cleaned up the spacing, adjusted the colors, tweaked the typography, and gave the layout a more modern vibe. It's still the same Coolify under the hood, just with a smoother, more intuitive interface.

Installation

Note: The bundled Nitro API in this Monorepo serves dynamic builds of the style, injecting TweakCN theme code on demand so every installation link stays up to date.

  1. Install Stylus.

  2. Hit the badge below to add the style:

    install with Stylus

    OR

    install from userstyles.world

  3. Running Coolify on something other than coolify.local?
    Open the style’s Settings pane in Stylus, then under Custom included sites add your host using a wildcard. For example:

    Stylus Settings
    *://192.168.0.123:8000/*

    Replace the IP and port above with your Coolify instance’s address, then click Save.

  4. Experiencing Style Issues? If you notice style changes are slow, laggy, or not applying immediately, enable Instant Mode in Stylus. This forces styles to inject instantly on page load, eliminating delays.
    Stylus Instant Mode

Theming

Coolify Tweaks supports custom themes through integration with TweakCN, allowing you to personalize your Coolify interface with beautiful color schemes and styling variations.

How to Apply a Custom Theme

  1. Browse Available Themes
    Visit TweakCN to explore available themes or create your own custom theme.

  2. Get the Theme ID
    When you find a theme you like:

    • Click the Share button on the theme
    • Copy the theme ID (e.g., bubblegum, claude, or cmd1ndlp3000504l24z7vgywd)
  3. Install with Theme
    Use the themed installation URL in Stylus:

    https://coolify-tweaks-api.techwithanirudh.com/release/latest/?theme=THEME_ID&asset=main.user.css
    

    Replace THEME_ID with your copied theme identifier.

    Note: The theme query parameter should come first, as Stylus identifies user styles by URLs ending with user.css

Video Guide

If you prefer watching instead, here’s a short walkthrough:

Watch the video

Troubleshooting Themes

Theme not applying?

  • Ensure you're using the correct theme ID
  • Try refreshing the page or restarting your browser

Mixed styling issues?

  • Clear your browser cache
  • Disable and re-enable the style in Stylus
  • Make sure you're not running multiple conflicting styles

Repo Context

This repository is implemented as a Turborepo workspace so the userstyle, API proxy, and future tooling can evolve together.

  • apps/style holds the Sass build pipeline that compiles the userstyle and publishes assets via Changesets.
  • apps/api is a lightweight Nitro service that proxies release assets for easier distribution.
  • apps/web is a Next.js playground used to test UI integrations while sharing utilities from packages.
  • Shared tooling lives under tooling/* for linting, formatting, and TypeScript configuration, keeping all packages aligned.

Contributing

Got an idea or feature request? Open an issue and let’s chat, or read the contributing guide.

License

Released under the MIT license.

About

A userstyle that enhances Coolify's UI by applying opinionated tweaks, spacing, colors, and layout fixes, to make the UI more polished and user-friendly.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Contributors 3

  •  
  •  
  •