Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/deponte-designer/team-profile-generator

The Team Profile Generator is a command-line application that streamlines the creation of a team's organizational chart. It uses JavaScript and Node.js, with Inquirer.js for user prompts and Jest for testing. The app simplifies team building by collecting user input and generating an HTML representation of the team structure.
https://github.com/deponte-designer/team-profile-generator

inquirerjs javascript jest-test nodejs team-profile-generator

Last synced: 3 days ago
JSON representation

The Team Profile Generator is a command-line application that streamlines the creation of a team's organizational chart. It uses JavaScript and Node.js, with Inquirer.js for user prompts and Jest for testing. The app simplifies team building by collecting user input and generating an HTML representation of the team structure.

Awesome Lists containing this project

README

        

# Team-Profile-Generator

## Description
This project is a Test-Driven Development: Team Profile Generator designed to streamline the process of creating a team's profile. It employs object-oriented programming principles and interactive command-line prompts to collect information about team members and generate an HTML file for easy visualization. The primary technologies and tools used in this project include: JavaScript (JS), Node.js, Inquirer.js and Jest.

## Table of Contents
- [User Story](#user-story)
- [Installation](#installation)
- [Screenshots](#screenshots)
- [Usage](#usage)
- [Credits](#credits)
- [Deployment](#deployment)
- [How to Contribute](#how-to-contribute)
- [Contributions](#contributions)
- [Starred Project](#starred-project)
- [Tests](#tests)
- [Questions](#questions)
- [License](#license)
- [Badges](#badges)

## User Story
**As A** developer,
**I WANT** a tool to generate a team profile,
**SO THAT** I can easily organize and view information about my team members.

## Installation
Users can install the project by cloning the repository from GitHub and follow these steps to install the required dependencies:

1. Initialize the project:
```bash
npm init -y
```
2. Install Inquirer for user prompts:
```bash
npm i [email protected]
```
3. Install Jest for testing:
```bash
npm i jest
```
4. Update test script in package.json:
Edit the `"test"` script in the `package.json` file (line 10) to use Jest
```bash
"test": "jest"
```
5. Run tests:
```bash
npm run test
```
6. Create .gitignore file:
Create a file named `.gitignore` to specify files and directories that should be ignored by Git. Add the following line to ignore the `node_modules` folder:
```bash
node_modules
```

## Screenshots
![Team Generator User Input Screenshot](./assets/images/team-generator-user-input.png)
*The screenshot illustrate the command-line interaction with the Team Profile Generator application.*

![Team HTML Generator Screenshot](./assets/images/team-generator-html.png)
*This screenshot showcases the HTML output of the application, enhanced with added styling for a visually appealing presentation.*

## Usage

To use the Team Profile Generator, run the command `node index.js` in the terminal. Follow the prompts to provide information about your team, and the generator will create the `team.html` file based on your input.

1. Run the application:
```bash
node index.js
```
If you need you can:
1. Stop the application:
```bash
^C
```
2. Clear the terminal:
```bash
clear
```

## Credits
* [npm Inquirer.js](https://www.npmjs.com/package/inquirer)
* [Jestjs.io](https://jestjs.io/)
* [Professional README Guide](https://coding-boot-camp.github.io/full-stack/github/professional-readme-guide)
* [Badges Documentation by Shields.io](https://shields.io/docs/logos)

## Deployment
> This project is deployed and accessible at the following URLs:
>
> - [GitHub Repository](https://github.com/deponte-designer/Team-Profile-Generator "Team-Profile-Generator GitHub Repository"): Visit the repository for project details, including a comprehensive README.
> - [Sample HTML](https://github.com/deponte-designer/Team-Profile-Generator/blob/main/output/team.html "The output HTML file"): Visit this link to view the team.html file generated using the application.

## How to Contribute
To contribute to this project, follow these steps:

1. Fork the repository.
2. Create a new branch for your feature (`git checkout -b feature-name`).
3. Commit your changes (`git commit -m 'Add feature'`).
4. Push to the branch (`git push origin feature-name`).
5. Create a new pull request.

### Contributions
This project was developed by a single contributor [dePonte](https://github.com/deponte-designer).

### Starred Project
⭐ Your support by clicking on the star icon located at the top right of the project page and adding it to your favourites list would be greatly appreciated!

## Tests
To run Jest tests, execute the following command in the terminal:
```bash
npm run test
```
![Jest Test Results Screenshot](./assets/images/team-generator-test.png)
*The screenshot captures the output of the npm run test command for the Team Profile Generator project.*

## Questions
> For any questions or concerns about the project, you can reach me at [GitHub: dePonte](https://github.com/deponte-designer).

## License
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
Copyright © 2024 [dePonte](https://github.com/deponte-designer)

## Badges
![edX](https://img.shields.io/badge/edX-%2302262B.svg?style=for-the-badge&logo=edX&logoColor=white)
![Markdown](https://img.shields.io/badge/markdown-%23000000.svg?style=for-the-badge&logo=markdown&logoColor=white)
![JavaScript](https://img.shields.io/badge/javascript-%23323330.svg?style=for-the-badge&logo=javascript&logoColor=%23F7DF1E)
![HTML5](https://img.shields.io/badge/html5-%23E34F26.svg?style=for-the-badge&logo=html5&logoColor=white)
![CSS3](https://img.shields.io/badge/css3-%231572B6.svg?style=for-the-badge&logo=css3&logoColor=white)
![Bootstrap](https://img.shields.io/badge/bootstrap-%238511FA.svg?style=for-the-badge&logo=bootstrap&logoColor=white)
![Node.js](https://img.shields.io/badge/node.js-%23339933.svg?style=for-the-badge&logo=node.js&logoColor=white)
![Jest](https://img.shields.io/badge/-jest-%23C21325?style=for-the-badge&logo=jest&logoColor=white)
![npm](https://img.shields.io/badge/npm-%23CB3837.svg?style=for-the-badge&logo=npm&logoColor=white)
![Windows 11](https://img.shields.io/badge/Windows%2011-%230079d5.svg?style=for-the-badge&logo=Windows%2011&logoColor=white)
![Slack](https://img.shields.io/badge/Slack-4A154B?style=for-the-badge&logo=slack&logoColor=white)
![Google Chrome](https://img.shields.io/badge/Google%20Chrome-4285F4?style=for-the-badge&logo=GoogleChrome&logoColor=white)
![Visual Studio Code](https://img.shields.io/badge/Visual%20Studio%20Code-0078d7.svg?style=for-the-badge&logo=visual-studio-code&logoColor=white)
![Git](https://img.shields.io/badge/git-%23F05033.svg?style=for-the-badge&logo=git&logoColor=white)
![GitHub](https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge&logo=github&logoColor=white)
![GitLab](https://img.shields.io/badge/gitlab-%23181717.svg?style=for-the-badge&logo=gitlab&logoColor=white)
![Github Pages](https://img.shields.io/badge/github%20pages-121013?style=for-the-badge&logo=github&logoColor=white)