README.md

CSS Modules in Legacy Applications Demo

This project demonstrates how to use CSS Modules in a React application, particularly in the context of working with legacy stylesheets. It showcases how CSS Modules can help prevent style conflicts and improve the maintainability of your styles.

Live Demo

Check out the live demo: https://global-styles-demo-644f.vercel.app/

What This Demo Shows

1. A React component styled with CSS Modules
2. Global styles that might exist in a legacy application
3. How CSS Modules prevent the global styles from interfering with the component's styles

Key Concepts

• CSS Modules: A CSS file in which all class names and animation names are scoped locally by default. Learn more
• Specificity: How browsers determine which CSS rule is applied when multiple rules could style an element. MDN explanation
• Working with Legacy Styles: Strategies for integrating modern CSS practices with existing codebases. CSS-Tricks article

Project Structure

• src/components/Button/: Contains a React button component and its CSS Module
• src/global-styles.css: Simulates legacy global styles
• src/App.tsx: Main application file demonstrating the use of the button component alongside elements styled by global CSS

Running the Demo

1. Install dependencies: yarn install
2. Start the development server: yarn dev
3. Build for production: yarn build

Further Reading

• CSS Modules vs. CSS-in-JS
• Motivation for CSS Modules
• Managing CSS in Large Scale Projects

Feel free to explore the code and experiment with the styles to see how CSS Modules can help manage styling in complex applications!