The Essential SBT tutorial (build tool for Scala)

By William "Scala William" Narmontas

Once you've set up the prerequisites and have, simply follow the instructions below and let me know of any feedback in the feedback form! And if you'd like more content like this, subscribe.

Create a basic empty SBT project

mkdir -p new-project
cd new-project
mkdir -p project
echo 'sbt.version=1.3.13' > project/

Compile the project

sbt compile

Recompile on code change

sbt '~compile'

~ watches for code changes. Press Enter to exit.

Create a source file

Run this command in another terminal window.

mkdir -p src/main/scala/
cat > src/main/scala/SimpleApp.scala << EOF
object SimpleApp extends App {
  println("It works")

Run continuously

Exit the ~compile command by pressing Enter

sbt '~run'

Change source to verify it works

sed -i -e 's/works/definitely works/' \

Add ScalaTest

echo 'libraryDependencies += "org.scalatest" %%' \
       '"scalatest" % "3.2.0" % Test' >> build.sbt

Create a test

mkdir -p src/test/scala/
cat > src/test/scala/SimpleTest.scala << EOF
import org.scalatest.funsuite._
final class SimpleTest extends AnyFunSuite {
  def sum(a: Int, b: Int): Int = ???
  test("sum works for 1 + 2 = 3") {
    assert(sum(1, 2) == 3)

Test continuously

Exit previous ~run command by pressing Enter

sbt '~test'

Make it pass

sed -i -e 's/???/a + b/' src/test/scala/SimpleTest.scala

Use Scala 2.13

echo 'scalaVersion in ThisBuild := "2.13.3"' >> build.sbt

Add the sbt-native-packager plugin

echo 'addSbtPlugin("com.typesafe.sbt" % '\
       '"sbt-native-packager" % "1.7.4")' \
       > project/plugins.sbt

Enable sbt-native-packager

echo 'enablePlugins(JavaAppPackaging)' >> build.sbt

Package the app

sbt 'show dist'

Run packaged app

unzip -o -d /tmp/my-project \

Dockerize your app

eval $(docker-machine env default)
sbt docker:publishLocal

Run the docker image

docker run new-project:0.1.0-SNAPSHOT

Create a submodule

echo 'lazy val fizzbuzz = project' >> build.sbt

Compile the submodule

sbt fizzbuzz/compile

Add ScalaTest to submodule

echo '  .settings(libraryDependencies += "org.scalatest"' \
       '%% "scalatest" % "3.2.0" % Test)' >> build.sbt

Continually test the submodule

sbt '~fizzbuzz/test'

Create a method in the submodule

mkdir -p fizzbuzz/src/main/scala/
cat > fizzbuzz/src/main/scala/Fizz.scala << EOF
object Fizz {
  def buzz(n: Int): String = ???

Create a test in the submodule

mkdir -p fizzbuzz/src/test/scala/
cat > fizzbuzz/src/test/scala/FizzTest.scala << EOF
import org.scalatest.funsuite._
final class FizzTest extends AnyFunSuite {
  test("fizzBuzz for 4 is 4") {
    assert( == "4")

Pass the test

sed -i -e 's/???/s"$n"/' \

Make the app depend on the submodule

echo 'dependsOn(fizzbuzz)' >> build.sbt

Use the submodule in the app

sed -i -e 's/".*"/'\

Run the app with arguments

sbt "run --- 123"

Explicitly name the project

echo 'name := "new-project"' >> build.sbt

Explicitly version the project

echo 'version := "0.2"' >> build.sbt

Add JSoup Java library to main project

echo 'libraryDependencies += "org.jsoup" % "jsoup"' \
       '% "1.13.1"' >> build.sbt

Print all BBC News headlines

mkdir -p src/main/scala/
cat > src/main/scala/SimpleApp.scala << EOF
import org.jsoup.Jsoup
import scala.jdk.CollectionConverters._
object SimpleApp extends App {
  val doc = Jsoup.connect("").get()
  val newsHeadlines = doc
sbt run

For feedback, or to subscribe, go to the Feedback form or the Subscription form.