$ show Developmint/nuxt-purgecss
nuxt-purgecss is a Nuxt 3 module that integrates PurgeCSS to remove unused CSS from the final build. It hooks into Nuxt's PostCSS configuration to add the `@fullhuman/postcss-purgecss` plugin with sensible defaults tailored for Vue and Nuxt projects. The module automatically scans common Nuxt directories (components, layouts, pages, composables, app files, plugins, and nuxt.config) for used CSS classes, and includes a safelist of typical Nuxt classes (e.g., transition classes, nuxt-link classes, scoped style attributes) to prevent accidental removal. It also provides a custom default extractor that strips inline `<style>` blocks from Vue Single File Components before extraction, ensuring that only classes used in templates are considered. The module is disabled by default in development mode and can be configured via the `purgecss` key in `nuxt.config`. The codebase is small, well-structured, and includes integration tests using `@nuxt/test-utils` that verify correct purging behavior on a playground Nuxt project. However, the project has seen no releases since September 2022 and relies on outdated dependencies (e.g., Nuxt 3 RC, Node 16 in CI), indicating it is no longer actively maintained.
The LLM identified 1 files worth highlighting for reuse:
Defines the module's configuration interface and defaults. The `defaultExtractor` function is a non-obvious solution for handling Vue SFCs: it removes `<style>` blocks before extraction to avoid picking up classes from CSS that will be processed separately. The safelist includes carefully crafted regex patterns for Nuxt-specific classes (transitions, link classes, scoped styles) that prevent common purging issues. This file encapsulates the domain logic for integrating PurgeCSS with Nuxt/Vue and could be extracted and reused in other PurgeCSS setups with minimal modification.