{"id":42026,"library":"stylelint-formatter-github","title":"Stylelint GitHub Annotations Formatter","description":"A stylelint formatter that outputs lint results as GitHub Annotations, enabling error and warning messages to appear directly in GitHub pull request diffs and checks. Version 1.0.1 requires stylelint >= 10 and Node.js >= 10.x. It integrates seamlessly with GitHub Actions CI, providing immediate inline feedback without manual log parsing. Unlike JSON or verbose formatters, this creates machine-readable annotation objects that GitHub surfaces in the UI. Release cadence is low; the package is stable and feature-complete. It is the standard formatter for stylelint usage in GitHub Actions workflows.","status":"active","version":"1.0.1","language":"javascript","source_language":"en","source_url":"https://github.com/hipstersmoothie/stylelint-formatter-github","tags":["javascript","stylelint","stylelint-formatter","formatter","reporter","lint","validate","github","annotations"],"install":[{"cmd":"npm install stylelint-formatter-github","lang":"bash","label":"npm"},{"cmd":"yarn add stylelint-formatter-github","lang":"bash","label":"yarn"},{"cmd":"pnpm add stylelint-formatter-github","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency: formatter is plugged into stylelint","package":"stylelint","optional":false}],"imports":[{"note":"ESM export is default. CommonJS require works if the consumer's project supports it, but it is not the primary format.","wrong":"const formatter = require('stylelint-formatter-github')","symbol":"formatter","correct":"import formatter from 'stylelint-formatter-github'"}],"quickstart":{"code":"// .stylelintrc.js\nmodule.exports = {\n  extends: 'stylelint-config-standard',\n  formatter: 'stylelint-formatter-github',\n};\n\n// In package.json scripts:\n\"lint\": \"stylelint 'src/**/*.css'\"\n\n// Or via CLI directly:\n// stylelint --custom-formatter ./node_modules/stylelint-formatter-github 'src/**/*.css'","lang":"javascript","description":"Configures stylelint to use GitHub annotations formatter and runs linting on CSS files."},"warnings":[{"fix":"Use a different formatter (e.g., 'verbose') for local runs, or check CI environment variable.","message":"Formatter only works within GitHub Actions or GitHub API environment. It will produce no visible output if run locally.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Update Node.js to >=10, or stick with older package versions.","message":"Version 1.0.0 removed support for Node.js < 10.","severity":"breaking","affected_versions":">=1.0.0"}],"env_vars":null,"search_vec":"'1.0.1':31 '10':34,37 'action':44,94 'annot':3,14,64,106 'appear':21 'cadenc':73 'check':29 'ci':45 'complet':83 'creat':60 'diff':27 'direct':22 'enabl':15 'error':16 'featur':82 'feature-complet':81 'feedback':49 'formatt':4,7,58,88,100,101 'github':2,13,24,43,67,93,105 'immedi':47 'inlin':48 'integr':40 'javascript':96 'json':55 'lint':10,103 'log':52 'low':75 'machin':62 'machine-read':61 'manual':51 'messag':19 'node.js':36 'object':65 'output':9 'packag':77 'pars':53 'provid':46 'pull':25 'readabl':63 'releas':72 'report':102 'request':26 'requir':32 'result':11 'seamless':41 'stabl':79 'standard':87 'stylelint':1,6,33,90,97,99 'stylelint-formatt':98 'surfac':68 'ui':71 'unlik':54 'usag':91 'valid':104 'verbos':57 'version':30 'warn':18 'without':50 'workflow':95 'x':38","created_at":"2026-06-04T18:55:15.681454+00:00","updated_at":"2026-06-04T18:55:15.681454+00:00","problems":[{"fix":"Run 'npm install --save-dev stylelint-formatter-github' and ensure node_modules path is correct.","cause":"Package not installed or not resolved from config file location.","error":"Error: Could not find formatter 'stylelint-formatter-github'"},{"fix":"Use dynamic import: 'import('stylelint-formatter-github')' or install stylelint as a dependency.","cause":"CommonJS require fails in an ESM-only context or due to missing peer dependency.","error":"Error: Cannot find module 'stylelint-formatter-github'"}],"ecosystem":"npm","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":null,"cli_version":null,"type":"library","homepage":"https://github.com/hipstersmoothie/stylelint-formatter-github#readme","github":"https://github.com/hipstersmoothie/stylelint-formatter-github","docs":null,"changelog":null,"pypi":null,"npm":"stylelint-formatter-github","openapi_spec":null,"status_page":null,"smithery":null,"categories":["testing"],"base_url":null,"auth_type":null,"provenance":{"verified_status":null,"verified_at":null,"last_verified":"2026-06-04","next_check":"2026-09-02","install_tag":null}}