Mac Development Setup Instructions

To get started with development on a Mac, follow the following instructions:

Getting your development envrionment set up:

• Install the required version of Ruby:
  • If using RVM: rvm install in the fhir-validator-app folder
  • If using rbenv: rbenv install in the fhir-validator-app folder
• Tell RVM to use that version of Ruby: rvm use
  • Note: RVM/rbenv make use of the .ruby-version file, which specifies the version of Ruby being used by the app. That's why there's no need to specify a Ruby version to either of these commands.
• Install Bundler: gem install bundler
• Install the Ruby dependencies: bundle install
• Install Node, using your method of choice
  • I use Node Version Manager, but you can also install Node via homebrew with brew install node@12 if you're on a Mac.
• Install the Javascript dependencies: npm install

Running the app:

• Run the Typescript compilation engine: npm start
  • Note: this will auto-recompile whenever you save a change to one of the Typescript files, and will trigger a page refresh if you have the app open in development
• Run the Ruby server: bundle exec rackup
• Run the validator wrapper: docker run -p 8080:4567 infernocommunity/fhir-validator-wrapper:latest
• Navigate to the app in your browser of choice at http://localhost:4567