# Superstruct

TypeScript and JavaScript validation library that checks runtime data against composable struct definitions and reports detailed errors.


Source: https://findsoftware.frbit.cloud/superstruct/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- home: https://docs.superstructjs.org
- repository: https://github.com/ianstormtaylor/superstruct
- docs: https://docs.superstructjs.org
- discord: https://discord.gg/pdHrQBjQ96
- forum: https://github.com/ianstormtaylor/superstruct/discussions

### Identity

- status: active
- maintainer: Ian Storm Taylor
- maintainerType: individual
- parent: unknown
- firstRelease: 2017
- hqCountry: unknown

### Kind

- category: library
- hosting: node, deno, bun
- language: javascript
- runtime: node, deno, bun
- runtimeMin: node 14
- basedOn: unknown

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: not applicable
- renderingModes: not applicable
- installMethod: npm, script tag, jsr

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 2
- latestReleaseDate: 2024-07-06

### Adoption

- githubStargazers: 7124
- packagistDownloads: not applicable
- npmWeeklyDownloads: 9627699
- contributors: 66
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 17088
- dependentPackages: 589

### Sources

- urls: https://api.github.com/repos/ianstormtaylor/superstruct (read 2026-11-16)
- urls: https://api.github.com/repos/ianstormtaylor/superstruct (read 2026-11-16)
- urls: https://raw.githubusercontent.com/ianstormtaylor/superstruct/main/Readme.md (read 2026-11-16)
- maintainer: https://raw.githubusercontent.com/ianstormtaylor/superstruct/main/License.md (read 2026-11-16)
- maintainerType: https://raw.githubusercontent.com/ianstormtaylor/superstruct/main/License.md (read 2026-11-16)
- language: https://api.github.com/repos/ianstormtaylor/superstruct (read 2026-11-16)
- category: https://raw.githubusercontent.com/ianstormtaylor/superstruct/main/Readme.md (read 2026-11-16)
- runtime: https://raw.githubusercontent.com/ianstormtaylor/superstruct/main/Changelog.md (read 2026-11-16)
- runtime: https://api.jsr.io/scopes/superstruct/packages/core (read 2026-11-16)
- runtimeMin: https://raw.githubusercontent.com/ianstormtaylor/superstruct/v2.0.2/package.json (read 2026-11-16)
- installMethod: https://docs.superstructjs.org/guides/01-getting-started (read 2026-11-16)
- installMethod: https://docs.superstructjs.org/guides/01-getting-started (read 2026-11-16)
- installMethod: https://jsr.io/@superstruct/core/meta.json (read 2026-11-16)
- license: https://api.github.com/repos/ianstormtaylor/superstruct (read 2026-11-16)
- currentMajor: https://api.github.com/repos/ianstormtaylor/superstruct/releases (read 2026-11-16)
- latestReleaseDate: https://api.github.com/repos/ianstormtaylor/superstruct/releases (read 2026-11-16)
- firstRelease: https://registry.npmjs.org/superstruct (read 2026-11-16)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/superstruct (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/superstruct (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/superstruct (read 2026-11-16)
- githubStargazers: https://api.github.com/repos/ianstormtaylor/superstruct (read 2026-11-16)
- contributors: https://api.github.com/repos/ianstormtaylor/superstruct/contributors?per_page=1 (read 2026-11-16)

## Notes

Superstruct validates JavaScript and TypeScript data against struct definitions. A struct describes the expected shape of a value, and structs can be composed into larger ones. The README says the library is designed for checking data at runtime, and that it throws or returns detailed errors for the code that receives the data.

The changelog says maintenance has moved to a volunteer team. The README names joi, express-validator, validator.js, yup, ajv and is-my-json-valid as existing validation libraries and gives its reasons for another one.

## Worth knowing

The changelog marks use with an older Node.js line as deprecated.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
