Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
52 lines (36 loc) · 1.82 KB

CONTRIBUTING.md

File metadata and controls

52 lines (36 loc) · 1.82 KB

Development

Development Setup

  1. Clone the repository locally
  2. If you want to change something in DevPod agent code:
    1. Exchange the URL in DefaultAgentDownloadURL with a custom public repository release you have created.
    2. Build devpod via: ./hack/rebuild.sh
    3. Upload test/devpod-linux-amd64 and test/devpod-linux-arm64 to the public repository release assets.
  3. Build devpod via: ./hack/rebuild.sh (asking for sudo password)
  4. Add docker provider via devpod provider add docker
  5. Configure docker provider via devpod use provider docker
  6. Start devpod in vscode with devpod up examples/simple

Build from source

Prerequisites CLI:

Once installed, run CGO_ENABLED=0 go build -ldflags "-s -w" -o devpod-cli

Prerequisites GUI:

To build the app on Linux, you will need the following dependencies:

sudo apt-get install libappindicator3-1 libgdk-pixbuf2.0-0 libbsd0 libxdmcp6 libwmf-0.2-7 libwmf-0.2-7-gtk libgtk-3-0 libwmf-dev libwebkit2gtk-4.0-37 librust-openssl-sys-dev librust-glib-sys-dev
 sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev libayatana-appindicator3-dev librsvg2-dev

Once installed, run

  • cd desktop
  • yarn tauri build --config src-tauri/tauri-dev.conf.json

The application should be in desktop/src-tauri/target/release

Provider

Head over to the docs for an introduction into developing your own providers

Publish your provider

Once you're provider is ready, update

  • community.yaml
  • docs/pages/managing-providers/add-provider.mdx

to get your provider featured both in the documentation and the UI