Skip to content

Release v2.0.0: Remove Tailwind CSS#2

Merged
ishansasika merged 11 commits intomainfrom
release/v2.0.0-remove-tailwind-css
Jan 8, 2026
Merged

Release v2.0.0: Remove Tailwind CSS#2
ishansasika merged 11 commits intomainfrom
release/v2.0.0-remove-tailwind-css

Conversation

@ishansasika
Copy link
Copy Markdown
Owner

[2.0.0] - 2025-01-07

🎉 Major Release - Zero Configuration, Smaller Bundle

This release removes the Tailwind CSS dependency, making the library easier to use and significantly smaller.

Breaking Changes

Removed Dependencies

  • Removed Tailwind CSS peer dependency - No longer required
    • The library now uses custom CSS utilities instead of Tailwind
    • Users no longer need to configure tailwind.config.js
    • Zero configuration required - just import styles and go

Migration Guide

For v1.x users:

  1. Update to v2.0.0: npm install premium-react-loaders@latest
  2. Remove library path from tailwind.config.js (if not using Tailwind elsewhere)
  3. That's it! All component APIs remain identical

What stays the same:

  • ✅ All component APIs unchanged
  • ✅ All props work exactly the same
  • ✅ TypeScript types unchanged
  • ✅ Same import paths
  • ✅ Same customization options (className, style, color props)

Added

Custom CSS System

  • Custom utility classes replacing Tailwind dependencies

    • Layout utilities: flex, grid, gap, spacing
    • Positioning utilities: relative, absolute, fixed, inset
    • Border utilities: rounded-, border-
    • Typography utilities: text-, font-
    • All utilities are self-contained in the package
  • Component-specific styles

    • Base skeleton, spinner, and progress styles
    • Optimized for small bundle size
    • Hardware-accelerated animations

Internal Improvements

  • Inline className utility - Replaced clsx dependency
    • Lightweight 10-line utility function
    • Zero runtime dependencies
    • Maintains same API as clsx

Changed

Bundle Size Optimizations

  • 70% smaller CSS bundle

    • Before: 21 KB (uncompressed)
    • After: 6.27 KB (1.64 KB gzipped)
    • Removed unused Tailwind utilities
  • 36% smaller total package

    • Before: 1.0 MB
    • After: 640 KB
    • Removed JavaScript source maps from distribution
    • Removed unnecessary dependencies

Build Configuration

  • Disabled source maps in production builds

    • Reduces package size by ~500 KB
    • Source maps available in development mode
    • Users can still debug with preserved module structure
  • Optimized PostCSS configuration

    • Removed Tailwind plugin
    • Kept autoprefixer for browser compatibility

Developer Experience

  • Simplified installation

    • No Tailwind configuration needed
    • No additional build setup required
    • Works in any React project (not just Tailwind projects)
  • Faster installation

    • Fewer peer dependencies to download
    • No Tailwind CSS installation required

Removed

Dependencies

  • Removed tailwindcss from peer dependencies
  • Removed clsx from dependencies
  • Removed tailwind.config.js configuration file

Configuration Requirements

  • No longer need to add library path to Tailwind config
  • No longer need Tailwind CSS installed

Benefits

For Library Users

  • 🎉 Zero configuration - no Tailwind setup required
  • 🎉 Smaller bundle - 70% smaller CSS, 36% smaller package
  • 🎉 Faster installation - fewer dependencies to download
  • 🎉 Works everywhere - compatible with any React project
  • 🎉 Same great API - drop-in replacement for v1.x

For Package Maintainers

  • Simpler build process
  • Smaller npm package
  • Fewer dependency conflicts
  • Better tree-shaking support

Notes

This is a major version release due to the Tailwind CSS removal. While the component APIs remain unchanged, the removal of a peer dependency is considered a breaking change following semantic versioning.

All 25 components continue to work exactly as before:

  • 9 Skeleton components
  • 7 Spinner components
  • 4 Progress components
  • 4 Pulse components
  • 1 Overlay component

