All Contributors

All Contributors

  • Docs
  • GitHub
  • Languages iconEnglish
    • 日本語
    • Deutsch
    • Español
    • Français
    • Bahasa Indonesia
    • 한국어
    • Polski
    • Português (Brasil)
    • Русский
    • 中文

›@all-contributors Bot 🤖

Specification

  • Overview
  • Specification
  • Emoji Key ✨
  • Repository Maintainers
  • Tooling

@all-contributors Bot 🤖

  • Overview
  • Installation
  • Usage
  • Configuration
  • FAQs

CLI

  • Overview
  • Installation
  • Usage
  • Configuration

Project

  • Help us Improve
  • Code of Conduct
  • Who's using it?
Edit

Bot Installation

1. Install the AllContributors GitHub App

Install the GitHub App

App Install Screenshot

2. Configure your repositories

Configure Repositories Screenshot

3. Create a README.md

Ensure you have a README.md file at the root of the project (it can be empty).

If you prefer your contributors table in a place other than the README.md; After merging your first bot PR, you can move your contributors table, see files in the bot configuration

Make sure to add this in the markdown:

For the list:

## Contributors

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->

<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->

<!-- ALL-CONTRIBUTORS-LIST:END -->

Note: Extra line is very important in order to make it work properly.

For the badge use the following, replacing projectOwner with the relevant GitHub username or organization name, and projectName with the relevant the GitHub repo name. Style, color, and other parameters can be customized to your liking — see https://shields.io/.

[![All Contributors](https://img.shields.io/github/all-contributors/projectOwner/projectName?color=ee8449&style=flat-square)](#contributors)

Please create the .all-contributorsrc file for the first configuration. It can only have the mandatory information in it to begin. The bot will update it automatically with default config in the first PR. Here is the minimal .all-contributorsrc file to add in your repo :

{
  "projectName": "<insert the repo's name>",
  "projectOwner": "<insert the repo's owner/orgs>"
}

4. Update your Contributing documentation

Consider updating your CONTRIBUTING.md or similar with steps on how contributors can add themselves. You can even link to the bot usage documentation.

What's next

  • Using the Bot
  • Configuring the Bot
Last updated on 8/23/2023 by LBF38
← OverviewUsage →
  • 1. Install the AllContributors GitHub App
  • 2. Configure your repositories
  • 3. Create a README.md
  • 4. Update your Contributing documentation
  • What's next
All Contributors