# Client-side installation

# Install with npm or Yarn

You can install the latest version of HyperFormula with popular packaging managers. Navigate to your project folder and run the following command:


$ npm install hyperformula


$ yarn add hyperformula

The package will be added to your package.json file and installed to the ./node_modules directory.

Then you can import it into your file like this:

import { HyperFormula } from 'hyperformula';

// your code

# Use CDN

Alternatively, you can load HyperFormula from jsDelivr (opens new window) and embed the URL directly in the <script> tag. This way you will make it accessible in the project as a HyperFormula global variable.

Full build will include all the required dependencies:

<script src="https://cdn.jsdelivr.net/npm/hyperformula/dist/hyperformula.full.min.js"></script>

Or you may load just a minimal build and add the dependencies on your own:

<script src="https://cdn.jsdelivr.net/npm/chevrotain@6/lib/chevrotain.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/tiny-emitter@2/dist/tinyemitter.min.js"></script>
<script src="https://cdn.jsdelivr.net/npm/hyperformula/dist/hyperformula.min.js"></script>

A useful option when you already use some of them and there is no need to duplicate the dependencies. You can read more about the dependencies of HyperFormula on a dedicated Dependencies page.

# Clone from GitHub

If you choose to clone the project or download it from GitHub you will need to build it prior to usage. Check the building section for a full list of commands and their descriptions.

# Clone with HTTPS

git clone https://github.com/handsontable/hyperformula.git

# Clone with SSH

git clone git@github.com:handsontable/hyperformula.git

# Download from GitHub

You can download all resources as a ZIP archive directly from the GitHub repository (opens new window). Then, you can use one of the above-mentioned methods to install the library.