Skip to main content
Version: Version 3.0 🚧

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 labled 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.

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 branchgit switch feat/v2-main
# Restore dependenciesyarn install
# Start local development serveryarn 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 PWAyarn 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.