A headless spreadsheet • A parser and evaluator of Excel formulas
---
HyperFormula is a headless spreadsheet built on top of TypeScript. It is a parser and evaluator of Excel formulas for web applications. You can use it in a browser or as a service, with Node.js as your back-end technology.
- High-speed Excel formula parsing and evaluating
- A library of [380+ built-in functions](https://hyperformula.handsontable.com/guide/built-in-functions.html) available in 16 languages
- Support for [custom functions](https://hyperformula.handsontable.com/guide/custom-functions.html)
- Function syntax compatible with [Microsoft Excel](https://hyperformula.handsontable.com/guide/compatibility-with-microsoft-excel.html) and [Google Sheets](https://hyperformula.handsontable.com/guide/compatibility-with-google-sheets.html)
- [Support for Node.js](https://hyperformula.handsontable.com/guide/server-side-installation.html#install-with-npm-or-yarn)
- Support for [undo/redo](https://hyperformula.handsontable.com/guide/undo-redo.html)
- Support for [CRUD operations](https://hyperformula.handsontable.com/guide/basic-operations.html)
- Support for [clipboard](https://hyperformula.handsontable.com/guide/clipboard-operations.html)
- Support for [named expressions](https://hyperformula.handsontable.com/guide/named-expressions.html)
- Support for [data sorting](https://hyperformula.handsontable.com/guide/sorting-data.html)
- Support for [React](https://hyperformula.handsontable.com/guide/integration-with-react.html), [Angular](https://hyperformula.handsontable.com/guide/integration-with-angular.html), and [Vue.js](https://hyperformula.handsontable.com/guide/integration-with-vue.html)
- Open-source license
- Actively maintained by the team that stands behind [Handsontable - JavaScript Data Grid](https://handsontable.com/)
## Documentation
- [Explainer video](https://www.youtube.com/watch?v=JJXUmACTDdk)
- [Installation](https://hyperformula.handsontable.com/guide/client-side-installation.html)
- [Basic usage](https://hyperformula.handsontable.com/guide/basic-usage.html)
- [Demo with React](https://hyperformula.handsontable.com/guide/integration-with-react.html)
- [Demo with Angular](https://hyperformula.handsontable.com/guide/integration-with-angular.html)
- [Demo with Vue.js](https://hyperformula.handsontable.com/guide/integration-with-vue.html)
- [API Reference](https://hyperformula.handsontable.com/api/)
- [Configuration options](https://hyperformula.handsontable.com/guide/configuration-options.html)
- [List of built-in functions](https://hyperformula.handsontable.com/guide/built-in-functions.html)
- [Key concepts](https://hyperformula.handsontable.com/guide/key-concepts.html)
## Installation and usage
Install the library from [npm](https://www.npmjs.com/package/hyperformula):
```bash
npm install hyperformula
```
Once installed, you can use it like this:
```js
import { HyperFormula } from 'hyperformula';
// define the options
const options = {
licenseKey: 'gpl-v3',
};
// define the data
const data = [['10', '20', '30', '=SUM(A1:C1)']];
// build an instance with defined options and data
const hfInstance = HyperFormula.buildFromArray(data, options);
// call getCellValue to get the calculation results
const mySum = hfInstance.getCellValue({ col: 3, row: 0, sheet: 0 });
// print the result in the browser's console
console.log(mySum);
```
[Run this code in CodeSandbox](https://codesandbox.io/s/github/handsontable/hyperformula-demos/tree/develop/basic-usage)
## What can it be used for?
HyperFormula doesn't assume any existing user interface, making it a great general-purpose library that can be used in various business applications. Here are some examples:
- Spreadsheets
- Business logic builders
- Forms and form builders
- Computation notebooks
- Smart documents
- Educational apps
- Online calculators
## Contributing
Help us build the fastest and most flexible calculation engine for
business web apps. Please read the [Contributing Guide](https://hyperformula.handsontable.com/guide/contributing.html) before making a pull request.
## License
HyperFormula is available under the open source license ([GPLv3](https://github.com/handsontable/hyperformula/blob/master/LICENSE.txt)).
To buy a commercial license, please write to us at sales@handsontable.com
## Copyrights
© 2022 [Handsoncode](https://handsontable.com)