JSPM

@ty-lerscott/conventional-commit

1.1.1
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 2
  • Score
    100M100P100Q37037F
  • License ISC

🚀 Introducing @ty-lerscott/conventional-commit: A Conventional Commit Formatter! 🌟 Streamline your git workflow with @ty-lerscott/conventional-commit, the tool that brings industry-standard commit formatting to your fingertips. 🔧💻 Craft commits like a pro with optional type flags and customizable defaults via package.json config. Stay in sync with conventional commits for robust version control practices. 🛠️🔍 Designed for devs who value precision and consistency, @ty-lerscott/conventional-commit empowers you to level up your commit game and collaborate seamlessly across teams. 💪👩‍💻👨‍💻 Upgrade your git experience today with @ty-lerscott/conventional-commit! 🚀✨

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@ty-lerscott/conventional-commit) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    @ty-lerscott/conventional-commit

    Project Logo

    A Conventional Commit Formatter 💫🚀

    PR Release Conventional Commits npm version License: MIT GitHub issues GitHub stars

    Description

    @ty-lerscott/conventional-commit is a delightful CLI tool that automatically formats your commits according to the Conventional Commit specification, ensuring consistency and reliability in your version control history 🌟✨

    Installation

    To install @ty-lerscott/conventional-commit globally, run:

    > npm i @ty-lerscott/conventional-commit -g

    Prerequisites

    Make sure you have the following installed:

    • Node.js version 18
    • Git

    Configuration

    You can either use a conventional-commit.json file or a package.json file

    package.json

    "conventional": {
      "scope": "VALUE", // optional
      "prompt": false, // optional (default: true)
      "types": {
        "KEY": "VALUE", // optional
      }
    }

    The conventional object in your package.json file allows you to configure certain aspects of the Conventional Commit Formatter. Here's a breakdown of the available options:

    • scope: This property can be used to specify a default scope for your commits.
    • types: An object containing key-value pairs representing commit types and their descriptions.
    • prompt: A Boolean indicating whether or not to prompt the user to approve the commit

    Usage

    There are two ways to use this cli tool, they do the same thing

    > commit [option(s)]

    or

    > cc [option(s)]

    Output

    In its most simple usage, this will generate a commit message following the Conventional Commit format, making your version control workflow a breeze 🌈💻

    > <type>(<scope>)!: <message>

    Options

    The following options are available when using @ty-lerscott/conventional-commit:

    • -t, --type: The type of commit (e.g., feat, fix, chore).
    • -m, --message: The commit message.
    • -s, --scope: The context of the commit.
    • -b, --break: This commit will be a breaking change
    • -ns, --no-scope: If a default scope is specified in package.json, this removes the scope
    • -np, --no-prompt: Disables commit message preview
    • -h, --help: Displays help information about the CLI tool.
    • -v, --version: Prints out the script's version

    You can use these options to customize your commit messages and streamline your development process.

    License

    @ty-lerscott/conventional-commit is licensed under the MIT License.

    Contributions

    Contributions and feedback are welcome! Feel free to submit issues or pull requests on GitHub.

    Credits

    This project is maintained by @ty-lerscott.

    Contact

    For any inquiries, please contact ty@lerscott.com.