# io-ts

TypeScript runtime type system whose codecs decode, encode and type-check values while the program runs.


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

## Record

### Links

- home: https://gcanti.github.io/io-ts/
- repository: https://github.com/gcanti/io-ts
- docs: https://gcanti.github.io/io-ts/docs/modules

### Identity

- status: active
- maintainer: Giulio Canti
- maintainerType: individual
- parent: unknown
- firstRelease: 2017
- hqCountry: unknown

### Kind

- category: library
- hosting: unknown
- language: javascript
- runtime: unknown
- runtimeMin: unknown
- 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

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 2
- latestReleaseDate: 2024-12-10

### Adoption

- githubStargazers: 6812
- packagistDownloads: not applicable
- npmWeeklyDownloads: 3877224
- contributors: 33
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 44496
- dependentPackages: 1416

### Sources

- urls: https://gcanti.github.io/io-ts/ (read 2026-11-16)
- urls: https://api.github.com/repos/gcanti/io-ts (read 2026-11-16)
- urls: https://github.com/gcanti/io-ts/blob/master/README.md (read 2026-11-16)
- maintainer: https://github.com/gcanti/io-ts/blob/master/LICENSE (read 2026-11-16)
- firstRelease: https://api.github.com/repos/gcanti/io-ts/commits/0.0.1 (read 2026-11-16)
- language: https://api.github.com/repos/gcanti/io-ts (read 2026-11-16)
- category: https://gcanti.github.io/io-ts/ (read 2026-11-16)
- license: https://github.com/gcanti/io-ts/blob/master/LICENSE (read 2026-11-16)
- currentMajor: https://api.github.com/repos/gcanti/io-ts/releases (read 2026-11-16)
- latestReleaseDate: https://api.github.com/repos/gcanti/io-ts/releases/latest (read 2026-11-16)
- installMethod: https://github.com/gcanti/io-ts/blob/master/README.md (read 2026-11-16)
- npmWeeklyDownloads: https://api.npmjs.org/downloads/range/2026-11-01:2026-11-07/io-ts (read 2026-11-16)
- githubStargazers: https://api.github.com/repos/gcanti/io-ts (read 2026-11-16)
- contributors: https://api.github.com/repos/gcanti/io-ts/contributors?per_page=1 (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/io-ts (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/npmjs.org/packages/io-ts (read 2026-11-16)

## Notes

io-ts is a TypeScript library for checking data while the program runs, against types the program defines. Each codec describes one type and can decode, encode and type-check values of that type. The stable API is documented in the [module reference](https://gcanti.github.io/io-ts/docs/modules).

The library expects fp-ts to be installed beside it as a peer dependency.

## Worth knowing

The project also ships experimental modules for decoding, encoding, codecs, equality and schemas. The README describes them as backward-incompatible with the stable modules and at risk of changing without notice.

---

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
