Skip to content

Bulma Tailwind Integration

This guide explains how to integrate Bulma CSS with TailwindCSS in your Katana UI project, combining the best of both frameworks.

The integration provides:

  • Bulma: Component-based CSS framework with pre-designed components
  • TailwindCSS: Utility-first CSS framework for rapid custom styling
  • Katana UI: Custom components with consistent design system
  1. Install the required dependencies:
Terminal window
bun add bulma tailwindcss sass
  1. Initialize TailwindCSS configuration:
Terminal window
# Create tailwind.config.js manually if needed
  1. Configure the build process to include Bulma and TailwindCSS styles.

Create a tailwind.config.js file:

/** @type {import('tailwindcss').Config} */
export default {
content: [
"./index.html",
"./src/**/*.{js,ts,jsx,tsx,scss}",
"./packages/ui/**/*.{js,ts,jsx,tsx,scss}",
],
theme: {
extend: {
colors: {
"bulma-primary": "#00d1b2",
"bulma-secondary": "#209cee",
"bulma-dark": "#23d160",
"bulma-light": "#3273dc",
},
},
},
plugins: [],
};
src/styles/
├── main.scss # Main SCSS file with Bulma imports
├── variables.scss # Custom variables
└── custom.scss # Custom styles combining both frameworks
<!DOCTYPE html>
<html lang="en">
<head>
<!-- Bulma CSS -->
<link
rel="stylesheet"
href="https://cdn.jsdelivr.net/npm/bulma@1.0.0/css/bulma.min.css"
/>
<!-- TailwindCSS -->
<script src="https://cdn.tailwindcss.com"></script>
<!-- Custom combined styles -->
<link rel="stylesheet" href="path/to/combined-styles.css" />
</head>
<body>
<!-- Your content here -->
</body>
</html>
<!-- Pure Bulma button -->
<button class="button is-primary">Bulma Button</button>
<!-- Pure TailwindCSS button -->
<button
class="px-4 py-2 bg-blue-500 text-white rounded hover:bg-blue-600 transition-colors"
>
Tailwind Button
</button>
<!-- Combined button -->
<button class="btn-combined is-primary">Combined Button</button>
<!-- Bulma card -->
<div class="card">
<div class="card-header">
<p class="card-header-title">Bulma Card</p>
</div>
<div class="card-content">
<p class="content">Card content</p>
</div>
</div>
<!-- TailwindCSS card -->
<div class="bg-white rounded-lg shadow-md p-6">
<h3 class="text-xl font-semibold mb-2">Tailwind Card</h3>
<p class="text-gray-600">Card content</p>
</div>
<!-- Combined card -->
<div class="card-combined">
<div class="card-header">
<p class="card-header-title">Combined Card</p>
</div>
<div class="card-content">
<p class="content">Combined content</p>
</div>
</div>
<form class="form-combined">
<div class="field">
<label class="label">Name</label>
<div class="control">
<input type="text" class="input-combined" placeholder="Your name" />
</div>
</div>
<div class="field">
<label class="label">Email</label>
<div class="control">
<input type="email" class="input-combined" placeholder="your@email.com" />
</div>
</div>
<button type="submit" class="button is-primary">Submit</button>
</form>
<!-- Bulma alert -->
<div class="notification is-primary">This is a Bulma notification</div>
<!-- TailwindCSS alert -->
<div class="bg-blue-100 border border-blue-400 text-blue-700 px-4 py-3 rounded">
This is a Tailwind alert
</div>
<!-- Combined alert -->
<div class="alert-combined is-info">
<p class="title">Information</p>
<p>This is a combined alert</p>
</div>
  • .btn-combined - Buttons combining Bulma and TailwindCSS
  • .card-combined - Cards with enhanced styling
  • .form-combined - Form components with both frameworks
  • .alert-combined - Alert/notification components
  • .table-combined - Enhanced table styling
  • .nav-combined - Navigation components

The integration provides utility classes that combine both frameworks:

  • .is-primary, .is-secondary, .is-success, .is-danger - Color variants
  • .hover:shadow-lg, .hover:shadow-xl - Enhanced hover effects
  • .transition-colors, .transition-shadow - Smooth transitions

You can customize the integration by modifying src/styles/variables.scss:

// Override Bulma variables
$primary: #ff6b6b;
$secondary: #4ecdc4;
$success: #45b7d1;
$danger: #f9ca24;
// Add custom TailwindCSS utilities
@tailwind base;
@tailwind components;
@tailwind utilities;

Use the provided mixins to create custom components:

// Bulma mixin
.my-bulma-button {
@include bulma-button;
}
// TailwindCSS mixin
.my-tailwind-button {
@include tailwind-button;
}

The build process automatically compiles and concatenates all styles:

  1. Bulma SCSS → dist/bulma-tailwind.css
  2. TailwindCSS → dist/bulma-tailwind.css
  3. Katana UI → dist/components.css
  4. Concatenation → dist/styles.css
  • Bulma: Use for pre-designed components that need consistency
  • TailwindCSS: Use for rapid prototyping and custom layouts
  • Combined: Use when you need the best of both worlds
  • Use the combined components for consistency across your application
  • Follow the established naming conventions
  • Test thoroughly across different screen sizes
  • Use the combined styles to avoid loading multiple CSS files
  • Minimize custom CSS to maintain performance
  • Use CSS variables for theming
  • Both frameworks include responsive utilities
  • Combine them for enhanced responsive behavior
  • Test on multiple devices
  1. CSS Conflicts: Use cascade layers to avoid conflicts
  2. Missing Styles: Ensure all imports are correct
  3. Build Errors: Check SCSS syntax and file paths
  • Use browser dev tools to inspect styles
  • Check the generated CSS files
  • Test with minimal examples first

See the examples/bulma-tailwind-demo.html file for a complete working example of the integration.

The Bulma + TailwindCSS integration provides the best of both worlds:

  • Rapid development with pre-designed components
  • Custom styling capabilities
  • Consistent design system
  • Enhanced responsive design

Use this integration to create beautiful, responsive, and maintainable user interfaces.