chore: improve documentation for start and stop

docs/supabase/start.md

@@ -6,4 +6,6 @@ Requires `supabase/config.toml` to be created in your current working directory
 
 All service containers are started by default. You can exclude those not needed by passing in `-x` flag.
 
+> It is recommended to have at least 7GB of RAM to start all services.
+
 Health checks are automatically added to verify the started containers. Use `--ignore-health-check` flag to ignore these errors.

docs/supabase/stop.md

@@ -0,0 +1,7 @@
+## supabase-stop
+
+Stops the Supabase local development stack.
+
+Requires `supabase/config.toml` to be created in your current working directory by running `supabase init`.
+
+All Docker resources are cleaned up by default. Use `--backup` flag to persist your local development data between restarts.

docs/templates/examples.yaml

@@ -60,7 +60,8 @@ supabase-stop:
     name: Backup local database before stopping
     code: supabase stop --backup
     response: |
-      Database exported to supabase/.branches/main
+      Postgres database saved to volume: supabase_db_cli
+      Storage directory saved to volume: supabase_storage_cli
       Stopped supabase local development setup.
 supabase-status:
   - id: basic-usage

internal/stop/stop.go

@@ -50,7 +50,10 @@ func stop(ctx context.Context, backup bool) error {
 		return err
 	}
 	// Remove named volumes
-	if !backup {
+	if backup {
+		fmt.Fprintln(os.Stderr, "Postgres database saved to volume:", utils.DbId)
+		fmt.Fprintln(os.Stderr, "Storage directory saved to volume:", utils.StorageId)
+	} else {
 		// TODO: label named volumes to use VolumesPrune for branch support
 		volumes := []string{utils.DbId, utils.StorageId}
 		utils.WaitAll(volumes, func(name string) {