generator-repo

Yo Repo! A Yeoman generator for awesome repositories

Usage no npm install needed!

<script type="module">
  import generatorRepo from 'https://cdn.skypack.dev/generator-repo';
</script>

README

Yo Repo! A Yeoman generator for awesome repositories

Build Status Dependencies Status devDependencies Status Commitizen friendly semantic-release

npm latest version npm next version npm downloads per week npm total downloads

Table of Contents


About the Generator

Yo Repo! is a Yeoman generator, used for generating awesome repositories that exhibit the highest standards of repository management.

Features

  • Complete, one-stop solution for starting any repo/package/etc.
  • Opinionated, implementing common standards and best practices.
  • Helpful, friendly and informative CLI prompts.
  • Pre-fill of prompt values using existing resources.

Install

Install, or update, Yeoman:

npm install -g yo

Install Yo Repo! generator:

npm install -g generator-repo

Usage

Quickstart

Run Yo Repo! from your project directory:

cd path/to/your/project/directory
yo repo

Instructions

Yo Repo! is developed using what Yeoman calls composability, described as; "a way to combine smaller parts to make one large thing". Yo Repo! is comprised of many sub-generators that are assembled into recipes based on individual requirements. These sub-generators can be called individually and even reused outside of the context of Yo Repo!

Sub-generators

  • Git Init: yo repo gitinit
  • Package: yo repo package
  • License: yo repo license
  • Readme: yo repo readme
    • Badges/shields
  • Contributing: yo repo contributing
  • Roadmap: yo repo roadmap
  • Continuous Integration: yo repo ci
    • Travis CI
  • Dependencies: yo repo deps
    • Angular
    • Express
    • React
    • TypeScript

Command-line Interface (CLI)

# CLI Help
yo repo --help

# Run Yo Repo!
yo repo

# Run Yo Repo! sub-generator
# yo repo <generator>
yo repo readme

# Run a set of Yo Repo! sub-generators
# yo repo <generator> <generator> ...
yo repo license readme contributing

# CLI Help for sub-generators
# yo repo:<generator> --help
yo repo:readme --help

Support

Submit an issue, in which you should provide as much detail as necessary for your issue.

Contributing

Contributions are always appreciated. Read CONTRIBUTING.md documentation to learn more.

Changelog

Release details are documented in the CHANGELOG.md file, and on the GitHub Releases page.


License

ISC License

Copyright (c) 2018 Sean Trane Sciarrone