Zed Docs

docs/app/.envrc

@@ -1,3 +1,5 @@
+#!/bin/bash
+
 # Automatically sets up your devbox environment whenever you cd into this
 # directory via our direnv integration:
 

docs/app/docs/ide_configuration/zed.md

@@ -0,0 +1,41 @@
+---
+title: Zed Editor
+---
+
+[Zed](https://zed.dev/) is a fast, open source code editor designed for collaboration and AI support, that is available for macOS and Linux. Zed has support for loading environments directly from Direnv's `.envrc` files, meaning you can easily use Zed w/ Devbox via our [direnv integration](/devbox/ide_configuration/direnv).
+
+## Setting up your Project for Zed
+
+1. Make sure that you have direnv installed on your host. To use direnv across all your projects, we recommend installing it with [devbox global](/devbox/devbox_global) using `devbox global add direnv`. You can also follow [this guide](https://direnv.net/#basic-installation) to configure direnv for your system
+
+2. Generate a `.envrc` file for your project by running `devbox generate direnv` in your project's root directory (the same directory with your `devbox.json` file.
+
+3. You can now open your project in Zed and it will automatically load your Devbox shell environment variables from the `.envrc` file.
+
+## Troubleshooting your Zed Setup
+
+If you are having trouble getting Zed's LSP to detect your Devbox environment, try the following steps:
+
+1. Make sure you are up to date with the latest version of Zed. You can check for updates by going to `Zed > Check for Updates` in the Zed menu.
+
+2. You may need to explicitly tell your LSP to use the binaries in your $PATH variable. To do this, add the following to the `~/.config/zed/config.json` file:
+
+```json
+{
+  ...
+  "lsp": {
+    "<lsp-name>": {
+      "binary": {"path_lookup": true}
+    }
+  },
+  ...
+}
+```
+
+3. If you have a version of the binary/language server installed on your host machine, Zed's default behavior for loading direnv directly may cause conflicts with the packages installed via Devbox. To fix this, add the following to your `~/.config/zed/config.json` file:
+
+```json
+{
+  "load_direnv": "shell_hook"
+}
+```

docs/app/package.json

@@ -2,7 +2,7 @@
     "name": "devbox",
     "version": "0.0.0",
     "private": true,
-    "packageManager": "pnpm@8.15.9",
+    "packageManager": "pnpm@9.12.1",
     "scripts": {
         "docusaurus": "docusaurus",
         "start": "docusaurus start",