# Clone the project by running git clone.
$ git clone <REPO_LINK>
# Install the node dependencies by running
$ npm install
# Create a .env file based on .env.example
$ cp .env.example .env
# Start the React App on localhost:3000
$ npm start
For some basic source code explanation see the wiki page
The AWS environment supports both continuous integration and continuous deployment. The environment is made of the following components:
-
Github repository (nditech/CyberSim-UI): Each change on the local repositories are pushed to a new branch in the Github remote. Once these changes are reviewed, they are merged into the 'master' branch.
-
CodePipeline (ndi-cybersim-ui-staging, ndi-cybersim-ui-prod): A CodePipeline project is created for both staging and production environments. For the staging environment a webhook is registered on Github, so each change on the 'master' branch will trigger and automatic build on AWS. For the production environment no webhook is registered so changes on the 'master' branch will require a manual release in CodePipeline.
-
CodeBuild (ndi-cybersim-ui): A single CodeBuild project is created to build and test both staging and production changes. After a change is triggered on CodePiepeline (manually or automatically), the source code is transferred to CodeBuild and the steps defined in the 'buildspec.yml' file are executed. These steps include the installation of node, npm packages and the the bundling of the react app into static files. Once the build completed, CodePiepeline begins the deployment by transferring the output files in the build directory to S3. The
REACT_APP_API_URL
environment variable should be changed in thebuildspec.yml
file to the live URL of the backend API. -
S3 (ndi-cybersim-ui-staging, ndi-cybersim-ui-prod): A different S3 bucket is created for both staging and production. Public access is enabled on these buckets which are configured for static website hosting.
This project was bootstrapped with Create React App.
In the project directory, you can run:
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.
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.
You can learn more in the Create React App documentation.
To learn React, check out the React documentation.
This section has moved here: https://facebook.github.io/create-react-app/docs/code-splitting
This section has moved here: https://facebook.github.io/create-react-app/docs/analyzing-the-bundle-size
This section has moved here: https://facebook.github.io/create-react-app/docs/making-a-progressive-web-app
This section has moved here: https://facebook.github.io/create-react-app/docs/advanced-configuration
This section has moved here: https://facebook.github.io/create-react-app/docs/deployment
This section has moved here: https://facebook.github.io/create-react-app/docs/troubleshooting#npm-run-build-fails-to-minify