Typesafe Activator

Documentation

Download & Get Started

Create An Application Using the Web Interface

Once installed you can run Typesafe Activator's web interface either from a file browser or from a command line. From a file browser, double-click on either the activator (for Mac & Linux) or activator.bat (for Windows) script. From a command line, run the script with a ui argument:

activator ui

This will start a local web server that can be reached at: http://localhost:8888

Inside your browser you can now create a new application based on one of the 96 templates. Both Typesafe and the community have contributed templates to Activator. Learn more about how to contribute your own template.

Once you have selected a template and optionally entered a name and location, select the "Create" button to have your new application created.

Create An Application Using the Command Line

If you'd prefer to create a new application from a command line, run:

activator new

You will then be prompted to enter an application name and the template name to start with. The output will look similar to this:

Enter an application name
> hello-scala

The new application will be created in /home/typesafe/Desktop/hello-scala

Enter a template name, or hit tab to see a list of possible templates
> 
hello-akka        hello-play        hello-scala       reactive-stocks   
> hello-scala
OK, application "hello-scala" is being created using the "hello-scala" template.

To run "hello-scala" from the command-line, run:
/home/typesafe/Desktop/hello-scala/activator run

To run the test for "hello-scala" from the command-line, run:
/home/typesafe/Desktop/hello-scala/activator test

To run the Activator UI for "hello-scala" from the command-line, run:
/home/typesafe/Desktop/hello-scala/activator ui

Open an Existing Application Using the Web Interface

Existing applications can be opened by running activator or activator.bat from a project's root directory. If the Activator UI is already running, then open http://localhost:8888/home in your browser and either select a known existing app, or folder icon next to Open existing app to browse to an existing app.

Working with Applications in the Activator UI

Once you have created or opened an application in the Activator UI you can:

  • Read the Tutorial
  • Browse & edit the code (select Code)
  • Open the code in IntelliJ IDEA or Eclipse (select Code then the gear icon)
  • See the compile output (select Compile)
  • Test the application (select Test)
  • Run the application (select Run)
  • Inspect the application (select Inspect)
  • Create a new application or open an existing one (select the application's name in the top left then select Manage Applications)

Whenever you save changes to a source file in the application, the changes will be recompiled, the application will be re-run, and the tests will be re-run.

Re-Launching Activator

To make it easy to re-launch Activator (either from a file browser or command line) after you've shut it down, you can either launch it the same way you did the first time, or you can launch it from the new application's root directory. If you launch it from the application's root directory then the UI will automatically launch with the application open. Otherwise you will need to open the existing application. To make it easy for others to launch Activator for your application you can put the activator, activator.bat, and activator-launch-VERSION.jar files in your SCM.

Behind a proxy

When running activator behind a proxy, some additional configuration is needed. First, we need to open the activator configuration file, found in your user home directory under ~/.activator/activatorconfig.txt. Note that this file may not exist. Once you have the file open and ready to configure, we need to make sure it has the following lines:

# This are the proxy settings we use for activator
-Dhttp.proxyHost=PUT YOUR PROXY HOST HERE
-Dhttp.proxyPort=PUT YOUR PROXY PORT HERE
# Here we configure the hosts which should not go through the proxy.  You should include your private network, if applicable.
-Dhttp.nonProxyHosts="localhost|127.0.0.1"
# These are commented out, but if you need to use authentication for your proxy, please fill these out.
#-Dhttp.proxyUser=PUT YOUR PROXY USER HERE
#-Dhttp.proxyPassword=PUT YOUR PROXY PASSWORD HERE

Increasing the Timeout

By default Activator has a 10 second timeout to fetch the latest templates and check for a new version. On slow internet connections it might be necessary to increate that timeout. You can do that from the command line by including a -Dactivator.timeout=30s parameter or by putting that parameter into your ~/.activator/activatorconfig.txt file.

Increase Activator Logging Verbosity

If you are having problems with Activator you can try to increase the logging verbosity from the command line by including a -Dakka.loglevel=DEBUG parameter or by putting that parameter into your ~/.activator/activatorconfig.txt file.

Resources

Under the Covers

Activator applications use sbt under the covers. This means that anything you can do in sbt you can do with an application in Activator. For instance, sbt plugins can easily be added to applications in Activator just like they would normally be added.

License

Typesafe Activator is licensed under Apache License, Version 2.0; including the command-line Launcher, HTML & JavaScript UI, Play Framework based server, and all tests included in the project.
The templates available in Typesafe Activator are licensed individually by the owner. Refer to template source code or owner for license information.