https://github.com/playerony/react-javascript-boilerplate

Minimal javascript boilerplate for React apps
https://github.com/playerony/react-javascript-boilerplate

Last synced: 4 days ago
JSON representation

Minimal javascript boilerplate for React apps

• Host: GitHub
• URL: https://github.com/playerony/react-javascript-boilerplate
• Owner: playerony
• Created: 2021-08-06T14:44:58.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2021-08-31T18:34:33.000Z (over 3 years ago)
• Last Synced: 2023-03-08T05:38:21.497Z (almost 2 years ago)
• Language: Shell
• Size: 2.97 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 

![Lint](https://github.com/playerony/react-javascript-boilerplate/workflows/lint/badge.svg)

![Test](https://github.com/playerony/react-javascript-boilerplate/workflows/test/badge.svg)

![Build](https://github.com/playerony/react-javascript-boilerplate/workflows/build/badge.svg)

![Prettier](https://github.com/playerony/react-javascript-boilerplate/workflows/prettier/badge.svg)

![Commitlint](https://github.com/playerony/react-javascript-boilerplate/workflows/commitlint/badge.svg)

## 📖 Table of Contents

- [✨ Getting started](#user-content--getting-started)

  - [Prerequisites](#prerequisites)

  - [Bootstrap](#bootstrap)

- [📜 Scripts](#user-content--scripts)

  - [Development](#development)

  - [Build](#build)

  - [Shell](#shell)

  - [Test](#test)

  - [Analyze](#analyze)

- [📚 Documentation](#user-content--documentation)

  - [Commit Message Guideline](#commit-message-guideline)

## ✨ Getting started

### Prerequisites

You need to have installed the following software:

- [nodejs](https://nodejs.org/en/) (>=14.15.0)

- [yarn](https://yarnpkg.com/) (>= 1.22.10)

### Bootstrap

```bash

  git clone --depth 1 https://github.com/playerony/react-javascript-boilerplate my-app

  cd my-app

  bash ./scripts/setup-project.sh

```

## 📜 Scripts:

### Development

- `dev` - Run application in development mode.

- `docker:run` - Run created docker image.

- `docker-compose up` - Build and run docker image.

### Build

- `build` - Build for production a ready application.

- `docker:build` - Docker build.

### Shell

- `remove-node-modules` - Remove node_modules directory with rimraf command.

- `reinstall-node-modules` - Invokes `remove-node-modules` and `yarn install`.

- `gcb` - (git-create-branch) Create and checkout on the branch with the given name.

- `gcmwp` - (git-checkout-main-with-pull) Checkout to main branch and invokes pull command.

- `gpc` - (git-push-changes) Commit and push all files on a current branch with the given commit message.

### Test

- `test` - Run tests.

- `test:ci` - Run tests in CI mode.

- `test:watch` - Run tests in watch mode.

- `test:coverage` - Run tests in coverage mode.

- `test:update-snapshot`: Run tests and update all snapshots.

### Analyze

- `lint` - Run `eslint`. Output any errors 🚨.

- `lint:fix` - Run `eslint` with `--fix`flag . Fix any lint errors 🚨.

- `commitlint` - Run `commitlint`. Output any errors 🚨.

- `format` - Run `prettier` with `--write` flag to format all the files.

- `format:check` - Run `prettier` with `--check` flag. Output any format errors 🚨.

- `check` - Run `lint`, `test`, `build`, `commitlint` and `format:check`. Output any errors 🚨.

## 📚 Documentation

### Commit Message Guideline

- For easier commit type recognition commit messages are prefixed with a proper type

- See available commit types: [https://www.npmjs.com/package/@commitlint/config-conventional](https://www.npmjs.com/package/@commitlint/config-conventional)