Adjust docs

Author: bcb

docs/index.md

@@ -35,7 +35,7 @@ building.
 It's perfect for:
 
 - 🧱 Building SaaS apps
-- 💻 Running multiple stacks locally
+- 💻 Running multiple stacks (locally and remotely)
 - 📦 Easy database migrations
 - 🔧 Customizing your toolchain
 

docs/psql.md

@@ -4,6 +4,16 @@
 SuperStack makes it easy to run psql inside the container using a helper
 script.
 
+Postgres clients need credentials, one way is to add these to the Compose file:
+
+```yaml title="db/compose.yaml"
+postgres:
+  environment:
+    PGUSER: ${POSTGRES_USER:?}
+    PGPASSWORD: ${POSTGRES_PASSWORD:?}
+    PGDATABASE: app
+```
+
 ## 📟 Open a psql Shell
 
 To connect interactively: