Common Drug Reference Prototypes

 

- Please note this prototype has not been linked up with heroku so can only be viewed on a local machine.
- Contact matthew.proctor-leake@nhs.net if this needs to be set up.

 

Project Setup

Cloning the project

Clone the project using git:

git clone https://github.com/nhsbsa/cdr-client-prototype.git

or

git clone git@github.com:nhsbsa/cdr-client-prototype.git

NPM Setup

Once the project is cloned, run the following command to download and install node dependencies:

npm install
npm install gulp

If there are issues downloading dependencies, you may need to add the nhsbsa npm repository. To do this:

• Create the file ~/.npmrc
• Add the following configuration:

registry=https://dps-nexus.service.nhsbsa:8443/repository/npm
strict-ssl=false

Install the live reload plugin

Install the live reload plugin for your browser

• Chrome

 

---

 

Running the Prototype locally

To run the prototype locally, use gulp:

gulp

The prototype will then open a window in your browser on http://localhost:3000.

Browser sync settings can be accessed on http://localhost:3001.

Running Pa11y accessibility checks

pa11y-ci -c pa11y.json

 

---

 

Procedure for merging branches

Pull in the latest version of main locally using

git pull origin main

Create a local branch using your initials followed by /. The describe the change, using the Jira ticket number if you have it.

For example, mpl/MM-700-discontinuation-journey

Make your changes locally and then push up to Github using your IDE commit tab, or using the following commands in your terminal:

git add .
git commit -m "change comments go here"
git push origin local-branch-name

 

Once pushed, there should be a highlight at the top of the repo asking to 'compare and pull request'. Select this button.

Then you need to add a reviewer and create the pull request

The reviewer will be notified and will review the changes before marking it as being able to be merged. Then it can be merged in to main from the pull request. If the reviewer is able to merge this on their side then they will notify the user who did the pull request that it has been completed.