Implode-CSS 🌋💣

Npm CLI package that removes all unused CSS classes and ids from your project.

Goal of the package 🎯

To remove useless/unused CSS selectors from a project to increase performance and readability.

If you create a project from scratch or use templates there is a high chance of creating CSS selectors that you will finally not use and will be downloaded by the user and will make the page performance slower.

With implodeCss you will be able to detect and/or remove these unused CSS.

Installation 🔩⚙

sudo npm install -g @josee9988/implode-css

Examples of use 📐🛡

• If you do not know how to use the package, show the manual by using:

  implodeCss -h # to show the manual

• To be prompted by the package, do not use arguments, we will help you:

  implodeCss # it will guide you

• Specify folder (actual / absolute path):

  implodeCss . # actual folder, you must use always absolute paths but with the dot

  implodeCss /home/user/project # folder /home/user/project

• Audit (detect but do not do any action):

  implodeCss . -a # audit actual package

• Fix (remove all unused CSS selectors):

  implodeCss . -f # audit actual package

• Ignore folders:

  implodeCss . -a -i src,data  # audit actual package and do not look into folders: /src/, /data/

• Specify port (default = 4949):

  implodeCss . -a -p 8080 # audit actual package and create the server on port 4949

Screenshots 📸 😁

• Auditing the code with: implodeCss . -a

• Table with all the unused selectors and more information.

• Help command: implodeCss -h

• If you do not specify a folder...

• If you do not specify the option to perform...

Error codes ❌

200

• Exists without errors.

201

• Exit without an expected code, this code should not appear at all.

401

• Bad arguments passed by the user. Some of the arguments used are not expected.

402

• The path (most of the times the main folder) doesn't have read permissions, so the program could not read your files.

403 [Not used]

• The path doesn't have write permissions (Not used anywhere yet. see 405 instead).

404

• Found 0 CSS files or 0 HTML files. The user should provide atleast 1 CSS files and 1 HTML file.

405

• The local temporary file doesn't have write permissions so the page with the results won't get any data.

406

• A path inside the main folder doesn't have read or write permissions (not specified).

500

• Unknown error, the package specified an error that doesn't exist (should not appear, if so, please contact us and tell us how).

501

• The selected port couldn't be opened.

502

• Unexpected error (should not appear, if so, please contact us and tell us how).

Did you enjoyed the package? Help us raise these numbers up 🥰 🎉

Also check the npm page with the package

⚠️Remember that this tool does not guarantee a 100% effectiveness and may have some issue at some point. Use it at your own risk and always do backups of your code.⚠️

Made with a lot of ❤️❤️ by @Josee9988