Skip to main content
Version: Version 3.3 - Segmentation Support 🚧

Getting Started

Setup​

Fork & Clone​

If you intend to contribute back changes, or if you would like to pull updates we make to the OHIF Viewer, then follow these steps:

  • Fork the OHIF/Viewers repository
  • Create a local clone of your fork
    • git clone https://github.com/YOUR-USERNAME/Viewers
  • Add OHIF/Viewers as a remote repository labeled upstream
    • Navigate to the cloned project's directory
    • git remote add upstream https://github.com/OHIF/Viewers.git

With this setup, you can now sync your fork to keep it up-to-date with the upstream (original) repository. This is called a "Triangular Workflow" and is common for Open Source projects. The GitHub blog has a good graphic that illustrates this setup.

v3-stable branch​

Currently the stable branch for OHIF-v3 is v3-stable. Once the v3-stable branch has feature parity with the master branch, v3-stable will be pushed to the master branch. You can read more about the roadmap timeline here.

Private​

Alternatively, if you intend to use the OHIF Viewer as a starting point, and you aren't as concerned with syncing updates, then follow these steps:

  1. Navigate to the OHIF/Viewers repository
  2. Click Clone or download, and then Download ZIP
  3. Use the contents of the .zip file as a starting point for your viewer

NOTE: It is still possible to sync changes using this approach. However, submitting pull requests for fixes and features are best done with the separate, forked repository setup described in "Fork & Clone"

Developing​

Requirements​

  • Node.js & NPM
  • Yarn
  • Yarn workspaces should be enabled:
    • yarn config set workspaces-experimental true

Kick the tires​

Navigate to the root of the project's directory in your terminal and run the following commands:

# Switch to the v3 branch
git switch v3-stable

# Restore dependencies
yarn install

# Start local development server
yarn run dev

You should see the following output:

@ohif/viewer: i ï½¢wdsï½£: Project is running at http://localhost:3000/
@ohif/viewer: i ï½¢wdsï½£: webpack output is served from /
@ohif/viewer: i ï½¢wdsï½£: Content not from webpack is served from D:\code\ohif\Viewers\platform\viewer
@ohif/viewer: i ï½¢wdsï½£: 404s will fallback to /index.html

# And a list of all generated files

🎉 Celebrate 🎉​

Building for Production​

More comprehensive guides for building and publishing can be found in our deployment docs

# Build static assets to host a PWA
yarn run build

Troubleshooting​

  • If you receive a "No Studies Found" message and do not see your studies, try changing the Study Date filters to a wider range.
  • If you see a 'Loading' message which never resolves, check your browser's JavaScript console inside the Developer Tools to identify any errors.