Skip to content

Commit

Permalink
Add the README
Browse files Browse the repository at this point in the history
  • Loading branch information
vassalloandrea committed Mar 6, 2021
1 parent ee93729 commit 1024cb3
Showing 1 changed file with 66 additions and 0 deletions.
66 changes: 66 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# React with TS template

[![codecov](https://codecov.io/gh/vassalloandrea/react-template/branch/master/graph/badge.svg?token=F38EP8I67R)](undefined)

This is the template that I usually use to create a new React project from scratch removing
the complex boilerplate added by other tools.
Feel free to contribute opening issue and/or making PRs ❤️

## Main technologies

- [React](https://reactjs.org/)
- [Typescript](https://www.typescriptlang.org/)
- [Jest](https://github.com/facebook/jest)
- [Cypress](https://www.cypress.io/)
- [ESlint](https://github.com/eslint/eslint)
- [Prettier](https://github.com/prettier/prettier)
- [CodeCov](https://about.codecov.io/)
- [WebVitals](https://web.dev/vitals/)

The project has a fully configured CI using GH actions.
Each PR or push on the main branch will trigger the CI that runs:

- The unit tests
- The E2E tests
- The ESlint linter
- The Prettier formatter

and push the Jest coverage on CodeCov.

## Running Locally

Make sure you have [Node.js](http://nodejs.org/)

```
git clone [email protected]:vassalloandrea/react-template.git
cd react-template
npm install
npm run start
```

Your app now is running on [localhost:8080](http://localhost:8080/).

## Run tests

This project uses Jest to run unit test and Cypress to run the E2E ones.

```
npm run test:unit
npm run test:e2e
```

## Run linter

This project uses ESlint and Prettier to check code style.

```
npm run lint
npm run format:check
```

You can use these commands to autofix code style issues

```
npm run lint:fix
npm run format:fix
```

0 comments on commit 1024cb3

Please sign in to comment.