VCS scaffolder for projects to be hosted on GitHub
MIT License
[!WARNING] This package has been deprecated in favor of
@form8ion/github
VCS scaffolder for projects to be hosted on GitHub
When authentication is provided, a repository will be created on GitHub, assuming one does not already exist.
This tool configures repository settings by generating the settings file for use by probot/settings. The settings in the file will be applied, along with those in the account-level file, once the generated file is pushed to GitHub in the default branch.
Issues will be created in the repository for tasks that should be completed after acaffolding is complete
$ npm install @travi/github-scaffolder --prod
This plugin leverages the .netrc strategy for octokit. Be sure to add your personal access token to leverage the GitHub API integration benefits of this plugin.
probot/settings
The settings file generated by this tool assumes that it is extending an account level config
.github
repository in your account.github
repository at the location .github/settings.yml
within theimport {scaffold} from '@travi/github-scaffolder';
(async () => {
await scaffold({
projectRoot: process.cwd(),
name: 'foo',
owner: 'travi',
description: 'This is my awesome project',
homepage: 'https://github.com/travi/foo#README',
visibility: 'Public',
tags: ['foo', 'bar'],
nextSteps: [
{summary: 'Do not forget to do this!'},
{
summary: 'Remember to do that',
description: `Take these steps:
- [ ] step 1
- [ ] step 2`
}
]
});
})();
projectRoot
string (required)path to the root of the project
name
string (required)Name for the repository
owner
string (required)Name of the account for the repository
description
string (optional)Short description of the project
homepage
string (optional)URL of the project homepage
visibility
string (optional)Whether the repository should be public or private. If provided, must be 'Public' or 'Private'.
tags
list of strings (optional)List of tags to be used as repository topics
nextSteps
list of objects (optional)TODO list to be filed as issues
summary
string (required)String to be used as the title of the created issue
description
string (optional)Markdown content for the in-depth description of the issue
$ nvm install
$ npm install
$ npm test