Do you want people to contribute to your project? Make it easy for your contributors. Generate all the recommended documentation/files (pre-filled) for the Github, Gitlab and Bitbucket community standards. This project has 100% type coverage checked by tscov.
More files & providers in future versions.
- License
- MIT
- ISC
- Apache 2.0
- BSD 2-Clause
- GPLv3
- Contributing
- Code of Conduct
- Bug report (issue)
- Feature request (issue)
- Pull request template
- All files at once
- CI template
- Bug (issue)
- Feature proposal (issue)
- Merge request
- All files at once
- In future versions
- Existing or new
- Large or small
- Every language
- Github, Gitlab or Bitbucket
Install the CGX CLI as a global CLI.
npm install -g cgx
cd <your-repo-location>
# Then you run
cgx
Or just use via npx:
cd <your-repo-location>
# Then you run
npx cgx
This should start the CLI and ask for questions about which files you want to add!
Generate all Github files example:
____ ____ __ __
/ ___| / ___| \ \/ /
| | | | _ \ /
| |___ | |_| | / \
\____| \____| /_/\_\
Generate all recommended markdown documentation/templates for the Github, Gitlab and Bitbucket community standards
? Select a Git hosting provider: Github
? Which files do you want to generate? All files (without license)
INFO: Start generating all recommended files...
GENERATE: CODE_OF_CONDUCT.md...
GENERATE: CONTRIBUTING.md...
GENERATE: bug_report.md...
GENERATE: feature_request.md...
GENERATE: pull_request_template.md...
CREATE: bug_report.md in <path-to-folder>/.github/ISSUE_TEMPLATE/bug_report.md
CREATE: CODE_OF_CONDUCT.md in <path-to-folder>/CODE_OF_CONDUCT.md.md
CREATE: CONTRIBUTING.md in <path-to-folder>/CONTRIBUTING.md
CREATE: feature_request.md in <path-to-folder>/.github/ISSUE_TEMPLATE/feature_request.md
CREATE: pull_request_template.md in <path-to-folder>/.github/PULL_REQUEST_TEMPLATE/pull_request_template.md
Git provider question:
? Select a Git hosting provider: (Use arrow keys)
❯ Github
Gitlab
Bitbucket
Generate file question:
? Which files do you want to generate? (Use arrow keys)
❯ All files (without license)
License
Code of conduct
Contributing
Bug report (issue)
Feature request (issue)
Pull request template
Generate license example:
? Select a Git hosting provider: Github
? Which files do you want to generate? License
GENERATE: LICENSE...
? Which type of license do you want to generate? MIT License
? Please fill in your Git username: Jeroenouw
CREATE: LICENSE in <path-to-folder>/LICENSE
File already exists example:
? Select a Git hosting provider: Bitbucket
? Which Bitbucket files do you want to generate? Contributing
GENERATE: CONTRIBUTING.md...
? This file already exists. Do you want to overwrite it? Yes
UPDATE: CONTRIBUTING.md in <path-to-folder>/CONTRIBUTING.md