diff --git a/.github/ghadocs/branding.svg b/.github/ghadocs/branding.svg
index e0deab6..ec741e6 100644
--- a/.github/ghadocs/branding.svg
+++ b/.github/ghadocs/branding.svg
@@ -2,9 +2,9 @@
By hoverkraftactioncompose
diff --git a/.github/ghadocs/social-preview.svg b/.github/ghadocs/social-preview.svg
new file mode 100644
index 0000000..e0deab6
--- /dev/null
+++ b/.github/ghadocs/social-preview.svg
@@ -0,0 +1,24479 @@
+
+
+
+
diff --git a/README.md b/README.md
index dbebf2b..80f685b 100644
--- a/README.md
+++ b/README.md
@@ -215,3 +215,20 @@ steps:
helloworld2
helloworld3
```
+
+### Example with multiple compose files
+
+Specify multiple compose files to use with the `docker compose` command. This is
+useful when you have a base compose file and additional files for different
+environments or configurations.
+
+```yaml
+steps:
+ # need checkout before using compose-action
+ - uses: actions/checkout@v3
+ - uses: hoverkraft-tech/compose-action@v1.5.1
+ with:
+ compose-file: |
+ ./docker/docker-compose.yml
+ ./docker/docker-compose.ci.yml
+```