4.2.5 Set up application settings
The next step is to configure some functional application settings. Some of these settings can be changed later using the OpenCRVS Functional Configuration UI by a National System Administrator. Others must be configured now during installation and cannot be changed in production.
You will be referring to the Config: Application Settings Excel sheet that would have been prepared in section 2: Gather requirements.
1. Prepare global functional settings
Prepare your application-config-default.ts source file. This is a Typescript file that is loaded in the application via an API explained in section 3.2.9 Countryconfig APIs explained.
Using our application-config-default.ts file as an example, update the settings according to your needs.
2. Prepare javascript initialisation settings
The OpenCRVS Core Login application loads the following config js files before connecting to the OpenCRVS backend to serve all the content. The Login app has not communicated with the backend yet and needs to know how to access it
Login app - localhost development: login-config.js
As you can see, the React Login application uses the URL values to understand how to connect to backend services such as the login authentication API and the country configuration API. Do not edit the URLs.
You must set some values:
COUNTRY: Set the Alpha 3 country code to be the same as the value you used when importing the set up files in step 3.2.5. The Login app needs to convert users phone numbers into MSISDN numbers using an Alpha 3 country code in case the user forgets their login details and requires an SMS reset.
LANGUAGES: This property allows you to customise the global language options. This value is a comma separated string of ISO 639-1 language codes for every translation you wish to set up in step 3.2.5.1 Managing language content.
For example, if you wanted to support Spanish and English, with Spanish being the default this string should be:
Login app - server: login-config.prod.js
As you can see, the server config file contains the same settings.
You may notice that localhost is replaced by your domain name dynamically in handlebars. Do not edit the URLs. We have taken care of this substitution for you in step 3.3.5 Deploy
You must set the COUNTRY & LANGUAGES values only.
Client app - localhost development: client-config.js
Following the same process as you did for the local development Login app config file, you must set the COUNTRY & LANGUAGES values, and can optionally uncomment LEADERBOARDS_DASHBOARD_URL, REGISTRATIONS_DASHBOARD_URL and STATISTICS_DASHBOARD_URL if you wish to run metabase dashboards locally. Refer to step 3.2.5.2 Configuring Metabase Dashboards for more instructions.
Client app - server: client-config.prod.js
Following the same process as you did for the production Login app config file, you must set the COUNTRY & LANGUAGES values.
Last updated