Contributing with GitHub Codespaces

    GitHub Codespaces are the easiest way to get up and running for contributing to a Dapr repo. In as little as a single click, you can have an environment with all of the prerequisites ready to go in your browser.

    • Click and Run: Get a dedicated and sandboxed environment with all of the required frameworks and packages ready to go.
    • Usage-based Billing: Only pay for the time you spend developing in the Codespace. Environments are spun down automatically when not in use.
    • Portable: Run in your browser or in Visual Studio Code

    Developing Dapr Components in a Codespace

    Developing a new Dapr component requires working with both the components-contrib and repos together under the tree for testing purposes. To facilitate this, the /go/src/github.com/dapr folder in the components-contrib Codespace will already be set up with your fork of components-contrib, and a clone of the dapr repo as described in the component development documentation. A few things to note in this configuration:

    • The components-contrib and dapr repos only define Codespaces for the Linux amd64 environment at the moment.
    • The folder is a soft link to Codespace’s default /workspace/components-contrib folder, so changes in one will be automatically reflected in the other.
    • Since the folder uses a clone of the official dapr repo rather than a fork, you will not be able to make a pull request from changes made in that folder directly. You can use the dapr Codespace separately for that PR, or if you would like to use the same Codespace for the dapr changes as well, you should remap the dapr repo origin to your fork in the components-contrib Codespace. For example, to use a dapr fork under my-git-alias: