search

🎨Themes

How to change the branding of your project from a list of 20+ options by changing one word.

hashtag
Tailwind CSS 4 Setup 🆕

LightningRails uses Tailwind CSS 4 with the tailwindcss-rails gem for optimal performance and a better development experience. The configuration is located in app/assets/tailwind/application.css.Key benefits of this setup:

  • Faster build times

  • Better integration with Rails asset pipeline

  • More flexibility for custom configurations

  • Automatic purging of unused CSS

hashtag
Changing Themes with DaisyUI

DaisyUI offers a variety of themes that you can easily apply to your Ruby on Rails application. To change the theme with DaisyUI default configuration, you would need to add and change data-theme attribute in the <html> tag of your application.html.erb layout file.

However, Lightning Rails comes by default with a theme toggle for dark and light theme. To change the tehme follow these steps:

hashtag
(Option A) Change the Dark/Light Theme

  1. Open your config/meta.yml file.

  2. Locate the LIGHT_THEME and DARK_THEME meta's

  3. Update value with the desired theme name. For example:

You can replace "cupcake" with any theme name provided by DaisyUI.

circle-info

Don't forget to restart your server for every change you do int the meta.yml 💡

hashtag
(Option B) Change the config to only have one Theme

  1. Comment out or delete the theme toggle in _navbar.html.erb

  2. Comment out or delete the variable in meta.yml:

  3. in application.html.erb replace:

    2. By your theme of choice: <html data-theme="cupcake">

  4. Comment out or delete the theme_controller.js file..

Et voila, those are the two ways of changing your theme with Lightning Rails, either by keeping the Dark/light logic or removing it and changing a single theme at a time.

hashtag
Available Themes

To see the different themes you can choose from, check the DaisyUI documentation or their themes page below:

Check DaisyUI Themesarrow-up-right

All the themes available from DaisyUI and therefore LighningRails

hashtag
How do we change the theme?

In application.html.erb by changing the data-theme attribute in the <body> tag, you can quickly switch between these themes, allowing for a customizable look and feel for your application!

hashtag
Can we change other Tailwind libraries?

Most definitely! DaisyUi has a lot of components but frankly lacks pre-designed sections, for us developers who don't want to spend hours creating for scratch. You can easily find more Tailwind components in the HyperUIarrow-up-right library.

HyperUI library with many components

Find a component you like? Just copy/paste it into your LightningRails project.

circle-info

Pro Tip: Avoid hard-coded color classes in non-DaisyUI components (like HyperUI). For example, using a class like bg-white won’t adapt to theme changes. This can result in a dark theme with a mismatched white background—definitely not ideal. 😅

hashtag
Custom Theme

If you wish to add a custom theme or modify an existing one. We won't be able to do it on the tailwind config file. However, Lightning Rails now uses Tailwind CSS 4 with the tailwindcss-rails gem, which provides better performance and more flexibility than the CDN approach. DaisyUI is integrated via CDN import in the Tailwind configuration.

Here is how to create your custom theme:

hashtag
Custom Theme Colors

In app/assets/tailwind/application.css, create a custom theme using the new Tailwind CSS 4 syntax:

Then call the new theme in your meta.yml

See all the DaisyUI variables you can customize in your custom theme herearrow-up-right.

hashtag
Customize fonts

To customize the default fonts of your projects, import the custom fonts in tailwind/application.css and assign them to your headers and paragraphs in the same file.

PreviousQuickstartNextCustomize the views

Last updated