diff --git a/README.md b/README.md
index ecb9a20..49f8608 100644
--- a/README.md
+++ b/README.md
@@ -22,38 +22,72 @@ Plinth currently supports GHC `v9.6.x`. Cabal `v3.8+` is recommended.
### 2. Setup your development environment
-- With Nix (**recommended**)
+
+ With Nix (recommended)
- Follow [these instructions](https://github.com/input-output-hk/iogx/blob/main/doc/nix-setup-guide.md) to install and configure nix, *even if you already have it installed*.
+ 1. Follow [these instructions](https://github.com/input-output-hk/iogx/blob/main/doc/nix-setup-guide.md) to install and configure nix, even if you already have it installed.
+
+ 2. Then enter the shell using `nix develop`.
- Then enter the shell using `nix develop`.
+ > NOTE:
+ > The nix files inside this template follow the [`iogx` template](https://github.com/input-output-hk/iogx), but you can delete and replace them with your own. In that case, you might want to include the [`devx` flake](https://github.com/input-output-hk/devx/issues) in your flake inputs as a starting point to supply all the necessary dependencies, making sure to use one of the `-iog` flavors.
- The nix files inside this template follow the [`iogx` template](https://github.com/input-output-hk/iogx), but you can delete and replace them with your own. In that case, you might want to include the [`devx` flake](https://github.com/input-output-hk/devx/issues) in your flake inputs as a starting point to supply all the necessary dependencies, making sure to use one of the `-iog` flavours.
+ > NOTE (for Windows users):
+ > Make sure to have [WSL2](https://learn.microsoft.com/en-us/windows/wsl/install#upgrade-version-from-wsl-1-to-wsl-2) and the [WSL](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl) VSCode extension (if using VSCode) installed before the Nix setup.
+
-- With Docker / Devcontainers / Codespaces
+
+ With Docker / Devcontainer / Codespaces
+
+ - **Docker + Codespaces:** From the [GitHub web page](https://github.com/IntersectMBO/plinth-template), click the top-right green button:
- From the [GitHub web page](https://github.com/IntersectMBO/plinth-template), click the top-right green button:
+ `Use this template -> Open in a codespace`
- `Use this template -> Open in a codespace`
+ - **Docker + Devcontainer:**
+ 1. Make sure to have [VSCode](https://code.visualstudio.com/) installed with the [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) extension.
+ 2. Open this project in VSCode and let it create a local codespace for you (See Dev Containers instructions, if needed).
- Or let VSCode create a local codespace for you when you open this project.
+ - **Stand-alone Docker:** Change the `/path/to/my-project` accordingly and run:
- You can modify your [`devcontainer.json`](./.devcontainer/devcontainer.json) file to customize the container (more info [here](https://github.com/input-output-hk/devx?tab=readme-ov-file#vscode-devcontainer--github-codespace-support)).
-
- Or using your local docker installation (change the `/path/to/my-project` accordingly):
```
- docker run \
- -v /path/to/my-project:/workspaces/my-project \
- -it ghcr.io/input-output-hk/devx-devcontainer:x86_64-linux.ghc96-iog
+ docker run \
+ -v /path/to/my-project:/workspaces/my-project \
+ -it ghcr.io/input-output-hk/devx-devcontainer:x86_64-linux.ghc96-iog
```
- When using this approach, you can ignore/delete/replace the nix files entirely.
+ > NOTE:
+ > You can modify your [`devcontainer.json`](./.devcontainer/devcontainer.json) file to customize the container (more info [here](https://github.com/input-output-hk/devx?tab=readme-ov-file#vscode-devcontainer--github-codespace-support)).
+
+ > NOTE:
+ > When using this approach, you can ignore/delete/replace the Nix files entirely.
+
+ > NOTE (for Windows users):
+ > It is recommended to install and run Docker on your native OS. If you want to run Docker Desktop inside a VM, read through [these notes](https://docs.docker.com/desktop/setup/vm-vdi/).
+
+
+
+ With Demeter
+
+ 1. Create an account in [Demeter](https://demeter.run/).
+
+ 2. Follow [their instructions](https://docs.demeter.run/guides/getting-started) to setup a remote development environment.
+
+ > IMPORTANT:
+ > Demeter uses its own infrastructure and packages. If something is not working correctly, please contact them before creating an issue.
-- With manually-installed dependencies (**not recommended**)
+ > NOTE:
+ > When using this approach, you can ignore/delete/replace the Nix files entirely.
+
+
+ With manually-installed dependencies (not recommended)
+
+
Follow the instructions for [cardano-node](https://developers.cardano.org/docs/get-started/cardano-node/installing-cardano-node/) for a custom setup.
- When using this approach, you can ignore/delete/replace the nix files entirely.
+ > NOTE:
+ > When using this approach, you can ignore/delete/replace the Nix files entirely.
+
### 3. Run the example application