# @nextgis/qms-core

> NextGIS QMS client for TMS and WMS services

Latest version **4.0.2** (published 2026-11-05) · MIT license · 0 weekly downloads

## Install

```sh
npm install @nextgis/qms-core
pnpm add @nextgis/qms-core
yarn add @nextgis/qms-core
bun add @nextgis/qms-core
```

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 4.0.2 |
| Published | 2026-11-05 |
| First published | 2026-08-18 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 703.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 31 |
| Author | NextGIS |
| Maintainers | rendrom, maximdubinin, karavanjo |
| Keywords | NextGIS, QMS, MAP |

## Links

- npm: https://www.npmjs.com/package/@nextgis/qms-core
- Repository: https://github.com/nextgis/nextgis_frontend
- Homepage: https://github.com/nextgis/nextgis_frontend/tree/master/packages/qms-core#readme
- Issues: https://github.com/nextgis/nextgis_frontend/issues
- npm.io page: https://npm.io/package/@nextgis/qms-core

## Recent versions

- 4.0.2 (latest) — 2026-11-05
- 4.0.0-alpha.4 (alpha) — 2026-08-18
- 4.0.1 — 2026-11-02
- 4.0.0 — 2026-08-30
- 4.0.0-rc.2 — 2026-08-30
- 4.0.0-rc.1 — 2026-08-29
- 4.0.0-rc.0 — 2026-08-27
- 4.0.0-alpha.8 — 2026-08-25
- 4.0.0-alpha.6 — 2026-08-24
- 4.0.0-alpha.5 — 2026-08-21

## README

# QMS Core

![version](https://img.shields.io/npm/v/@nextgis/qms-core)

Map-independent client, catalog, and shared control UI for
[NextGIS QMS](https://qms.nextgis.com/). Use an engine-specific package instead
when adding QMS services directly to a Leaflet, OpenLayers, or MapLibre GL JS
map.

## Installation

```bash
npm install @nextgis/qms-core
```

```javascript
import { QmsClient } from '@nextgis/qms-core';

const qms = new QmsClient();
const layer = await qms.getLayer(448);
```

To use a custom QMS server, set the global URL before creating a client:

```javascript
QmsClient.url = 'http://localhost:8000';
```

Get a service extent as `[west, south, east, north]` in EPSG:4326:

```javascript
import { getQmsServiceExtent } from '@nextgis/qms-core';

const extent = await getQmsServiceExtent(4646);
```

Search for services by name or description:

```javascript
const services = await qms.searchServices('OpenStreetMap', { type: 'tms' });
```

The bundled catalog is generated from
[quickmapservices_contrib](https://github.com/nextgis/quickmapservices_contrib).
The catalog is generated automatically before the package build. To
update it manually, run:

```bash
yarn workspace @nextgis/qms-core catalog:update
```

`QmsControlElement` provides the shared search and catalog UI used by the map
adapters. Search and catalog can be enabled independently. Its
`nextgis-qms-control` classes and CSS custom properties can be overridden by
the host interface.

Built-in control languages are `en`, `de`, `es`, `fr`, `it`, `pt`, and `ru`.
Select one with `lang` (`en` by default):

```javascript
import { QmsControlElement } from '@nextgis/qms-core';

const control = new QmsControlElement({
  lang: 'ru',
  messages: {
    title: 'Подложки',
  },
});
```

`messages` can override search panel labels.

See the [API Documentation](https://code-api.nextgis.com/modules/_nextgis_qms-core.html)
and the [package architecture guide](../../docs/PACKAGES.md).

## Commercial support

Need to fix a bug or add a feature to NextGIS Frontend? We provide custom development and support for this software. [Contact us](http://nextgis.com/contact/) to discuss options!

[![http://nextgis.com](https://nextgis.com/img/nextgis.png)](http://nextgis.com)

---
_Source: https://npm.io/package/@nextgis/qms-core · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
