styled2tailwind

Styled2Tailwind 🌀

Transform your Styled-Components into TailwindCSS with this handy codemod.

🌟 Motivation

With Next.js introducing the new App Directory routing, it also introduced support for Server and Client components. Styled-components don't gel well with server components due to their heavy reliance on the JS runtime. Tailwind, on the other hand, slides right in and performs beautifully!

We also love Tailwind and we believe it enhances the development process, making it faster with a superior developer experience.

🚀 Getting Started

• Begin by giving the repository a star! ⭐
• Type the following command to dive into the CLI world:

$ npx styled2tailwind --help

🤔 How It Works

Our mechanism runs in four distinct steps:

• Raw Input: We start by taking the RAW React Component as input (make sure it includes some styled components).
• JavaScript AST: Convert the component to JavaScript AST using Babel.
• From AST to CSS: Extract all TemplateLiterals data from the AST and morph it into CSS.
• Tailwind Conversion: The final leg involves converting this CSS into TailwindCSS format.

flowchart LR
  RSI(Raw Styled Input) --> JSAST(JavaScript AST)
  JSAST --> RCSS(Raw CSS)
  RCSS --> TW(Tailwind CSS)

📋 Commands Overview

Command	Description
styled2tailwind --help	Displays help command.
styled2tailwind "src/*.jsx"	Parses all .jsx files inside src directory (supports regex).
styled2tailwind "src/*.jsx" --no-replace	Instead of replacing styled components with tailwind, it appends the tailwind output at the end of the file.
styled2tailwind "src/*.jsx" --no-conflicts	Forcefully replaces styled components with tailwind in the markup without using git conflicts.

⚠️ Limitations

This project is still in early beta, we already tracked some limitations and we will ship fix for those in very near future!

• Multi-Line Components: CLI can act mysteriously while one component is wrapped into multiple lines.
• Dynamic React Props: Handling dynamic React props (especially functions) still poses a challenge.

🤝 Contribution

Contributions are always welcome! To contribute, please follow these steps:

• Fork the repository.
• Create a new branch with a descriptive name.
• Make your changes, and commit them using the Conventional Commits format.
• Push your changes to the forked repository.
• Create a pull request, and we'll review your changes.

🫶 Support

If you're looking for help or simply want to share your thoughts about the project, we encourage you to join our Discord community. Here's the link: https://blazity.com/discord. It's a space where we exchange ideas and help one another. Everyone's input is appreciated, and we look forward to welcoming you.

📜 License

This project is licensed under the MIT License. For more information, see the LICENSE file.