{"id":13591055,"url":"https://gcanti.github.io/fp-ts/","last_synced_at":"2025-04-08T14:32:21.110Z","repository":{"id":37413055,"uuid":"80039696","full_name":"gcanti/fp-ts","owner":"gcanti","description":"Functional programming in TypeScript","archived":false,"fork":false,"pushed_at":"2024-12-10T11:54:42.000Z","size":23131,"stargazers_count":11073,"open_issues_count":192,"forks_count":512,"subscribers_count":99,"default_branch":"master","last_synced_at":"2025-04-08T02:37:07.899Z","etag":null,"topics":["algebraic-data-types","functional-programming","typescript"],"latest_commit_sha":null,"homepage":"https://gcanti.github.io/fp-ts/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/gcanti.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["gcanti"]}},"created_at":"2017-01-25T17:44:09.000Z","updated_at":"2025-04-08T01:38:47.000Z","dependencies_parsed_at":"2022-07-10T22:46:22.553Z","dependency_job_id":"d274fbb9-070f-4d12-8c59-b37bb560fcb3","html_url":"https://github.com/gcanti/fp-ts","commit_stats":{"total_commits":2728,"total_committers":140,"mean_commits":"19.485714285714284","dds":"0.19758064516129037","last_synced_commit":"7e93e7c786e318e13bf7b203755c935675922600"},"previous_names":[],"tags_count":186,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gcanti%2Ffp-ts","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gcanti%2Ffp-ts/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gcanti%2Ffp-ts/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/gcanti%2Ffp-ts/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/gcanti","download_url":"https://codeload.github.com/gcanti/fp-ts/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247860920,"owners_count":21008383,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["algebraic-data-types","functional-programming","typescript"],"created_at":"2024-08-01T16:00:53.145Z","updated_at":"2025-04-08T14:32:21.025Z","avatar_url":"https://github.com/gcanti.png","language":"TypeScript","funding_links":["https://github.com/sponsors/gcanti"],"categories":["Libraries","Uncategorized","Functional Programming"],"sub_categories":["Statically typed","Uncategorized","Reverse Engineer"],"readme":"\u003ch3 align=\"center\"\u003e\n  \u003ca href=\"https://gcanti.github.io/fp-ts/\"\u003e\n    \u003cimg src=\"./docs/fp-ts-logo.png\"\u003e\n  \u003c/a\u003e\n\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\nFunctional programming in TypeScript\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/gcanti/fp-ts/actions\"\u003e\n    \u003cimg src=\"https://github.com/gcanti/fp-ts/actions/workflows/main.yml/badge.svg?branch=master\" alt=\"build status\" height=\"20\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/fp-ts\"\u003e\n    \u003cimg src=\"https://img.shields.io/npm/dm/fp-ts.svg\" alt=\"npm downloads\" height=\"20\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n**📢 Important Announcement: fp-ts is Joining the Effect-TS Ecosystem!**\n\nWe are excited to announce that the `fp-ts` project is officially merging with the Effect-TS ecosystem. This is a significant step forward in the functional programming landscape, bringing together two powerful libraries under one roof. Giulio Canti, the author of `fp-ts`, is being welcomed into the Effect organization, promising an exciting future with enhanced capabilities and support.\n\n**What This Means for New Users:**\n\nEffect-TS can be regarded as the successor to `fp-ts v2` and embodies what would be considered `fp-ts v3`. This merger marks a significant evolution in the library's capabilities, integrating more features and functionalities tailored towards robust, type-safe, and scalable functional programming.\n\nFor more details on this merger and what it entails, please refer to the official [announcement here](https://dev.to/effect/a-bright-future-for-effect-455m). Additionally, you can explore more about Effect-TS and its offerings on our [website and documentation](https://effect.website/).\n\n# Introduction\n\n`fp-ts` is a library for _typed functional programming_ in TypeScript.\n\n`fp-ts` aims to allow developers to use _popular patterns and abstractions_ that are available in most functional languages. For this, it includes the most popular data types, type classes and abstractions such as [Option](https://gcanti.github.io/fp-ts/modules/Option.ts), [Either](https://gcanti.github.io/fp-ts/modules/Either.ts), [IO](https://gcanti.github.io/fp-ts/modules/IO.ts), [Task](https://gcanti.github.io/fp-ts/modules/Task.ts), [Functor](https://gcanti.github.io/fp-ts/modules/Functor.ts), [Applicative](https://gcanti.github.io/fp-ts/modules/Applicative.ts), [Monad](https://gcanti.github.io/fp-ts/modules/Monad.ts) to empower users to write pure FP apps and libraries built atop higher order abstractions.\n\nA distinctive feature of `fp-ts` with respect to other functional libraries is its implementation of [Higher Kinded Types](\u003chttps://en.wikipedia.org/wiki/Kind_(type_theory)\u003e), which TypeScript doesn't support natively.\n\n**Inspired by**\n\n- [Haskell](https://www.haskell.org)\n- [PureScript](https://www.purescript.org)\n- [Scala](https://www.scala-lang.org)\n\n# Sponsors\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd align=\"center\"\u003e\n      \u003ca href=\"https://unsplash.com/\"\u003e\n        \u003cimg src=\"https://avatars.githubusercontent.com/u/9951955?s=200\u0026v=4\" width=\"200px;\" alt=\"Unsplash\" /\u003e\n      \u003c/a\u003e\n      \u003cbr /\u003e\n      \u003cb\u003eUnsplash\u003c/b\u003e\n      \u003cbr /\u003e\n      \u003ca href=\"https://unsplash.com/\"\u003ehttps://unsplash.com/\u003c/a\u003e\n      \u003cbr /\u003e\n      \u003cp width=\"200px\"\u003e\n        The internet’s source for visuals.\u003cbr/\u003e\n        Powered by creators everywhere.\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n# Installation\n\nTo install the stable version:\n\n```\nnpm install fp-ts\n```\n\nMake sure to always have a single version of `fp-ts` installed in your project. Multiple versions are known to cause `tsc` to hang during compilation. You can check the versions currently installed using `npm ls fp-ts` (make sure there's a single version and all the others are marked as `deduped`).\n\n## TypeScript compatibility\n\n**Strictness** – This library is conceived, tested and is supposed to be consumed by TypeScript with the `strict` flag turned on.\n\n| `fp-ts` version | required `typescript` version |\n| --------------- | ----------------------------- |\n| 2.0.x+          | 3.5+                          |\n| 1.15.x+         | 3.1+                          |\n| \u003c= 1.14.4       | 2.8+ (\\*)                     |\n\n(\\*) If you are running `\u003c typescript@3.0.1` you have to polyfill the `unknown` type. You can use [unknown-ts](https://github.com/gcanti/unknown-ts) as a polyfill.\n\n# Documentation\n\n**Disclaimer**. Teaching functional programming is out of scope of this project, so the documentation assumes you already know what FP is.\n\n- [Docs](https://gcanti.github.io/fp-ts)\n- [Learning Resources](https://gcanti.github.io/fp-ts/learning-resources/)\n- [Ecosystem](https://gcanti.github.io/fp-ts/ecosystem/)\n- API Reference\n  - [version 2.x (current)](https://gcanti.github.io/fp-ts/modules/)\n  - [version 1.x](https://github.com/gcanti/fp-ts/tree/1.x/docs/modules/)\n\n# Help\n\nIf you need help with `fp-ts` check out:\n\n- this [Discord server](https://discord.gg/HVWmBBXM8A)\n- the `#fp-ts` channel on [FP slack](https://fpslack.com/).\n\n# Development\n\n- [Code conventions](https://gcanti.github.io/fp-ts/guides/code-conventions)\n\n# License\n\nThe MIT License (MIT)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/gcanti.github.io%2Ffp-ts%2F","html_url":"https://awesome.ecosyste.ms/projects/gcanti.github.io%2Ffp-ts%2F","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/gcanti.github.io%2Ffp-ts%2F/lists"}