❀Nautical Poseidon Mythology
    Wondering what’s next for npm?Check out our public roadmap! »


    0.19.6 ‱ Public ‱ Published


    ohif-viewer is a zero-footprint medical image viewer provided by the Open Health Imaging Foundation (OHIF). It is a configurable and extensible progressive web application with out-of-the-box support for image archives which support DICOMweb.

    CircleCI codecov All Contributors code style: prettier semantic-release

    NPM version NPM downloads Pulls MIT License

    ATTENTION: If you are looking for Version 1 (the Meteor Version) of this repository, it lives on the v1.x branch


    Building a web based medical imaging viewer from scratch is time intensive, hard to get right, and expensive. Instead of re-inventing the wheel, you can use the OHIF Viewer as a rock solid platform to build on top of. The Viewer is a React Progressive Web Application that can be embedded in existing applications via it's packaged source (ohif-viewer) or hosted stand-alone. The Viewer exposes configuration and extensions to support workflow customization and advanced functionality at common integration points.

    If you're interested in using the OHIF Viewer, but you're not sure it supports your use case check out our docs. Still not sure, or you would like to propose new features? Don't hesitate to create an issue or open a pull request.

    Getting Started

    This readme is specific to testing and developing locally. If you're more interested in production deployment strategies, you can check out our documentation on publishing.

    Want to play around before you dig in? Check out our LIVE Demo




    1. Fork this repository
    2. Clone your forked repository (your origin)
    • git clone git@github.com:YOUR_GITHUB_USERNAME/Viewers.git
    1. Add OHIF/Viewers as a remote repository (the upstream)
    • git remote add upstream git@github.com:OHIF/Viewers.git

    Developing Locally

    In your cloned repository's root folder, run:

    // Restore dependencies
    yarn install
    // Stands up local server to host Viewer.
    // Viewer connects to our public cloud PACS by default
    yarn start

    For more advanced local development scenarios, like using your own locally hosted PACS and test data, check out our Essential: Getting Started guide.

    E2E Tests

    Using Cypress to create End-to-End tests and check whether the application flow is performing correctly, ensuring that the integrated components are working as expected.

    Why Cypress?

    Cypress is a next generation front end testing tool built for the modern web. With Cypress is easy to set up, write, run and debug tests

    It allow us to write different types of tests:

    • End-to-End tests
    • Integration tests
    • Unit tets

    All tests must be in ./cypress/integration folder.

    Commands to run the tests:

    // Open Cypress Dashboard that provides insight into what happened when your tests ran
    yarn run cy
    // Run all tests using Electron browser headless
    yarn run cy:run
    // Run all tests in CI mode
    yarn run cy:run:ci


    Large portions of the Viewer's functionality are maintained in other repositories. To get a better understanding of the Viewer's architecture and "where things live", read our docs on the Viewer's architecture

    It is notoriously difficult to setup multiple dependent repositories for end-to-end testing and development. That's why we recommend writing and running unit tests when adding and modifying features. This allows us to program in isolation without a complex setup, and has the added benefit of producing well-tested business logic.

    1. Clone this repository
    2. Navigate to the project directory, and yarn install
    3. To begin making changes, yarn run dev
    4. To commit changes, run yarn run cm

    When creating tests, place the test file "next to" the file you're testing. For example:

    // File
    // Test for file

    As you add and modify code, jest will watch for uncommitted changes and run your tests, reporting the results to your terminal. Make a pull request with your changes to master, and a core team member will review your work. If you have any questions, please don't hesitate to reach out via a GitHub issue.


    Looking to contribute? Look for the Good First Issue label.

    🐛 Bugs

    Please file an issue for bugs, missing documentation, or unexpected behavior.

    See Bugs

    💡 Feature Requests

    Please file an issue to suggest new features. Vote on feature requests by adding a 👍. This helps maintainers prioritize what to work on.

    See Feature Requests

    ❓ Questions

    For questions related to using the library, please visit our support community, or file an issue on GitHub.

    Google Group


    If you want to know what's planned for the very near future, check out our roadmap. The best way to influence when and what is worked on is to contribute to the conversation by creating GitHub issues, and contributing code through pull requests. OHIF's high level priorities for the near future are:

    • Feature parity with version 1
    • Extension and configuration improvements with key integration partners
    • Continued Developer Experience Improvements
    • Segmentation Tools, and improved VTK.js support

    More granular information will make it's way to the backlog as these items become scoped for development by core maintainers.

    Don't hesitate to ask questions, propose features, or create pull requests. We're here, we're listening, and we're ready to build the best open source medical imaging viewer on the web.

    Roadmap Generously Powered by Canny.io


    Thanks goes to these wonderful people (emoji key):

    Erik Ziegler
    Erik Ziegler

    đŸ’» 🚇
    Evren Ozkan
    Evren Ozkan

    Gustavo André Lelis
    Gustavo André Lelis

    Danny Brown
    Danny Brown

    đŸ’» 🚇

    Esref Durna
    Esref Durna


    David Wire
    David Wire

    JoĂŁo Felipe de Medeiros Moreira
    JoĂŁo Felipe de Medeiros Moreira

    Egor Lezhnin
    Egor Lezhnin


    This project follows the all-contributors specification. Contributions of any kind welcome!


    MIT © OHIF


    To acknowledge the OHIF Viewer in an academic publication, please cite

    LesionTracker: Extensible Open-Source Zero-Footprint Web Viewer for Cancer Imaging Research and Clinical Trials

    Trinity Urban, Erik Ziegler, Rob Lewis, Chris Hafey, Cheryl Sadow, Annick D. Van den Abbeele and Gordon J. Harris

    Cancer Research, November 1 2017 (77) (21) e119-e122 DOI: 10.1158/0008-5472.CAN-17-0334

    Note: If you use or find this repository helpful, please take the time to star this repository on Github. This is an easy way for us to assess adoption and it can help us obtain future funding for the project.

    This work is supported primarily by the National Institutes of Health, National Cancer Institute, Informatics Technology for Cancer Research (ITCR) program, under a grant to Dr. Gordon Harris at Massachusetts General Hospital (U24 CA199460).




    npm i ohif-viewer

    DownloadsWeekly Downloads






    Unpacked Size

    90.5 MB

    Total Files


    Last publish


    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar
    • avatar