https://github.com/diegovictor/named-web

Foxbox Week Challenge #2. Application to request names generation based on a choosed sample.
https://github.com/diegovictor/named-web

editorconfig eslint foxbox generator javascript js name-generator named node nodejs prettier react reactjs web

Last synced: 2 months ago
JSON representation

Foxbox Week Challenge #2. Application to request names generation based on a choosed sample.

• Host: GitHub
• URL: https://github.com/diegovictor/named-web
• Owner: DiegoVictor
• License: mit
• Created: 2022-01-26T21:08:11.000Z (over 4 years ago)
• Default Branch: main
• Last Pushed: 2025-05-28T12:21:53.000Z (about 1 year ago)
• Last Synced: 2025-06-23T03:46:53.451Z (12 months ago)
• Topics: editorconfig, eslint, foxbox, generator, javascript, js, name-generator, named, node, nodejs, prettier, react, reactjs, web
• Language: JavaScript
• Homepage: https://named.netlify.app/
• Size: 1.48 MB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# [Web] Named

[![CircleCI](https://img.shields.io/circleci/build/github/DiegoVictor/named-web?style=flat-square&logo=circleci)](https://app.circleci.com/pipelines/github/DiegoVictor/named-web)

[![react](https://img.shields.io/badge/reactjs-18.2.0-61dafb?style=flat-square&logo=react)](https://reactjs.org/)

[![styled-components](https://img.shields.io/badge/styled_components-5.3.6-db7b86?style=flat-square&logo=styled-components)](https://styled-components.com/)

[![eslint](https://img.shields.io/badge/eslint-8.32.0-4b32c3?style=flat-square&logo=eslint)](https://eslint.org/)

[![airbnb-style](https://flat.badgen.net/badge/style-guide/airbnb/ff5a5f?icon=airbnb)](https://github.com/airbnb/javascript)

[![jest](https://img.shields.io/badge/jest-27.5.1-brightgreen?style=flat-square&logo=jest)](https://jestjs.io/)

[![coverage](https://img.shields.io/codecov/c/gh/DiegoVictor/named-web?logo=codecov&style=flat-square)](https://codecov.io/gh/DiegoVictor/named-web)

[![MIT License](https://img.shields.io/badge/license-MIT-green?style=flat-square)](https://raw.githubusercontent.com/DiegoVictor/named-web/refs/heads/main/LICENSE)

[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)

Generates names based on preseted datasets (list of example names), but you can upload a custom dataset (it must have at least 23 names). Was utilized the Markov Chain algorithm to generate the names, a custom script was created based on this article: [Generating Startup names with Markov Chains](https://towardsdatascience.com/generating-startup-names-with-markov-chains-2a33030a4ac0).

Live Demo: https://named.netlify.app/

## Table of Contents

* [Screenshots](#screenshots)

* [Installing](#installing)

  * [Configuring](#configuring)

    * [.env](#env)

    * [API](#api)

* [Usage](#usage)

* [Running the tests](#running-the-tests)

  * [Coverage Report](#coverage-report)

# Screenshots

Click to expand.




# Installing

Easy peasy lemon squeezy:

```

$ yarn

```

Or:

```

$ npm install

```

> Was installed and configured the [`eslint`](https://eslint.org/) and [`prettier`](https://prettier.io/) to keep the code clean and patterned.

## Configuring

Configure your environment variables and remember to start the [API](https://github.com/DiegoVictor/named-api) before to start this app.

### .env

In this file you may configure the API's url. Rename the `.env.example` in the root directory to `.env` then just update with your settings.

key|description|default

---|---|---

REACT_APP_API_BASE_URL|API's base url.|`http://localhost:8080`

### API

Start the [API](https://github.com/DiegoVictor/named-api) (see its README for more information). In case of any change in the API's `port` or `host` remember to update the [`.env`](#env) too.

# Usage

To start the app run:

```

$ yarn start

```

Or:

```

npm run start

```

# Running the tests

[Jest](https://jestjs.io) was the choice to test the app, to run:

```

$ yarn test

```

Or:

```

$ npm run test

```

## Coverage report

You can see the coverage report inside `tests/coverage`. They are automatically created after the tests run.