Instruction file imported from martinfrommel/dose-bot (.github/instructions/daisyui.instructions.md). Copyright stays with the author.

daisyUI 4

daisyUI 4 is a CSS library for Tailwind CSS 3 daisyUI 4 provides class names for common UI components

• daisyUI 4 docs

daisyUI 5 install notes

install guide

1. daisyUI 4 requires Tailwind CSS 3
2. tailwind.config.js file is deprecated in Tailwind CSS v4. do not use tailwind.config.js. Tailwind CSS v4 only needs @import "tailwindcss"; in the CSS file if it's a node dependency.
3. daisyUI 5 can be installed using npm i -D daisyui@latest and then adding @plugin "daisyui"; to the CSS file
4. daisyUI is suggested to be installed as a dependency but if you really want to use it from CDN, you can use Tailwind CSS and daisyUI CDN files:

<link href="https://cdn.jsdelivr.net/npm/daisyui@5" rel="stylesheet" type="text/css" />
<script src="https://cdn.jsdelivr.net/npm/@tailwindcss/browser@4"></script>

5. A CSS file with Tailwind CSS and daisyUI looks like this (if it's a node dependency)

@import "tailwindcss";
@plugin "daisyui";

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

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

Config

daisyUI 4 config docs: https://v4.daisyui.com/docs/config