Skip to content

docs: add Available Plugins section with providers and outputs#1211

Open
ajturner wants to merge 1 commit into
masterfrom
claude/update-koop-adapter-docs-erluU
Open

docs: add Available Plugins section with providers and outputs#1211
ajturner wants to merge 1 commit into
masterfrom
claude/update-koop-adapter-docs-erluU

Conversation

@ajturner
Copy link
Copy Markdown
Contributor

@ajturner ajturner commented Apr 4, 2026

Adds a comprehensive Available Plugins section to README.md listing
all known Koop providers and outputs (officially supported, experimental,
and third-party) with links to their repositories and npm packages,
mirroring the content maintained at koopjs.github.io/docs/available-plugins.

Adds a comprehensive Available Plugins section to README.md listing
all known Koop providers and outputs (officially supported, experimental,
and third-party) with links to their repositories and npm packages,
mirroring the content maintained at koopjs.github.io/docs/available-plugins.

https://claude.ai/code/session_014cdJL2uJmQB9qfPbKQKrow
@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Apr 4, 2026

⚠️ No Changeset found

Latest commit: ef519f9

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds an “Available Plugins” section to the root README to make provider/output plugin discovery easier directly from the repo, aligning the README with the website’s maintained plugin list.

Changes:

  • Updates the introductory plugin-architecture paragraph/linking language.
  • Adds a new “Available Plugins” section with categorized tables for Providers and Outputs (official/experimental/third-party), including GitHub + npm links.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread README.md
Koop is a JavaScript toolkit for making requests to spatial APIs. It exposes a Node.js web server that faciliates on-the-fly transformations of geospatial data from one format to another and delivers it to clients by HTTP. Koop allows you to keep your data in its native format, while making it accessible in any format required. Out-of-the-box, Koop can translates your data into the GeoServices specification supported by ArcGIS products. It's plugin architecture supports output in other formats including vector-tile, WMS, and plain old GeoJSON. Learn more at [https://koopjs.github.io](https://koopjs.github.io).

Koop's plugin-architecture facilates custom deployments specific to your needs. "Provider" plugins to connect to novel data formats and translate to a common format (GeoJSON), while "output" plugins then transform that GeoJSON to other specifications. See a list of plugins already authored and maintained [here](https://koopjs.github.io/docs/available-plugins). If you have a novel datasource or require an as-yet unsupported output format, new plugins can be easily developed and integrated. See the [development section of the Koop docs](https://koopjs.github.io/docs/development).
Koop's plugin-architecture facilates custom deployments specific to your needs. "Provider" plugins to connect to novel data formats and translate to a common format (GeoJSON), while "output" plugins then transform that GeoJSON to other specifications. See a full list of plugins [here](https://koopjs.github.io/docs/available-plugins). If you have a novel datasource or require an as-yet unsupported output format, new plugins can be easily developed and integrated. See the [development section of the Koop docs](https://koopjs.github.io/docs/development).
Copy link

Copilot AI Apr 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Spelling: "facilates" should be "facilitates" (and consider using the same spelling consistently wherever this paragraph appears).

Copilot uses AI. Check for mistakes.
Comment thread README.md
| [GitHub](https://github.com/koopjs/koop-provider-github) | [![npm](https://img.shields.io/npm/v/koop-github.svg?style=flat-square)](https://www.npmjs.com/package/koop-github) |
| [Google Analytics](https://github.com/koopjs/koop-provider-google-analytics) | [![npm](https://img.shields.io/npm/v/@koopjs/provider-google-analytics.svg?style=flat-square)](https://www.npmjs.com/package/@koopjs/provider-google-analytics) |
| [Google Sheets](https://github.com/koopjs/koop-provider-google-sheets) | [![npm](https://img.shields.io/npm/v/@koopjs/provider-google-sheets.svg?style=flat-square)](https://www.npmjs.com/package/@koopjs/provider-google-sheets) |
| [Marklogic](https://github.com/koopjs/koop-provider-marklogic) | [![npm](https://img.shields.io/npm/v/@koopjs/provider-marklogic.svg?style=flat-square)](https://www.npmjs.com/package/@koopjs/provider-marklogic) |
Copy link

Copilot AI Apr 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The provider name appears to be mis-capitalized as "Marklogic"; the product/repo name is typically "MarkLogic". Updating the display text will improve readability and consistency.

Copilot uses AI. Check for mistakes.
Comment thread README.md
| [Google Analytics](https://github.com/koopjs/koop-provider-google-analytics) | [![npm](https://img.shields.io/npm/v/@koopjs/provider-google-analytics.svg?style=flat-square)](https://www.npmjs.com/package/@koopjs/provider-google-analytics) |
| [Google Sheets](https://github.com/koopjs/koop-provider-google-sheets) | [![npm](https://img.shields.io/npm/v/@koopjs/provider-google-sheets.svg?style=flat-square)](https://www.npmjs.com/package/@koopjs/provider-google-sheets) |
| [Marklogic](https://github.com/koopjs/koop-provider-marklogic) | [![npm](https://img.shields.io/npm/v/@koopjs/provider-marklogic.svg?style=flat-square)](https://www.npmjs.com/package/@koopjs/provider-marklogic) |
| [Socrata](https://github.com/koopjs/koop-provider-socrata) | [![npm](https://img.shields.io/npm/v/@koopjs/provider-socrata.svg?style=flat-square)](https://www.npmjs.com/package/koop-socrata) |
Copy link

Copilot AI Apr 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The Socrata npm badge and npm link reference different package names (badge uses "@koopjs/provider-socrata" while the link goes to "koop-socrata"). Please align these so the badge and link point to the same npm package.

Copilot uses AI. Check for mistakes.
Comment thread README.md

### Outputs

Koop uses **outputs** to transform GeoJSON from providers into open specification formats.
Copy link

Copilot AI Apr 4, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This sentence says outputs transform GeoJSON into "open specification formats", but the list includes GeoServices which is not an open specification. Consider rewording to something like "other formats/specifications" so the description matches the entries below.

Suggested change
Koop uses **outputs** to transform GeoJSON from providers into open specification formats.
Koop uses **outputs** to transform GeoJSON from providers into other formats and specifications.

Copilot uses AI. Check for mistakes.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants