scalacenter / scala3-migrate   0.6.2

Contributors Wanted Apache License 2.0 Website GitHub

A tool to help migrating from Scala 2 to Scala 3

Scala versions: 2.13 2.12
sbt plugins: 1.0

scala3-migrate Latest version Build status

Scala 3 migration plugin for sbt

User documentation

The complete documentation of sbt-scala3-migrate can be found in



  • sbt 1.5 or higher
  • java 8 or 11
  • scala 2.13, preferred 2.13.11


// project/plugins.sbt
addSbtPlugin("ch.epfl.scala" % "sbt-scala3-migrate" % "0.4.6")

Porting the build

To port a build to Scala 3, run the following commands in order, in each project of the build:

  • migrateDepedendencies <project> helps you update the list of libraryDependencies
  • migrateScalacOptions <project> helps you update the list of scalacOptions
  • migrateSyntax <project> fixes a number of syntax incompatibilities between Scala 2.13 and Scala 3
  • migrateTypes <project> tries to make your code compile with Scala 3 by inferring a few types and resolving a few implicits.

Contributions and feedbacks are welcome

The tool is still under development, and we would love to hear from you. Every feedback will help us build a better tool: typos, clearer log messages, better documentation, bug reports, ideas of features, so please open GitHub issues.


This tool is developed by the Scala Center