{"id":16643649,"url":"https://github.com/josee9988/implode-css","last_synced_at":"2025-03-21T15:32:39.699Z","repository":{"id":47935326,"uuid":"224173551","full_name":"Josee9988/Implode-CSS","owner":"Josee9988","description":"Node CLI package that removes all unused CSS classes and ids","archived":false,"fork":false,"pushed_at":"2022-12-30T19:19:32.000Z","size":10546,"stargazers_count":4,"open_issues_count":17,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-03-18T02:51:21.876Z","etag":null,"topics":["cli-app","client-side","css","css3","javascript","nodejs","npm-package","unusedcss"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/@josee9988/implode-css","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Josee9988.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"custom":"https://www.paypal.me/josee9988"}},"created_at":"2019-11-26T11:15:41.000Z","updated_at":"2023-09-08T18:00:36.000Z","dependencies_parsed_at":"2023-01-31T14:15:41.241Z","dependency_job_id":null,"html_url":"https://github.com/Josee9988/Implode-CSS","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Josee9988%2FImplode-CSS","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Josee9988%2FImplode-CSS/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Josee9988%2FImplode-CSS/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Josee9988%2FImplode-CSS/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Josee9988","download_url":"https://codeload.github.com/Josee9988/Implode-CSS/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244822751,"owners_count":20516159,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli-app","client-side","css","css3","javascript","nodejs","npm-package","unusedcss"],"created_at":"2024-10-12T08:09:13.981Z","updated_at":"2025-03-21T15:32:39.361Z","avatar_url":"https://github.com/Josee9988.png","language":"JavaScript","funding_links":["https://www.paypal.me/josee9988"],"categories":[],"sub_categories":[],"readme":"\u003c!-- markdownlint-disable MD033--\u003e\n# **Implode-CSS** 🌋💣\n\nNpm CLI package that removes all unused CSS *classes* and *ids* from your project.\n\n---\n\n[![Version](https://badge.fury.io/js/%40josee9988%2Fimplode-css.svg)](https://www.npmjs.com/package/@josee9988/implode-css)\n[![Downloads](https://img.shields.io/npm/dt/@josee9988/implode-css.svg)](https://www.npmjs.com/package/@josee9988/implode-css)\n\n---\n\n## **Goal of the package** 🎯\n\nTo remove **useless/unused** CSS selectors from a project to increase **performance** and **readability**.\n\nIf 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**.\n\nWith `implodeCss` you will be able to **detect** and/or **remove** these unused CSS.\n\n---\n\n## **Installation** 🔩⚙\n\n``` bash\nsudo npm install -g @josee9988/implode-css\n```\n\n---\n\n## **Examples of use** 📐🛡\n\n- If you **do not know** how to use the package, show the **manual** by using:\n\n    ``` bash\n    implodeCss -h # to show the manual\n    ```\n\n- To be **prompted by the package**, do not use arguments, *we will help you*:\n\n    ``` bash\n    implodeCss # it will guide you\n    ```\n\n- Specify **folder** (actual / absolute path):\n\n    ``` bash\n    implodeCss . # actual folder, you must use always absolute paths but with the dot\n    ```\n\n    ``` bash\n    implodeCss /home/user/project # folder /home/user/project\n    ```\n\n- **Audit** (detect but do not do any action):\n\n    ``` bash\n    implodeCss . -a # audit actual package\n    ```\n\n- **Fix** (remove all unused CSS selectors):\n\n    ``` bash\n    implodeCss . -f # audit actual package\n    ```\n\n- **Ignore folders**:\n\n    ``` bash\n    implodeCss . -a -i src,data  # audit actual package and do not look into folders: /src/, /data/\n    ```\n\n- Specify **port** (default = 4949):\n\n    ``` bash\n    implodeCss . -a -p 8080 # audit actual package and create the server on port 4949\n    ```\n\n---\n\n## **Screenshots** 📸 😁\n\n- **Auditing** the code with: `implodeCss . -a`\n\n\u003cimg src=\"https://i.imgur.com/AnTvuHb.png\" alt=\"auditing code\" title=\"auditing code\" style=\"border-radius:15px; box-shadow: 6px 6px  #282829; max-height: 500px; max-width:500px;margin-left: auto; margin-right:auto;display: block;margin-left: auto;margin-right:auto;width:50%;\"/\u003e\n\n- **Table** with all the unused selectors and more information.\n\n\u003cimg src=\"https://i.imgur.com/vkXgq70.png\" alt=\"table with unused selectors\" title=\"table with unused selectors\" style=\"border-radius:15px; box-shadow: 6px 6px  #282829; max-height: 500px; max-width:500px;margin-left: auto; margin-right:auto;display: block;margin-left: auto;margin-right:auto;width:50%;\"/\u003e\n\n- **Help** command: `implodeCss -h`\n\n\u003cimg src=\"https://i.imgur.com/dVof1Rx.png\" alt=\"help command\" title=\"help command\" style=\"border-radius:15px; box-shadow: 6px 6px  #282829; max-height: 500px; max-width:500px;margin-left: auto; margin-right:auto;display: block;margin-left: auto;margin-right:auto;width:50%;\"/\u003e\n\n- If you do not specify a folder...\n\n\u003cimg src=\"https://i.imgur.com/HJj8OmH.png\" alt=\"folder not specified\" title=\"folder not specified\" style=\"border-radius:15px; box-shadow: 6px 6px  #282829; max-height: 500px; max-width:500px;margin-left: auto; margin-right:auto;display: block;margin-left: auto;margin-right:auto;width:50%;\"/\u003e\n\n- If you do not specify the option to perform...\n\n\u003cimg src=\"https://i.imgur.com/l67EvSs.png\" alt=\"option not specified\" title=\"option not specified\" style=\"border-radius:15px; box-shadow: 6px 6px  #282829; max-height: 500px; max-width:500px;margin-left: auto; margin-right:auto;display: block;margin-left: auto;margin-right:auto;width:50%;\"/\u003e\n\n---\n\n## **Error codes** ❌\n\n\u003cdetails\u003e\n\u003csummary\u003eClick to see all the \u003cb\u003eerror\u003c/b\u003e and \u003cb\u003einformational\u003c/b\u003e codes and it's explanation\u003c/summary\u003e\n\n### **200**\n\n- Exists without errors.\n\n### **201**\n\n- Exit without an expected code, this code should not appear at all.\n\n### **401**\n\n- Bad arguments passed by the user. Some of the arguments used are not expected.\n\n### **402**\n\n- The path (most of the times the main folder) doesn't have read permissions, so the program could not read your files.\n\n### **403** [Not used]\n\n- The path doesn't have write permissions (Not used anywhere yet. see 405 instead).\n\n### **404**\n\n- Found 0 CSS files or 0 HTML files. The user should provide atleast 1 CSS files and 1 HTML file.\n\n### **405**\n\n- The local temporary file doesn't have write permissions so the page with the results won't get any data.\n\n### **406**\n\n- A path inside the main folder doesn't have read or write permissions (not specified).\n\n### **500**\n\n- Unknown error, the package specified an error that doesn't exist (should not appear, if so, please contact us and tell us how).\n\n### **501**\n\n- The selected port couldn't be opened.\n\n### **502**\n\n- Unexpected error (should not appear, if so, please contact us and tell us how).\n\n\u003c/details\u003e\n\n---\n\n### Did you enjoyed the package? Help us raise these numbers up 🥰 🎉\n\n[![Github followers](https://img.shields.io/github/followers/Josee9988.svg?style=social)](#did-you-enjoyed-the-package-help-us-raise-these-numbers-up--)\n[![Github stars](https://img.shields.io/github/stars/Josee9988/Implode-CSS.svg?style=social)](#did-you-enjoyed-the-package-help-us-raise-these-numbers-up--)\n[![Github watchers](https://img.shields.io/github/watchers/Josee9988/Implode-CSS.svg?style=social)](#did-you-enjoyed-the-package-help-us-raise-these-numbers-up--)\n[![Github forks](https://img.shields.io/github/forks/Josee9988/Implode-CSS.svg?style=social)](#did-you-enjoyed-the-package-help-us-raise-these-numbers-up--)\n\nAlso check the [npm page with the package](https://www.npmjs.com/package/@josee9988/implode-css)\n\n---\n\n\u003e ⚠️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.⚠️\n\n*Made with a lot of ❤️❤️ by **[@Josee9988](https://github.com/Josee9988)***\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosee9988%2Fimplode-css","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjosee9988%2Fimplode-css","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjosee9988%2Fimplode-css/lists"}