TailwindTidy 🌪️✨

TailwindTidy is a Python utility that brings structure and consistency to your Tailwind CSS classes. Say goodbye to messy, unorganized utility classes and hello to a clean, standardized ordering system.

✨ Features

• 🎯 Automatically organizes Tailwind CSS classes into logical categories
• 🔄 Maintains consistent ordering based on best practices
• 🧹 Cleans up messy class strings
• 🚀 Simple and fast processing
• 📦 Easy to integrate into existing projects
• 🛠️ Customizable category patterns

🚀 Installation

pip install tailwindtidy

🎯 Quick Start

from tailwindtidy import TailwindClassOrganizer

# Create an instance
organizer = TailwindClassOrganizer()

# Your messy Tailwind classes
messy_classes = """
    hover:bg-gray-100 flex text-blue-700 
    justify-center mx-auto p-4 font-bold
"""

# Get organized classes
organized = organizer.organize_classes(messy_classes)
print(organized)

🎨 Class Organization

TailwindTidy organizes classes into the following categories:

1. Layout - flex, grid, container, positioning
2. Spacing - margins, padding, width, height
3. Typography - font properties, text alignment
4. Colors - text colors, background colors
5. Borders - borders, rounded corners, shadows
6. Effects - opacity, transforms, animations
7. Interactivity - hover states, focus states, cursor

🛠️ Customization

You can customize the category patterns by extending the categories dictionary:

organizer = TailwindClassOrganizer()
organizer.categories['custom'] = [
    r'^your-custom-pattern',
    r'^another-pattern'
]

💡 Use Cases

• Maintaining consistent class ordering across a team
• Cleaning up generated Tailwind classes
• Enforcing style guide conventions
• Improving code readability
• Pre-commit hooks for consistent styling

🤝 Contributing

Contributions are welcome! Here's how you can help:

1. Fork the repository
2. Create a new branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

🙏 Acknowledgments

• Inspired by Tailwind CSS best practices
• Built with love for the Tailwind community
• Thanks to all contributors