A highly scalable and focused on performance and best practices boilerplate code for TypeScript based React SPA applications.
This project was bootstrapped with Vite and modified by TSH team.
Start your new React application in seconds!
Generate React code snippets from the CLI by using Plop micro-generator framework.
The best way to write modern frontend applications. Code is easier to understand. By using TypeScript it is more difficult to write invalid code as was the case in dynamically typed languages.
Focus on writing code, not formatting it! Code formatter and linter keeps the code clean which makes work and communication with other developers more effective!
To start your new React project based on the react-starter-boilerplate
you need to follow this steps:
- Clone this repository:
git clone https://github.com/TheSoftwareHouse/react-starter-boilerplate.git
-
Change the name of project directory to the name of your project. Also don't forget to change the name of your application in
package.json
file. -
Restore git history of the project. To do that, run following commands:
sudo rm -r .git
git init
git remote add origin <your empty project repository>
git remote -v
- Replace this file with
PROJECT_README.md
and fill all the placeholders with data about your project:
mv PROJECT_README.md README.md
- Add all files to git history and create initial commit:
git add .
git commit -m 'Initial commit'
git push origin master
- Copy the
.env.dist
file to.env.local
and populate the environment variables with the values used in the local environment
cp .env.dist .env.local
Now, your project is bootstrapped successfully! 🎉
You can install dependencies and start developing your React application 🚀
npm run [command_name]
start
- Launches the app in development mode on http://localhost:3000build
- Compiles and bundles the app for deployment*build:ci
- Build command optimized for CI/CD pipelinesbuild:analyze
- Builds the app and opens the rollup-plugin-visualizer report in the browsertypecheck
- Validate the code using TypeScript compilerpreview
- Boot up a local static web server that serves application build. It's an easy way to check if the production build looks OK on your local machinetest
- Run unit tests with vitestcoverage
- Run unit tests with code coverage calculationlint
- Validate the code using ESLint and Prettierlint:fix
- Validate and fix the code using ESLint and Prettierplop
- Run CLI with commands for code generationtranslations
- Run Babelsheet tool for fetch the latest translationsserve:cypress
- Run Cypress E2E tests panelversion
- Build CHANGELOG file base on git commits historye2e:open
- Run E2E tests panele2e:ci:firefox
: Run E2E tests on Firefox browser in CI pipelinese2e:ci:chrome
: Run E2E tests on Chrome browser in CI pipelines
*See the section about deployment for more information.
Anyone and everyone is welcome to contribute. Start by checking out the list of open issues.
However, if you decide to get involved, please take a moment to review the guidelines.
Copyright © 2021-present The Software House. This source code is licensed under the MIT license found in the LICENSE file.
Made with ♥ by The Software House (website, blog) and contributors.