- Add custom utility classes for layout (flex, grid, gap)
- Add spacing utilities (padding, margin, space-y)
- Add positioning utilities (relative, absolute, fixed, inset)
- Add border radius utilities (rounded-full, rounded-lg, rounded-sm)
- Add typography utilities (text-xs, text-sm, font-medium, font-semibold)
- Add border and misc utilities
- All utilities provide same functionality as Tailwind equivalents
- Reduces CSS bundle size by removing unused Tailwind classes
- Add skeleton base styles with shimmer animation
- Add spinner base styles with rotation animation
- Add progress base styles for loading indicators
- Replace Tailwind @apply directives with pure CSS
- Optimize styles for small bundle size
- Maintain same visual appearance as v1.x
- Implement lightweight className merging utility
- Remove clsx as runtime dependency
- Reduce package dependencies to zero
- Maintain same API and functionality as clsx
- 10-line implementation vs external package
- Remove @tailwind directives from main styles
- Import custom utilities and component styles instead
- Remove Tailwind plugin from PostCSS configuration
- Keep autoprefixer for browser compatibility
- Reduce CSS bundle size from 21KB to 6.27KB (70% reduction)
- Remove tailwindcss from peer dependencies
- Remove clsx from dependencies
- Update package description to remove Tailwind reference
- Update keywords to replace 'tailwind' with 'css'
- Delete tailwind.config.js configuration file
- Zero configuration required for library users
- Disable JavaScript source maps in production builds
- Enable source maps in development mode only
- Reduce total package size by ~500KB (36% reduction)
- Add CSS preprocessor options for future extensibility
- Maintain tree-shaking with preserveModules option
- Update README with v2.0.0 features and benefits
- Add migration guide from v1.x to v2.0
- Remove Tailwind CSS setup instructions
- Update component counts (25 total: 9+7+4+4+1)
- Highlight zero configuration requirement
- Update demo app documentation page
- Add v2.0.0 breaking changes notice
- Update peer dependencies section
- Bump package version from 1.3.0 to 2.0.0
- Add comprehensive v2.0.0 changelog entry
- Document breaking changes and migration guide
- List all improvements and optimizations
- Note 70% CSS size reduction and 36% total package reduction
- Highlight zero configuration benefit
- Document all 25 components still working
- Add automated PR checks on Node.js 18 and 20
- Run TypeScript type checking
- Build library, Storybook, and demo app
- Add lint checks to verify no Tailwind references
- Verify no clsx imports in source code
- Verify all 25 components are present
- Display package size report
- Ensure code quality before merging to main
- Deploy Storybook to Firebase preview channel on PR
- Deploy demo app to Firebase preview channel on PR
- Auto-comment on PR with preview URLs
- Preview deployments expire after 7 days
- Only deploy after all checks pass
- Provides reviewers with live preview links
- Add checks:write permission for Firebase deploy action
- Add pull-requests:write permission for commenting
- Add contents:read permission for checkout
- Fixes 403 permission error when creating check runs
@ishansasika ishansasika self-assigned this Jan 7, 2026
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jan 7, 2026

Visit the preview URL for this PR (updated for commit 3ea6482):

https://premium-react-loaders--pr2-release-v2-0-0-remov-4in4cv8o.web.app

(expires Wed, 14 Jan 2026 06:20:39 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: eb4458f61f3ef56b131141fb6fd2dd15a08ad257

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jan 7, 2026

Visit the preview URL for this PR (updated for commit 3ea6482):

https://premium-react-loaders-demo--pr2-release-v2-0-0-remov-exgslzb5.web.app

(expires Wed, 14 Jan 2026 06:20:46 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: feeaea6d178339239f5ee7031faf380056784aae

@github-actions
Copy link
Copy Markdown

github-actions Bot commented Jan 7, 2026

🚀 Preview Deployments

Your PR has been deployed to Firebase preview channels!

📚 Storybook Documentation

🔗 View Storybook Preview

🎨 Demo Application

🔗 View Demo Preview


Preview deployments will be automatically deleted after 7 days.

Built with commit 5773d4a

@ishansasika ishansasika merged commit 9eaa0dc into main Jan 8, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant