commitlint-config-conventional-system

Commitlint configuration for system and apps with defined scopes, commit types and more

Downloads in past

Stats

StarsIssuesVersionUpdatedCreatedSize
commitlint-config-conventional-system
2321.1.06 years ago6 years agoMinified + gzip package size for commitlint-config-conventional-system in KB

Readme

commitlint-config-conventional-system
Commitlint config for conventional system extensions for scopes and more

!Semantically Releasedsemantic-release-badgesemantic-release !Build Statusbuild-badgebuild !Code Coveragecoverage-badgecoverage !versionversion-badgepackage !downloadsdownloads-badgenpmtrends !Styled with Prettierprettier-badgeprettier !AirBnB style guideairbnb-style-badgeairbnb-style
!MIT Licenselicense-badgeLICENSE All Contributors !PRs Welcomeprs-badgeprs !Commitizen friendlycommitizen-badgecommitizen !Code of Conductcoc-badgecoc
!Watch on GitHubgithub-watch-badgegithub-watch !Star on GitHubgithub-star-badgegithub-star !Tweettwitter-badgetwitter
commitlint configuration for system and apps with defined scopes, commit types and more. By defining standard components of a system or app and using them as scopes, plus adding a few related to commit types, we ensure consistency across our projects.
These are scopes that should be common in most systems, we call these components:
  • auth: Authentication, login, OAuth, etc.
  • forms: General user input, forms, etc.
  • navigation: Navigation, history and routing.
  • networking": Network-related code, connectivity checks, offline persistence, etc.
  • notifications: Notification code, in-app notifications, push notifications, etc.
  • profile: User profile, friends, followers, etc.
  • settings: Settings and preferences.
  • system: A general catch-all, for changes that impact many areas of the system.

We define 4 scopes you can use if you're interested in highlighted which platform is affected by the changes:
  • core: Shared code.
  • native: Mobile platforms.
  • desktop: Desktop platforms.
  • web: Web platforms.

And finally, we define general scopes that refer to the nature of the change:
  • build
  • deps
  • packaging
  • release

But more importantly, we allow you to customize these. system refers to the above. You can include your packages in the packages section, and you can customize your components, along with descriptions.

Installing / Getting Started

Create a .commitlint-patterns.json at the root of your respository. See examples/commitlint-pattern.json.
Extend your config with this one. In commitlint.config.js:
module.exports = {
  extends: ['config-conventional-system']
}

Prerequisites

  • commitlint

Developing

Built With

  • Ramda

Setting up Dev

Here's a brief intro about what a developer must do in order to start developing the project further:
git clone https://github.com/blackxored/commitlint-config-conventional-system
cd commitlint-config-conventional-system
yarn

And state what happens step-by-step. If there is any virtual environment, local server or database feeder needed, explain here.

Versioning

We use SemVersemver for versioning. In addition, it's automatic via semantic-releasesemantic-release, and our commit conventioncommit-convention.
For the versions available, see the Releasesreleases on this repository.

Configuration

Here you should write what are all of the configurations a user can enter when using the project.

Tests

yarn test

Style guide

We base our code style on AirBnB's style guideairbnb-style and we check with ESLinteslint and automatically format our code with Prettierprettier.

License

This project is licensed under the MIT License - see the license file for details.

Contributing

If you're interested in contributing to this project in any form, please read our Contribution Guidelinescontributing.

Code of Conduct

We've adopted a Code of Conduct that we expect project participants to adhere to. Please read the full textcoc so that you can understand what actions will and will not be tolerated.

Contributors

Thanks goes to these people (emoji keyemojis):
|
Adrian Perez

💻 📖 🚇") ⚠️ | | :---: |
This project follows the all-contributorsall-contributors specification. Contributions of any kind welcome!