diff --git a/README.md b/README.md
index 16e7b5b..971f7f2 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,31 @@
 # dev-shells
+
+A collection of pre-build Nix development shells.
+
+## Available shells
+
+- Go (includes `gopls`).
+- Node (includes `bun`, `eslint`, `pnpm`, `yarn` and `prettier`).
+- PHP 7.4 (includes Composer and Phpactor).
+- PHP 8.1 (includes Composer and Phpactor).
+- PHP 8.2 (includes Composer and Phpactor).
+- PHP 8.3 (includes Composer and Phpactor).
+- PHP 8.4 (includes Composer and Phpactor).
+- Sculpin (includes PHPUnit and Phpstan).
+- Tailwind CSS (uses Tailwind v4 and includes the Tailwind CSS language server).
+
+## Usage
+
+On the command line:
+
+```shell
+nix develop git+https://code.oliverdavies.uk/opdavies/dev-shells#php84
+```
+
+In `.envrc`:
+
+```shell
+use flake "git+https://code.oliverdavies.uk/opdavies/dev-shells#php84"
+```
+
+