Codex/stable surface hardening

.env.example

@@ -4,6 +4,7 @@ THERMOANALYZER_LIBRARY_CLOUD_URL=http://127.0.0.1:8000
 THERMOANALYZER_LIBRARY_CLOUD_ENABLED=true
 THERMOANALYZER_LIBRARY_DEV_CLOUD_AUTH=true
 THERMOANALYZER_LIBRARY_ALLOW_FULL_PROVIDER_SYNC=false
+MATERIALSCOPE_ENABLE_PREVIEW_MODULES=false
 MATERIALSCOPE_OPENALEX_EMAIL=
 MATERIALSCOPE_OPENALEX_API_KEY=
 

README.md

@@ -154,6 +154,7 @@ This repo includes a production `Dockerfile` for Coolify-style deployments.
 The container starts:
 - the FastAPI backend on `127.0.0.1:8000`
 - the Streamlit UI on `0.0.0.0:8501`
+- Streamlit waits for backend health before the UI process starts
 
 For web deployment:
 - deploy with `Dockerfile`
@@ -166,10 +167,19 @@ Recommended runtime environment variables:
 THERMOANALYZER_LIBRARY_CLOUD_URL=http://127.0.0.1:8000
 THERMOANALYZER_LIBRARY_CLOUD_ENABLED=true
 THERMOANALYZER_LIBRARY_ALLOW_FULL_PROVIDER_SYNC=false
+MATERIALSCOPE_ENABLE_PREVIEW_MODULES=false
 MATERIALSCOPE_OPENALEX_EMAIL=
 MATERIALSCOPE_OPENALEX_API_KEY=
 ```
 
+Set `MATERIALSCOPE_ENABLE_PREVIEW_MODULES=true` only in builds where kinetics and deconvolution should be exposed.
+
+Optional runtime tuning:
+
+```dotenv
+BACKEND_STARTUP_TIMEOUT_SECONDS=30
+```
+
 ---
 
 ## Local Cloud-Library Development