Cornerstone

# Installation

# Compatibility Note

CornerstoneTools.js does not support IE8 and below because it uses ECMAScript 5 features that are un-shimmable in IE8. However it supports all ECMAScript 5 compliant browsers (opens new window).

# Release Notes

We're a small team, so our docs may not always be 100% accurate. Please feel free to create an issue and/or PR a change to update our docs.

  • Latest stable version: @latest 2.3.9
  • Latest beta version: @next 3.0.0-b.1003

You can find the latest versions for each tag by clicking the versions tab for the cornerstone-tools npm listing (opens new window)

Detailed release notes for each version are available on GitHub.

# Direct <script> Include

Simply download and include with a script tag. CornerstoneTools will be registered as a global variable.

# CDN

We recommend linking to a specific version number that you can update manually:

<script src="https://cdn.jsdelivr.net/npm/cornerstone-tools@next"></script>

You can browse the source of the NPM package at cdn.jsdelivr.net/npm/cornerstone-tools (opens new window).

CornerstoneTools.js is also available on unpkg (opens new window).

# NPM

NPM is the recommended installation method when building large scale applications. It pairs nicely with module bundlers such as Webpack (opens new window) or Browserify (opens new window).

# latest stable
npm install --save cornerstone-tools

# latest @next (pre-release)
npm install --save cornerstone-tools@next

# Explanation of Different Builds

In the dist/ directory of the NPM package (opens new window) you will find a few different builds for CornerstoneTools.js. Here's an overview of the difference between them:

Type Bundle Available
UMD cornerstone-tools.js Yes
UMD (production) cornerstone-tools.min.js Yes
CommonJS cornerstone-tools.common.js (coming soon)
ES Module cornerstone-tools.esm.js (coming soon)

# Terms

  • UMD (opens new window): UMD builds can be used directly in the browser via a <script> tag. The default file from jsDelivr CDN at https://cdn.jsdelivr.net/npm/cornerstone-tools is the UMD build (cornerstone-tools.js).

  • CommonJS (opens new window): CommonJS builds are intended for use with older bundlers like browserify or webpack 1. The default file for these bundlers (pkg.main) is the CommonJS build (cornerstone-tools.common.js).

  • ES Module (opens new window): ES module builds are intended for use with modern bundlers like webpack 2+ or rollup. The default file for these bundlers (pkg.module) is the ES Module build (cornerstone-tools.esm.js).

# Dev Build

  1. Update dependencies (after each pull):
npm install
  1. Running the build:
npm start
  1. Run the local development server:
npm run start:dev