Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.
Latest commit message
Commit time

HSLayers-NG monorepo

This is a monorepo for developing HSLayers-NG Angular library.

Hslayers version Angular version Bootstrap OpenLayers
1 1.7 4.5.3
2 1.7 + 9.1.x (hybrid) >=4.4
3 9.x 4.x
4 10.x 4.x
5 11.x 4.x
6 12.x 4.x
7 12.x 5.x
8 13.x 5.x
9 13.x 5.x ^6.14.1
10 14.x 5.x ^6.14.1, ^7.0.0

It contains source code of libraries which need to be used in an existing Angular based container project:

Source code for ready to use application bundles which can be included in html files through <script> tags:

Configuration for these applications can be provided through global hslayersNgConfig function which exposes an object containing a subset of most common OpenLayers classes through ol parameter. In return the function must provide a JSON object conforming to HsConfig type. See example and config parameter descriptions.

Server components:

  • hslayers-server - a simple cors-anywhere based proxy server which can be used to overcome CORS restrictions, fill API keys for services such as geonames used for search and other tasks. Forking and modifying it to preserve secrets and not expose the proxy for everyone and all kinds of requests will be necessary.

Development server

Run ng serve for a dev server which displays a simple hslayers based map portal with almost no map layers. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files. It's based on hslayers-app project contained in this repository.


Run ng build to build the HSLayers-NG library. The build artifacts will be stored in the dist/ directory. Use the --prod flag for a production build.

Run ng build

Running unit tests

Run ng test to execute the unit tests via Karma.

Running end-to-end tests

Run ng e2e to execute the end-to-end tests via Cypress.