bench/src/main/scala/cats/benchFix compile error in benchmark.Erik Osheim8 months ago
core/src/main/scala/catsadd init and size methods to NonEmptyList (#1628)João Ferreira1 day ago
docs/src/mainRename Inject to InjectK (#1596)Andy Scott7 days ago
free/srcRename Inject to InjectK (#1596)Andy Scott7 days ago
js/srcImprove test coverage (#1591)Peter Neyens21 days ago
jvm/src/test/scala/cats/testsImprove test coverage (#1591)Peter Neyens21 days ago
kernel-laws/srcAvoid deprecated PropertyCheckConfigTravis Brown6 months ago
kernel/src/main/scala/cats/kernelFix mistake in documentation of Group.remove (#1566)LukaJCB1 month ago
laws/srcMove arbitrary instance of StateT to laws (#1584)Kai(luo) Wang9 days ago
macros/src/main/scala/cats/macrosAdd lift to FunctionK (#1352)Andy7 months ago
projectEnable SI-2712 fix in cats / Remove unapply machinery (#1583)Kai(luo) Wang7 days ago
scriptsenable mima check (#1483)Sam Ritchie4 months ago
tests/src/test/scala/cats/testsadd init and size methods to NonEmptyList (#1628)João Ferreira1 day ago
.gitignoreBumps sbt-microsites version. It brings auto-docs menu.Juan Pedro Moreno6 months ago
.jvmoptstry travis trusty beta with higher memoryKailuo Wang7 months ago
.travis.ymlUpdate .travis.ymlKai(luo) Wang4 months ago
AUTHORS.mdUpdate AUTHORS file with changes for 0.8.1 and 0.9.0 (#1523)Peter Neyens3 months ago
CHANGES.mdAdd new doc PR, minor fixes, update dateTravis Brown3 months ago
CONTRIBUTING.mdfix ref to non-existent dir in contributing (#1547)John Sullivan1 month ago
COPYINGadd basic licenseErik Osheim2 years ago
DESIGN.mdInclude kernel in modules docCody Allen10 months ago
PROCESS.mdfix typoKai(luo) Wang5 months ago
README.mdrestore the alphabetical order of maintainers list.Kai(luo) Wang29 days ago
build.sbtUpdate Discipline and ScalaTestpeterneyens6 days ago
scalastyle-config.xmlAdd scalastyle rule for single space after ifCody Allen10 months ago
version.sbt0 9 0 post release (#1524)Adelbert Chang3 months ago


Build Status Workflow Chat Latest version Scala.js


Cats is a library which provides abstractions for functional programming in Scala.

The name is a playful shortening of the word category.

cats image


Scala supports both object-oriented and functional programming, and this is reflected in the hybrid approach of the standard library. Cats augments the standard library with tools that further enable functional programming such as Validated, Monad, and Traverse. A broader goal of Cats is to provide a foundation for an ecosystem of pure, typeful libraries.

Getting Started

Cats is currently available for Scala 2.10, 2.11 and 2.12, and Scala.js.

To get started with SBT, simply add the following to your build.sbt file:

libraryDependencies += "org.typelevel" %% "cats" % "0.9.0"

This will pull in all of Cats' modules. If you only require some functionality, you can pick-and-choose from amongst these modules (used in place of "cats"):

  • cats-macros: Macros used by Cats syntax (required).
  • cats-kernel: Small set of basic type classes (required).
  • cats-core: Most core type classes and functionality (required).
  • cats-laws: Laws for testing type class instances.
  • cats-free: Free structures such as the free monad, and supporting type classes.

Release notes for Cats are available in

Cats is still under active development. While we don't anticipate any major redesigns, changes that are neither source nor binary compatible are to be expected in upcoming cats releases. We will update the minor version of cats accordingly for such changes. Once cats 1.0 is released (ETA: Q3 2016), there will be an increased focus on making changes in compatible ways.


Cats information and documentation is available on the website.

We also have a Scaladoc index.

Finally, we have a list of frequently-asked questions.

Our goal is to have clear and comprehensive documentation. If you notice problems, omissions, or errors, please let us know.

How can I contribute to Cats?

We welcome contributions to Cats and would love for you to help build Cats. See our contributor guide for more information about how you can get involed.


Discussion around Cats is currently happening in the Gitter channel as well as on Github issue and PR pages. You can get an overview of who is working on what via

People are expected to follow the Typelevel Code of Conduct when discussing Cats on the Github page, Gitter channel, or other venues.

We hope that our community will be respectful, helpful, and kind. If you find yourself embroiled in a situation that becomes heated, or that fails to live up to our expectations, you should disengage and contact one of the project maintainers in private. We hope to avoid letting minor aggressions and misunderstandings escalate into larger problems.

If you are being harassed, please contact one of us immediately so that we can support you.


The current maintainers (people who can merge pull requests) are:

We are currently following a practice of requiring at least two sign-offs to merge PRs (and for large or contentious issues we may wait for more). For typos or other small fixes to documentation we relax this to a single sign-off.

Related Projects

There are many projects that integrate with Cats:

  • Circe: pure functional JSON library.
  • Dogs: pure functional collections and data structures.
  • Fetch: efficient data access to heterogeneous data sources.
  • Frameless: Expressive types for Spark.
  • FS2: compositional, streaming I/O library
  • Kittens: automatically derived type class instances.
  • Monix: high-performance library for composing asynchronous and event-based programs.
  • eff: functional effects and effect handlers (alternative to monad transformers).

Copyright and License

All code is available to you under the MIT license, available at and also in the COPYING file. The design is informed by many other projects, in particular Scalaz.

Copyright the maintainers, 2015-2016.

About FluentSend Feedback