Native Stylelint plugin
One rule. Your existing config, fixes, and diagnostics.
A little clarity for every lint run
Stylelint
File Progress
stylelint-plugin-file-progress
See the stylesheet behind the wait. Live filenames and configurable process summaries for Stylelint, with terminal colors from picocolors.
Your terminal, your rules
File, compact, and summary modes, with CI and TTY presets.
Useful process summaries
Observed files, elapsed time, and throughput at shutdown.
Start here
Progress that fits your workflow.
Get started
Install the plugin and add a preset to your existing Stylelint configuration.
Install & configure →Choose your output
Compare seven presets, from everyday filenames to a quiet CI summary.
Compare presets →Make it yours
Explore paths, spinner styles, streams, messages, and display thresholds.
Explore the rule →1 observational rule
7 ready-to-use presets
17 display options
31 terminal demos
A look inside your terminal
Follow the files.
Keep the useful details.
Choose readable filenames while Stylelint works, then see observed file counts, elapsed time, and throughput in a single process summary.
Each file updates the same terminal block. Spinner frames advance with file events, while formatter output stays visible.
Explore all 31 recordings →Timings in these reproducible demos illustrate process metrics. What does a file event mean?
Play the detailed terminal recording
Seven ways to show progress
Pick a preset. Get on with your CSS.
Everyday progress
recommended
Show each file using the default display options.
View config & demo Quiet in CIrecommended-ci
Hide all plugin output when CI is exactly true.
View config & demo CI with a summaryrecommended-ci-detailed
Hide live output in CI while retaining the detailed process summary.
View config & demo Compact activityrecommended-compact
Announce generic activity once, without showing filenames.
View config & demo Detailed progressrecommended-detailed
Show filenames and the detailed process summary.
View config & demo Summary onlyrecommended-summary-only
Show only the final process summary.
View config & demo Interactive terminalsrecommended-tty
Show output only when stderr is an interactive terminal.
View config & demoReady when you are
One install.
One config entry.
Add the progress preset after your existing configs. Your lint rules and autofixes continue to work as usual.
npm install --save-dev stylelint stylelint-plugin-file-progress
stylelint.config.mjs
export default {
extends: [
"stylelint-plugin-file-progress/configs/recommended",
],
};
Part of the same toolkit
Familiar tools. Connected docs.
Explore the ESLint counterpart, shared Stylelint config, and the inspectors behind this project.