edit on Repl.it

Configuring the run button

A file named .replit can be added to any repl in order to customize the behavior of the run button. Written in toml, a .replit file looks something like:

run = "<run command here>"
language = "<repl language>" # optional

run is a string which will be executed in the shell whenever you hit run. The language helps the IDE understand how to provide features like packaging and code intelligence, this is normally configured for you when you clone from a git repository.

Here is an example of a repl using .replit to print "hello world" instead of running the code:

Configuring a cloned repl

When you clone a repository without a .replit file, we automatically show the visual .replit editor:

visual config editor

This will automatically create the .replit file and make it possible to customize how the repl will run. You can use the shell to run any command and then set the run button once you've decided what it should do. Clicking done will finalize the repl's configuration closing the visual editor. It's always possible to make changes later by visiting the .replit file from the file tree. Adding .replit to a repository makes cloning fast with no configuration necessary.