From 867bd3297fe956303aa3b15c95a0b22e25483613 Mon Sep 17 00:00:00 2001
From: Herman Snevajs <herman.snevajs@lutraconsulting.co.uk>
Date: Tue, 29 Sep 2026 13:49:09 +0200
Subject: [PATCH] fix & simplify dev setup guide

---
 .gitignore     |  1 +
 development.md | 19 ++++++++++++++++---
 2 files changed, 17 insertions(+), 3 deletions(-)

diff --git a/.gitignore b/.gitignore
index 486ef6cc..285ccd36 100644
--- a/.gitignore
+++ b/.gitignore
@@ -37,5 +37,6 @@ docker-compose.local.yml
 *.pem
 *.crt
 
+CLAUDE.md
 # Local Claude Code skills
 .claude/commands/
diff --git a/development.md b/development.md
index 87a42a68..18bf11b5 100644
--- a/development.md
+++ b/development.md
@@ -21,10 +21,23 @@ $ cd server
 # Install dependencies with pipenv
 # Note: You can append --three flag in older versions of pipenv (< 3.16.8 2023-02-04)
 $ pipenv install --dev
-$ pipenv install --categories="telemetry
+$ pipenv install --categories telemetry
 $ pipenv run pre-commit install
 $ pipenv run pre-commit run --all-files
-$ export FLASK_APP=application; export COLLECT_STATISTICS=0
+# pipenv loads server/.env automatically; secrets and salts have no defaults
+$ cat > .env <<EOF
+FLASK_APP=application
+COLLECT_STATISTICS=0
+SECRET_KEY=$(python3 -c 'import secrets;print(secrets.token_hex(32))')
+SECURITY_PASSWORD_SALT=$(python3 -c 'import secrets;print(secrets.token_hex(16))')
+SECURITY_EMAIL_SALT=$(python3 -c 'import secrets;print(secrets.token_hex(16))')
+SECURITY_BEARER_SALT=$(python3 -c 'import secrets;print(secrets.token_hex(16))')
+SECURITY_UNLOCK_SALT=$(python3 -c 'import secrets;print(secrets.token_hex(16))')
+MAIL_DEFAULT_SENDER=dev@localhost
+MERGIN_BASE_URL=http://localhost:8080
+EOF
+# folder for project files (LOCAL_PROJECTS default)
+$ mkdir -p ../projects
 $ pipenv run flask init-db
 # create admin user
 $ pipenv run flask user create admin topsecret --is-admin --email admin@example.com
@@ -36,7 +49,7 @@ $ pipenv run flask run # run dev server on port 5000
 
 ### Web applications
 
-Before installing the web applications, make sure you have Node.js installed in a supported version. The applications require Node.js version **18 or higher**.
+Before installing the web applications, make sure you have Node.js installed in a supported version. The applications require Node.js version **22 or higher**.
 
 ```shell
 $ cd web-app