Running Repla Server with an existing web app. These instructions assume you've already run the Repla app once.

  1. Navigate to your web app in the terminal.
  2. Pass the command you use to run your web server as the first parameter to the repla server command-line utility. For example, the default command to run a Ruby on Rails project is bin/rails server, so you'd run repla server "bin/rails server".
  3. Repla Server will try to guess the URL of the web server, and navigate to it automatically, by looking at the output of the server command. But, if the URL of the server can't be inferred by the terminal output, you might have to give the command a little bit more information using one of the command-line flags. For example, the default Express project doesn't output the URL of the local web server, so adding -p 3000 is required so Repla Server knows to navigate to localhost on port 3000.
  4. Add the -f flag to refresh any time a file changes on disk, or -r <refresh string> to refresh when a specific string appears in terminal output.
  5. After your web app is running with the configuration options you want, you can hit ⌘S (or select "File" -> "Save" from the menu) to save it as a .replarun file
  6. To open your web app again later, open the .replarun file.


The screenshots page includes example commands for running various platforms' default projects.

Command-Line Flags

The repla server command supports the following command-line flags. For example, to add a port number to the earlier Ruby on Rails command, use repla server "bin/rails server" -p 8080.