Herd Manager for VS Code

Manage Laravel Herd site configuration directly from VS Code.

JSG Herd Manager integrates Laravel Herd into VS Code: configure the project's herd.yml, link/unlink the site, enable HTTPS and open it in the browser without leaving the editor. It is the VS Code port of the Herd Manager JetBrains plugin.

Features

• Auto-detection — finds Laravel Herd on Windows, macOS and Linux, plus its installed PHP versions and TLD
• herd.yml configuration — site name, PHP version and HTTPS from a guided wizard or by clicking the values in the Herd view
• Link / unlink — herd link (followed by herd secure when HTTPS is on) and herd unlink
• Open in browser — opens https://<site>.<tld>
• Keeps .env in sync — APP_URL is updated when the configuration is saved
• Status bar item — linked / not linked at a glance; click to open the Herd view
• Startup hint — offers to configure or link the project when it isn't yet
• Reactive — the view refreshes when herd.yml changes on disk

Requirements

• VS Code 1.85+
• Laravel Herd installed
• A PHP project folder (the extension activates when the workspace has herd.yml, artisan or composer.json)

Usage

Open the Herd view in the Activity Bar:

The view toolbar has Link Site / Unlink Site, Open in Browser, Configure Site and Refresh.

Commands

herd.yml

name: my-project
php: '8.4'
secured: true
aliases: {}
services: {}
integrations:
    forge: {}

Development

pnpm install
pnpm run watch   # F5 launches an Extension Development Host
pnpm test        # unit tests (node:test, no VS Code instance needed)
pnpm run lint
pnpm dlx @vscode/vsce package --no-dependencies   # build a .vsix

License

MIT

Author

Jefferson Goncalves — GitHub