{"id":14990624,"url":"https://github.com/sebastian-software/stylelint-config-readable","last_synced_at":"2026-01-05T11:06:50.352Z","repository":{"id":57373570,"uuid":"109290410","full_name":"sebastian-software/stylelint-config-readable","owner":"sebastian-software","description":"Configuration for Stylelint to achieve readable source code.","archived":false,"fork":false,"pushed_at":"2018-09-23T21:45:32.000Z","size":261,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-26T18:44:21.881Z","etag":null,"topics":["cssmodules","lint","readable","sass","stylelint","stylelint-config"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sebastian-software.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-11-02T16:23:49.000Z","updated_at":"2018-09-23T21:45:34.000Z","dependencies_parsed_at":"2022-09-17T16:30:58.388Z","dependency_job_id":null,"html_url":"https://github.com/sebastian-software/stylelint-config-readable","commit_stats":null,"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebastian-software%2Fstylelint-config-readable","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebastian-software%2Fstylelint-config-readable/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebastian-software%2Fstylelint-config-readable/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sebastian-software%2Fstylelint-config-readable/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sebastian-software","download_url":"https://codeload.github.com/sebastian-software/stylelint-config-readable/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244888404,"owners_count":20526792,"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":["cssmodules","lint","readable","sass","stylelint","stylelint-config"],"created_at":"2024-09-24T14:20:28.320Z","updated_at":"2026-01-05T11:06:50.274Z","avatar_url":"https://github.com/sebastian-software.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Stylelint Config Readable\u003cbr/\u003e[![Sponsored by][sponsor-img]][sponsor] [![Version][npm-img]][npm] [![Dependencies][deps-img]][deps]\n\n[sponsor-img]: https://img.shields.io/badge/Sponsored%20by-Sebastian%20Software-692446.svg\n[sponsor]: https://www.sebastian-software.de\n[deps]: https://david-dm.org/sebastian-software/stylelint-config-readable\n[deps-img]: https://david-dm.org/sebastian-software/stylelint-config-readable/status.svg\n[npm]: https://www.npmjs.com/package/stylelint-config-readable\n[npm-img]: https://badge.fury.io/js/stylelint-config-readable.svg\n\n\u003e \"If you want your code to be easy to write, make it easy to read.\" — Robert C. Martin\n\nThe aim of this configuration is to achieve optimal readable code for a large number of projects. In many cases, the easing of the code's looseness in comparison to its compactness is an advantage for this. The idea is that code is much more read than written. Clear and structured code is therefore valuable for each additional author.\n\nThe code should appear uniform no matter how many authors are involved. But of course, it is not only about formatting (which could be fully solved with new tools like [Prettier](https://prettier.io/)) but also about avoiding errors and mentoring developers. As you will see the chosen infrastructure with ESLint as a backbone offers so much more.\n\nThere is also the matching [ESLint Configuration](https://www.npmjs.com/package/eslint-config-readable) available.\n\n\n## Features\n\n- Blocks usage of `!important`.\n- Correctly supports typical *Sass* dialects like `@mixin`.\n- Tolerates `normalize` PostCSS plugin for automatically cherry-pick required normalization features.\n- Tolerates CSS Modules `composes` feature.\n- Tolerates Lost Grid features.\n- Checks CSS animation/transition for performance issues.\n\n## Formatting\n\n- Use 2 spaces for indention\n- 80 characters max line length\n- Use lowercase properties, selectors, mixin names, etc. only\n- Requires property splitting between layout (position, margin, padding, size) and visuals (appearance, colors, animation)\n\n\n## Usage\n\nInstallation with `npm`:\n\n```bash\nnpm install --save-dev stylelint-config-readable stylelint\n```\n\nInstallation with `yarn`:\n\n```bash\nyarn add --dev stylelint-config-readable stylelint\n```\n\nAdd the preset to your stylelint config e.g. `.stylelintrc.yml`\n\n```yaml\nextends:\n  - stylelint-config-readable\n```\n\nThough this configuration is meant to be usable without any further configuration you are naturally free to extend it and place overrides into your configuration e.g. by extending the `rules` section:\n\n```yaml\nextends:\n  - stylelint-config-readable\nrules:\n  indentation: 4\n```\n\n\n## Copyright\n\n\u003cimg src=\"https://cdn.rawgit.com/sebastian-software/sebastian-software-brand/0d4ec9d6/sebastiansoftware-en.svg\" alt=\"Logo of Sebastian Software GmbH, Mainz, Germany\" width=\"460\" height=\"160\"/\u003e\n\nCopyright 2015-2018\u003cbr/\u003e[Sebastian Software GmbH](http://www.sebastian-software.de)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsebastian-software%2Fstylelint-config-readable","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsebastian-software%2Fstylelint-config-readable","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsebastian-software%2Fstylelint-config-readable/lists"}