diff --git a/readme.md b/readme.md
index f559a41fcb8a3ce264b68718283c9e5dc7e27daa..99b4034dab0f4764185f0e83bfd0dc0c4772a713 100644
--- a/readme.md
+++ b/readme.md
@@ -1,8 +1,13 @@
-## Configure and run
+## Configure, install and run
 
-In order to setup the prod and dev environments do:
+### Configuration
+
+Environment variables are taken from .env files as described [here](https://vitejs.dev/guide/env-and-mode.html#env-files)
+
+In order to setup the prod and dev environments for a specific application do:
 
 ```
+cd apps/{app}
 pnpm configure
 ```
 
@@ -10,19 +15,19 @@ This will created two .env files that are ignored by GIT:
 
 ```
 .env.prod.local
-.env.prod.dev
+.env.dev.local
 ```
 
 In order to run the production environment do:
 
 ```
-pnpm run:prod
+pnpm prod
 ```
 
 The development environment do:
 
 ```
-pnpm run:dev
+pnpm dev
 ```
 
 # Structure