/usage

name: daisyui-usage
description: MANDATORY usage rules for daisyUI 5

daisyUI 5 usage rules

1. We can give styles to a HTML element by adding daisyUI class names to it. By adding a component class name, part class names (if there's any available for that component), and modifier class names (if there's any available for that component) 2. Components can be customized using Tailwind CSS utility classes if the customization is not possible using the existing daisyUI classes. For example `btn px-10` sets a custom horizontal padding to a `btn` 3. If customization of daisyUI styles using Tailwind CSS utility classes didn't work because of CSS specificity issues, you can use the `!` at the end of the Tailwind CSS utility class to override the existing styles. For example `btn bg-red-500!` sets a custom background color to a `btn` forcefully. This is a last resort solution and should be used sparingly 4. If a specific component or something similar to it doesn't exist in daisyUI, you can create your own component using Tailwind CSS utility 5. when using Tailwind CSS `flex` and `grid` for layout, it should be responsive using Tailwind CSS responsive utility prefixes. 6. Only allowed class names are existing daisyUI class names or Tailwind CSS utility classes. 7. Ideally, you won't need to write any custom CSS. Using daisyUI class names or Tailwind CSS utility classes is preferred. 8. Suggested - if you need placeholder images, use https://picsum.photos/200/300 with the size you want 9. Suggested - when designing, don't add a custom font unless it's necessary 10. Don't add `bg-base-100 text-base-content` to body unless it's necessary 11. For design decisions, use Refactoring UI book best practices 12. Always use the default variant of daisyUI components unless the user asked for a specific variant or color. For example when you need a button, do not use `btn btn-primary`, prefer `btn`, unless the user asked for a specific variant.

daisyUI 5 class names are one of the following categories. These type names are only for reference and are not used in the actual code

• `component`: the required component class
• `part`: a child part of a component
• `style`: sets a specific style to component or part
• `behavior`: changes the behavior of component or part
• `color`: sets a specific color to component or part
• `size`: sets a specific size to component or part
• `placement`: sets a specific placement to component or part
• `direction`: sets a specific direction to component or part
• `modifier`: modifies the component or part in a specific way
• `variant`: prefixes for utility classes that conditionally apply styles. syntax is `variant:utility-class`

Customizing a component in CSS

Use Tailwind's `@utility` directive to customize a daisyUI component globally:

@utility btn {
  @apply rounded-full;
}

daisyUI utilities and variables

• Semantic colors work with Tailwind color utilities and opacity modifiers, for example `bg-primary`, `border-base-300`, and `text-base-content/60`.
• `rounded-box`, `rounded-field`, and `rounded-selector` use the active theme's radius tokens.
• `glass` applies the daisyUI glass effect.
• Components can expose CSS variables for component-specific customization. Examples include `--value` and `--digits` on countdown, and `--size` and `--thickness` on radial progress.

Base modules

daisyUI includes the `properties`, `rootcolor`, `scrollbar`, `rootscrolllock`, `rootscrollgutter`, and `svg` base modules. Exclude an unwanted module from the plugin config by its module name:

@plugin "daisyui" {
  exclude: rootscrollgutter;
}

Use `include` or `exclude` for library modules; use Tailwind utilities or `@utility` for visual customization.