Archiving Notes

This repository was created with the purpose of having a sample app that we could use to learn, deploy and try BCGov's features before we actually have a well defined product to SPAR. Now that we have, this sample app was archived and these exact codebase and functions were added to the QuickStart TypeScript repository, under frontend-react folder.

Also you can check the new SPAR webapp that's on going on this repository, called SPAR Webapp.

If you need any help, you can look for Team Encora or one of his members.

Natural Resources Front-End Starting Progressive Web Application

This repository holds a set of policies, standard, guides and pipelines to get started with a Progressive Web Application. Before writing your first line of code, please take a moment and check out our CONTRIBUTING guide.

Our Policy

• Work in the open: That means that everything we do should be open, should be public. Please, don't create private repositories unless you have a very strong reason. Keeping things public is a must follow rule for BC Government.
• Customer centred services: All the work that's been created is to improve users, customers, and friends usability and experience. Is important to keep that in mind, because as engineers sometimes we face technical issues, however, our goal is to have a good product.
• Community based work: Remember that you're not alone. It's very likely that your problem is someone else's problem. Let's figure it out together. So, ask a question using our channels. We have our own Stackoverflow and our Rocket Chat channel.

Stack

Here you will find a comprehensive list of all the languages and tools that are been used in this app. And also everything you need to get started, build, test and deploy.

• React Progressive Web Application
  • TypeScript
  • Redux
  • Styled Components
  • Jest and Cypress
• Lint
  • Airbnb ESLint
• Tools
  • Docker
  • Microsoft Visual Studio Code

Getting started

Once you have cloned this repository, you can get the app running by typing yarn install and then yarn start from the project root directory. Then head to http://localhost:3000.

To run the unit tests all you need is yarn test. For end-to-end test you need to run yarn cypress run to run on console or yarn cypress open to use the Cypress IDE.

Before writing your first line of code, please take a moment and check out our CONTRIBUTING guide.

Quick look

But if all you want is to take a quick look on the running service, you can do it by using Docker.

Note that you'll need these environment variables:

REACT_APP_SERVER_URL=<server-url>
REACT_APP_NRFESAMPLEAPP_VERSION=dev
REACT_APP_KC_URL=<keycloak-server-url>
REACT_APP_KC_REALM=<realm-name>
REACT_APP_KC_CLIENT_ID=<client-id>

Build the service:

docker build -t bcgov/nr-frontend-starting-app:latest \
  --build-arg REACT_APP_NRFESAMPLEAPP_VERSION=dev \
  --build-arg REACT_APP_SERVER_URL=<server-url> .

Then run with:

docker run -p 3000:3000 \
  -e REACT_APP_NRFESAMPLEAPP_VERSION=dev \
  -e REACT_APP_SERVER_URL=<server-url> \
  -e REACT_APP_KC_URL=<keycloak-server-url> \
  -e REACT_APP_KC_REALM=<realm-name> \
  -e REACT_APP_KC_CLIENT_ID=<client-id> \
  -t bcgov/nr-frontend-starting-app:latest

Getting help

As mentioned, we're here to help. Feel free to start a conversation on Rocket chat or ask a question on Stackoverflow.