From 6a1b0309d13583619ee1ffa2f24ed92a1f1188e3 Mon Sep 17 00:00:00 2001
From: leex279 <thomas@thirty3.de>
Date: Fri, 22 Aug 2025 20:35:30 +0200
Subject: [PATCH] Merge UX improvements from PR #443

- Update error modal to show default 'docker compose up --build -d' command
- Add better organized note structure with bullet points
- Include profile-specific fallback example for existing users
- Update README Quick Start to show default command first
- Maintain backward compatibility guidance for profile users
---
 README.md                                           |  2 ++
 .../src/components/BackendStartupError.tsx          | 13 +++++++++----
 2 files changed, 11 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index a641f0e..9542bb7 100644
--- a/README.md
+++ b/README.md
@@ -77,6 +77,8 @@ This new vision for Archon replaces the old one (the agenteer). Archon used to b
    **Full Docker Mode (Recommended for Normal Archon Usage)**
 
    ```bash
+   docker compose up --build -d
+   # or, to match a previously used explicit profile:
    docker compose --profile full up --build -d
    # or
    make dev-docker # (Alternative: Requires make installed )
diff --git a/archon-ui-main/src/components/BackendStartupError.tsx b/archon-ui-main/src/components/BackendStartupError.tsx
index 17f80c2..8959bfc 100644
--- a/archon-ui-main/src/components/BackendStartupError.tsx
+++ b/archon-ui-main/src/components/BackendStartupError.tsx
@@ -49,11 +49,16 @@ export const BackendStartupError: React.FC = () => {
                   After fixing the issue in your .env file, recreate the Docker containers:
                 </p>
                 <code className="block mt-2 p-2 bg-black/70 rounded text-red-100 font-mono text-sm">
-                  docker compose down && docker compose --profile full up -d
+                  docker compose down && docker compose up --build -d
                 </code>
-                <p className="text-red-300 text-xs mt-2">
-                  Note: Use 'down' and 'up', not 'restart' - containers need to be recreated to load new environment variables. Replace the profile value (full) if needed.
-                </p>
+                <div className="text-red-300 text-xs mt-2">
+                  <p>Note:</p>
+                  <p>• Use 'down' and 'up' (not 'restart') so new env vars are picked up.</p>
+                  <p>• If you originally started with a specific profile (backend, frontend, or full),</p>
+                  <p>&nbsp;&nbsp;run the same profile again:</p>
+                  <br />
+                  <code className="bg-black/50 px-1 rounded">docker compose --profile full up --build -d</code>
+                </div>
               </div>
 
               <div className="flex justify-center pt-4">