This project was bootstrapped with Create React App.
- Install mkcert.
- Install local CA to available trust stores with the following command.
mkcert -install
- Uncomment HTTPS=true in .env to enable HTTPS.
# .env
HTTPS=true
- Optional: Add hosts to OS hosts file and setup:ssl script for additional https domains, defaults only to localhost.
- Windows: C:\Windows\System32\drivers\etc\hosts
- Mac: /etc/hosts
# hosts
127.0.0.1 localhost myhost
# package.json
"setup:ssl": "... localhost myhost",
- Run setup script in package.json to set up husky and ssl certificates. Must generate the ssl certificates for https support.
npm run setup
- When viewing the application in the browser and shows a warning about untrusted certificates, will need to Trust the local CA.
- Warnings
- Chrome: "Your connection is not private"
- Firefox: "Warning: Potential Security Risk Ahead"
- Warnings
- Replace ./src/assets/images/icons/logo.svg with application logo.svg.
- Run icons script in package.json to generate icons and splash screens. This script uses pwa-asset-generator.
npm run icons
In the project directory, you can run:
Run source-map-explorer on build folder.
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!
See the section about deployment for more information.
Note: this is a one-way operation. Once you eject
, you can’t go back!
If you aren’t satisfied with the build tool and configuration choices, you can eject
at any time. This command will remove the single build dependency from your project.
Instead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except eject
will still work, but they will point to the copied scripts so you can tweak them. At this point you’re on your own.
You don’t have to ever use eject
. The curated feature set is suitable for small and middle deployments, and you shouldn’t feel obligated to use this feature. However we understand that this tool wouldn’t be useful if you couldn’t customize it when you are ready for it.
Runs prettier on project files.
Runs pwa-asset-generator to generate icons and splash screens for the application.
Runs all other lint scripts together.
Runs eslint on project files.
Runs stylelint on project files.
Runs these commands before build script.
Runs serve as http in the build folder.
Runs serve as https in the build folder.
Runs all other setup scripts together.
Runs husky to install husky hooks and adds pre-commit hook.
Runs mkcert to generate ssl certificates for https support.
Runs the app in the development mode.
Open 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.
Launches the test runner in the interactive watch mode.
See the section about running tests for more information.
Launches the test runner for CI environments.
Launches the test runner for test coverage.
Launches the test runner in debug mode.