Bulma Tailwind Integration
Bulma + TailwindCSS Integration Guide
Section titled “Bulma + TailwindCSS Integration Guide”This guide explains how to integrate Bulma CSS with TailwindCSS in your Katana UI project, combining the best of both frameworks.
Overview
Section titled “Overview”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
Installation
Section titled “Installation”- Install the required dependencies:
bun add bulma tailwindcss sass- Initialize TailwindCSS configuration:
# Create tailwind.config.js manually if needed- Configure the build process to include Bulma and TailwindCSS styles.
Configuration
Section titled “Configuration”TailwindCSS Configuration
Section titled “TailwindCSS Configuration”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: [],};SCSS Files Structure
Section titled “SCSS Files Structure”src/styles/├── main.scss # Main SCSS file with Bulma imports├── variables.scss # Custom variables└── custom.scss # Custom styles combining both frameworksBasic HTML Structure
Section titled “Basic HTML Structure”<!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>Combining Components
Section titled “Combining Components”Buttons
Section titled “Buttons”<!-- 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>Alerts
Section titled “Alerts”<!-- 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>Available Components
Section titled “Available Components”Combined Components
Section titled “Combined Components”.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
Utility Classes
Section titled “Utility Classes”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
Customization
Section titled “Customization”Variables
Section titled “Variables”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;Mixins
Section titled “Mixins”Use the provided mixins to create custom components:
// Bulma mixin.my-bulma-button { @include bulma-button;}
// TailwindCSS mixin.my-tailwind-button { @include tailwind-button;}Build Process
Section titled “Build Process”The build process automatically compiles and concatenates all styles:
- Bulma SCSS →
dist/bulma-tailwind.css - TailwindCSS →
dist/bulma-tailwind.css - Katana UI →
dist/components.css - Concatenation →
dist/styles.css
Best Practices
Section titled “Best Practices”1. Use the Right Tool for the Job
Section titled “1. Use the Right Tool for the Job”- 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
2. Maintain Consistency
Section titled “2. Maintain Consistency”- Use the combined components for consistency across your application
- Follow the established naming conventions
- Test thoroughly across different screen sizes
3. Performance Considerations
Section titled “3. Performance Considerations”- Use the combined styles to avoid loading multiple CSS files
- Minimize custom CSS to maintain performance
- Use CSS variables for theming
4. Responsive Design
Section titled “4. Responsive Design”- Both frameworks include responsive utilities
- Combine them for enhanced responsive behavior
- Test on multiple devices
Troubleshooting
Section titled “Troubleshooting”Common Issues
Section titled “Common Issues”- CSS Conflicts: Use cascade layers to avoid conflicts
- Missing Styles: Ensure all imports are correct
- Build Errors: Check SCSS syntax and file paths
Debugging
Section titled “Debugging”- Use browser dev tools to inspect styles
- Check the generated CSS files
- Test with minimal examples first
Examples
Section titled “Examples”See the examples/bulma-tailwind-demo.html file for a complete working example of the integration.
Conclusion
Section titled “Conclusion”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.