Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/samuel-gomez/react-starter-vitejs

React Starter with Vite and Slash Toolkit
https://github.com/samuel-gomez/react-starter-vitejs

eslint guerkin husky msw prettier react react-oidc reactquery reacttoolkit sass sonarqube typescript vite vitest

Last synced: about 1 month ago
JSON representation

React Starter with Vite and Slash Toolkit

Awesome Lists containing this project

README

        


React Starter Toolkit


A starter based on Vite and Slash
Design System (Guidelines, Storybook)






Build


Commitizen friendly







Netlify Status



Quality Gate Status



Reliability


Security

Demo 😎





You can see a demo here

## Installation 🚀

> Requirement : Node > 18

### Cloning

```
git clone https://github.com/samuel-gomez/react-starter-vitejs.git
```

> For VSCode users, you can open the workspace directly by double clicking on the app.code-workspace file

### 🚨 Before installation 🚨

If you want to clean this demo, you have to launch (**node required)**:

```
npm run clean
```

This script delete all files of the demo (see the [CLEAN.md](./docs/CLEAN.md) file)

After that, you can run :

```
npm i
```

you have to update snapshots

```
npm t -- -u
```

### Remote

```
git init
git add .
git commit -m "Initial Commit"
git remote add origin $repo__url
git push -u origin master
```

## Configuration ⚙️

After installation, you have to personalize some parameters, you can check it in the [CONFIG.md](./docs/CONFIG.md) file

## Available Scripts

In the project directory, you can run :

### `npm start` 🏁

Runs the app in the development mode.

Open [http://localhost:3000](http://localhost:3000) to view it in the browser.

The page will reload if you make edits.

You will also see any lint errors in the console.

### `npm test` or `npm t` 🔬

Launches the test runner in the interactive watch mode.

### `npm run cover:local`

Launches the test runner with **coverage and all warnings**.

### `npm run cover` ☂

Launches the test runner with **coverage and no warning** (silent mode).

### `npm run build` 📦

Builds the app for production to the `build` folder.

It correctly bundles React in production mode and optimizes the build for the best performance.

The build is minified and the filenames include the hashes.

Your app is ready to be deployed!

### `npm run cz` ⛩

If you want a helper to respect the conventional commits naming, **Commitizen** give a cli interface.

![commitizen](./docs/images/commitizen.png)

### `npm run lint` 👮‍♂️

Script to launch eslint analyse (see the [eslintrc.cjs](./.eslintrc.cjs) file)

### `npm run lint:fix` 👮‍♂️⛑

Script to launch **eslint** analyse with **auto fix**.

### `npm run prettier` 🎩

Script to launch prettier analyse (see the [prettierrc.cjs](./.prettierrc.cjs) file)

### `npm run prettier:fix` 🎩⛑

Script to launch **prettier** analyse with **auto fix**.

### `npm run check` 👍

Script to launch **eslint** analyse and **prettier** analyse with **auto fix**.

### `npm run prepare` 🐶

Script to launch **husky** installation, it's launched during the global installation.

## Issues 🐞

If you detect a **bug**, please create an issue :
https://github.com/samuel-gomez/react-starter-vitejs/issues

## Quality 💎

### SonarCloud

https://sonarcloud.io/project/overview?id=samuel-gomez_react-starter-vitejs

## Structure

See the [STRUCTURE.md](./docs/STRUCTURE.md) file