You can embed an Open in Coder button into a repository's README file to provide developers with a one-click way to start contributing code. It eliminates much of the effort required to set up a development environment, allowing users to begin contributing faster.

When a user clicks on the Open in Coder button, they will be directed to the specified Coder deployment and prompted to login if they don't already have an active session. Coder then builds a workspace based on the image specified. Coder will also clone the repository into the workspace's /home/coder folder. At this point, the user can open the IDE and begin working.

The Embed Button


Create the embedded button's code

Coder can automatically generate the code you need to embed the Open in Coder button.

  1. In the Coder UI, go to Images. Find the image you want to use and click to open.
  2. Underneath the name of the image, click Embed.
  3. Choose the Image Tag and Git Service you want to use, and provide your Git Repository URI.
  4. Once you fill in the required fields, Coder generates the code you need in Markdown or HTML (you can change the button's display text by modifying the Markdown or HTML snippets). Copy the code and paste it into your repository's file.

Create embed button

See an opportunity to improve our docs? Make an edit.