/readme-generator

Every good project needs a quality README with information about the app - what the app is for, how to use the app, how to install it, how to report issues, and how to make contributions so that other developers are more likely to use and contribute to the success of the project. This is a command-line application that runs with Node.js that dynamically generates a README.md file based on input about your project.

Primary LanguageJavaScriptMIT LicenseMIT

README Generator

License: MIT
README Generator was created as a solution to the problem that many developers face - Writing a README for every new project they create. This is a CLI(Command Line Interface) application that generates a styled comprehensive README.md file, based on the users entries into the command-line prompts. This application uses inquirer to prompt the user with a series of questions: GitHub Username, Email Address, Project Name, Project Description, License, dependencies, tests, usage information, and contributing to the project. After the user has answered all of the questions in the command-line, a README.md will be created inside the current working directory with the answers to the earlier questions embedded inside the applications README template.

GIF of application in action

Check out the full length HD demo: Video on Google Drive

Table of Contents


Installation

To install this application and its dependencies, simply run these commands in the directory that you'd like the application to reside in(from the command-line):

git clone git@github.com:lukecp5/readme-generator.git
cd readme-generator
npm install     

readme-generator Installation


Usage

You will use Node.js to run the application once you have it cloned and all of the depencies installed. Enter this command inside the readme-generator directory: node index.js Upon running the application, you will be presented with a series of questions about yourself and your project. Fill in your answers for each question, pressing enter after you've completed each answer. Once you have filled in all of the answers, a README.md file will be created in your current working directory.

Usage Example screenshot


Technologies

  • Node.js
  • Inquirer(npm package)
  • fs(built-in npm package)
  • path(built-in npm package)

License

This project is licensed under the MIT License


Contributing

  1. Fork the repo on GitHub
  2. Clone the project to your own machine
  3. Commit changes to your own branch
  4. Push your work back up to your fork
  5. Submit a Pull request so that we can review your changes