Skip to content

Commit a7de090

Browse files
authored
Updated README (#8)
1 parent 10faffd commit a7de090

1 file changed

Lines changed: 41 additions & 4 deletions

File tree

README.md

Lines changed: 41 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,54 @@
1-
Running backend & frontend
1+
Create a Blue Button Sandbox Account
22
---------------
3-
3+
Create an account at the link below, and register your test application, to get your Blue Button Sandbox Credentials which will allow you to
4+
access the Blue Button synthetic data. These credentials will be necessary to run this sample application as well as
5+
utilize the Blue Button data within your own applcation. See the section below 'Running the Back-end & Front-end'.
6+
7+
https://sandbox.bluebutton.cms.gov/v1/accounts/create
8+
9+
To ensure this sample application will work properly, make sure that when you register your application you add
10+
the following url (see below) under the 'Callback URLS/Redirect Uris' section:
11+
12+
http://localhost:3001/api/bluebutton/callback/
13+
14+
When you are ready to run your own application, you can change this value to the url that you need.
15+
Just log into your Blue Button Sandbox account and select 'View/Edit App->'.
16+
17+
Setup Docker & Node-js
18+
---------------
19+
20+
Install and setup Docker. Go to https://docs.docker.com/get-started/ and follow the directions.
21+
22+
Download and install node. Go to https://nodejs.org/en/download/ and follow the directions.
23+
24+
Running the Back-end & Front-end
25+
---------------
26+
27+
Once you have Docker and Node installed and setup then do the following:
28+
429
copy server/src/configs/sample.config.ts -> server/src/configs/config.ts
5-
replace the secret variables with the ones for your application
30+
31+
Make sure to replace the clientId and clientSecret variables within the config file with
32+
the ones you were provided, for your application, when you created your Blue Button Sandbox account.
33+
634

735
copy server/src/pre-start/env/sandbox.sample.env -> server/src/pre-start/env/development.env
836

937
docker-compose up -d
1038

39+
This single command will create the docker container with all the necessary packages, configuration, and code to
40+
run both the front and back ends of this sample application.
41+
42+
To see the application in action open your browser and enter the following URL:
43+
44+
http://localhost:3000
45+
46+
To see the process of authenticating with Blue Button via Medicare.gov and retrieve EoB data just click on the 'Authorize' button.
47+
1148
BB2 Sandbox User
1249
-----------
1350
To ensure data displays properly in the sample application please use a
14-
Blue Button 2 Sandbox user that has PDE EoBs. An example of a user with this
51+
Blue Button Sandbox user that has PDE (Part-D Events) EoBs (Explanation of Benefits). An example of a user with this
1552
data would be: BBUser29999 (PWD: PW29999!) or BBUser29998 (PWD: PW29998!)
1653

1754
Development

0 commit comments

Comments
 (0)