webclient - bcgov/healthgateway GitHub Wiki
WebClient
Prerequisite
The Patient service needs to be configured.
WebClient Configuration
In order to make changes and then have the web application to refresh without having to restart the server when developing locally, a local environment file i.e., '.env.local' will need to be created in the project's root directory.
The VUE environment variable defined in the local environment file will disable 'Integrity' in VUE config file. When working locally. Integrity will be disabled.
Using this '.env.local' file will allow developers to utilize refresh without having to restart the server. Do not check in this file. Please create one for local use. This file has been applied to git ignore.
cd $GATEWAYHOME/Apps/WebClient/src/ClientApp/
code .env.local
Add the following text:
VUE_APP_CONFIG_INTEGRITY=false
Save the file.
Run WebClient
Command line
Open a new terminal/command Window to run the .Net application
cd $GATEWAYHOME/Apps/WebClient/src/
dotnet run
Open another terminal Window to run the VUE Cli
cd $GATEWAYHOME/Apps/WebClient/src/
npm run serve
VS Code
- Select the WebClient project
- Say Yes or Accept any popups regarding adding assets for debugging
- Select the Solution and click Enter which should create a .vscode/launch.json
- Click F5 or Run/Start Debugging
Visual Studio
- Right Click on the solution and select Properties
- Select Multiple startup projects
- Set WebClient action to Start
- Click Ok
- Click F5 or Debug/Start Debugging
Visual Studio for Mac
- Right Click on the solution and select set startup project
- Click on Create Run Configuration
- Ensure that the WebClient solution item is checked
- Click Ok
- Select Run Menu then Start Debugging
WebClient Verification
- Open a Chrome session to http://localhost:5000
- Authenticate with Virtual BC Services Card
- You will see a banner Error.
- You should be able to Add/Edit/Delete Notes.
Related Issues:
- Firefox Issues - KeyCloak operation while developing locally, requires additional configuration.