Clarify supabase installation

.claude/settings.local.json

@@ -12,7 +12,10 @@
       "Bash(git restore:*)",
       "Bash(supabase status:*)",
       "Bash(supabase stop:*)",
-      "Bash(supabase start:*)"
+      "Bash(supabase start:*)",
+      "Bash(grep:*)",
+      "Bash(sed:*)",
+      "Bash(find:*)"
     ],
     "deny": []
   },

README.md

@@ -40,6 +40,19 @@ Before starting development, ensure you have the following installed:
    git --version
    ```
 
+4. **PostgreSQL Client** (Required for Linux, particularly Ubuntu)
+   ```bash
+   # Check if installed
+   psql --version
+
+   # If not installed (Ubuntu/Debian)
+   sudo apt-get update && sudo apt-get install postgresql-client
+
+   # If not installed (Fedora/RHEL)
+   sudo dnf install postgresql
+   ```
+   This is needed for the seed scripts to work correctly with Supabase.
+
 ## Development Setup
 
 1. Clone the repository:
@@ -247,6 +260,44 @@ When running locally, you can access:
    - Consider running setup during good internet connectivity
    - Images are cached after first download
 
+6. **First time setup prompts**
+   - When running `supabase start` for the first time, you may be prompted to run `supabase init` first
+   - Run `supabase init` as instructed
+   - When prompted if you want to set up Edge Functions with Deno, answer "No"
+   - After initialization is complete, run `supabase start` again
+
+7. **Docker Architecture Mismatch**
+   - If you see errors like `exec /usr/bin/sh: exec format error`, it means you're trying to run Docker containers built for a different CPU architecture
+
+   **For Apple Silicon (M1/M2) users**: 
+   ```bash
+   # Force pull ARM64 images
+   docker pull --platform=linux/arm64 supabase/postgres:15.1.0
+   docker pull --platform=linux/arm64 supabase/edge-runtime:v1
+   # (add other images as needed)
+   ```
+
+   **For Intel/AMD users**:
+   ```bash
+   # Force pull AMD64 images
+   docker pull --platform=linux/amd64 supabase/postgres:15.1.0
+   docker pull --platform=linux/amd64 supabase/edge-runtime:v1
+   # (add other images as needed)
+   ```
+
+   You may need to specify the platform in your Docker configuration:
+   ```bash
+   # Example adding platform to supabase start
+   DOCKER_DEFAULT_PLATFORM=linux/amd64 supabase start  # For Intel/AMD
+   # or
+   DOCKER_DEFAULT_PLATFORM=linux/arm64 supabase start  # For Apple Silicon
+   ```
+
+   If you continue having issues, try:
+   1. Remove existing containers: `supabase stop && docker system prune -a`
+   2. Set the default platform before starting: `export DOCKER_DEFAULT_PLATFORM=linux/[your-arch]`
+   3. Restart Supabase: `supabase start`
+
 ### Getting Help
 
 If you encounter issues not covered here:

supabase/.gitignore

@@ -18,3 +18,8 @@ prod.env
 .env.keys
 .env.local
 .env.*.local
+
+# Supabase
+.branches
+.temp
+.env