# @nextgis/ngw-kit

> This library contains a plugin, a set of utilities and adapters that allow you to interact with NextGIS Web

Latest version **4.1.4** (published 2026-11-14) · MIT license · 0 weekly downloads

## Install

```sh
npm install @nextgis/ngw-kit
pnpm add @nextgis/ngw-kit
yarn add @nextgis/ngw-kit
bun add @nextgis/ngw-kit
```

## 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.1.4 |
| Published | 2026-11-14 |
| First published | 2018-08-20 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 10 |
| Unpacked size | 3.1 MB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 31 |
| Author | NextGIS |
| Maintainers | rendrom, maximdubinin, karavanjo |
| Keywords | NextGIS, MAP |

## Links

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

## Dependencies (10)

- [events](https://npm.io/package/events.md) *
- [@nextgis/item](https://npm.io/package/@nextgis/item.md) 4.1.1
- [@types/events](https://npm.io/package/@types/events.md) ^3.0.0
- [@nextgis/utils](https://npm.io/package/@nextgis/utils.md) 4.1.1
- [@nextgis/webmap](https://npm.io/package/@nextgis/webmap.md) 4.1.1
- [@nextgis/qms-kit](https://npm.io/package/@nextgis/qms-kit.md) 4.1.1
- [@nextgis/ngw-connector](https://npm.io/package/@nextgis/ngw-connector.md) 4.1.1
- [@nextgis/properties-filter](https://npm.io/package/@nextgis/properties-filter.md) 4.1.1
- [strict-event-emitter-types](https://npm.io/package/strict-event-emitter-types.md) ^2.0.0
- [@nextgis/cancelable-promise](https://npm.io/package/@nextgis/cancelable-promise.md) 4.0.2

## Recent versions

- 4.1.4 (latest) — 2026-11-14
- 4.0.0-alpha.1 (alpha) — 2026-05-27
- 4.1.1 — 2026-11-13
- 4.1.0 — 2026-11-11
- 4.0.2 — 2026-11-05
- 2.5.5 — 2026-11-02
- 3.1.1 — 2026-11-02
- 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
- … 269 more at https://npm.io/package/@nextgis/ngw-kit/versions

## README

# NgwKit

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

NextGIS Web integration for [`@nextgis/webmap`](../webmap/README.md), including
resource adapters, feature requests, identification, extents, legends, and
other map-related utilities.

Applications using `ngw-leaflet`, `ngw-ol`, or `ngw-maplibre-gl` already use
this package through `NgwMap`. Import `ngw-kit` directly when a utility is not
available as an `NgwMap` convenience method or when assembling a custom map
stack.

Make sure CORS is registered in the [NextGIS Web settings](https://docs.nextgis.com/docs_ngcom/source/CORS.html) to be able to send requests.

## Installation

```bash
npm install @nextgis/ngw-kit
```

## Add a NextGIS Web map to WebMap

```javascript
import { NgwKit } from '@nextgis/ngw-kit';
import { createWebMap } from '@nextgis/webmap';
import LeafletMapAdapter from '@nextgis/leaflet-map-adapter';

import 'leaflet/dist/leaflet.css';

const webMap = await createWebMap({
  target: 'map',
  mapAdapter: new LeafletMapAdapter(),
  starterKits: [
    new NgwKit({
      baseUrl: 'https://demo.nextgis.com',
      resourceId: 3985,
    }),
  ],
});
```

For end-user applications, prefer a ready-to-use `ngw-*` map package instead
of assembling this stack manually.

## Request vector features

```javascript
import { fetchNgwLayerItems } from '@nextgis/ngw-kit';
import NgwConnector from '@nextgis/ngw-connector';

const connector = new NgwConnector({
  baseUrl: 'https://demo.nextgis.com',
});

const items = await fetchNgwLayerItems({
  connector,
  resourceId: 2011,
  offset: 10,
  limit: 300,
  fields: ['name', 'year'],
  orderBy: ['year'],
});
```

The package also exports helpers for resource extents, feature counts,
identification results, field conversion, attachments, legends, and NextGIS
Web layer adapter creation. See the generated API documentation for the full
exported surface.

TypeScript users should generate declarations for the NextGIS Web deployment
used by the application:

```bash
npx @nextgis/ngw-types-loader https://your-ngw-server.com
```

Check out the [API Documentation](https://code-api.nextgis.com/modules/_nextgis_ngw-kit.html)
and the [package architecture guide](../../docs/PACKAGES.md).

## Commercial support

Need to fix a bug or add a feature to `@nextgis/ngw-kit`? 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/ngw-kit · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
