diff --git a/example/example.md b/example/example.md
new file mode 100644
index 0000000..29e290f
--- /dev/null
+++ b/example/example.md
@@ -0,0 +1,4 @@
+# Config examples
+
+- [Example for config as pubspec.yaml](pubspec.example.yaml)
+- [Example for config as script_runner.yaml](script_runner.example.yaml)
diff --git a/example/pubspec.example.yaml b/example/pubspec.example.yaml
new file mode 100644
index 0000000..252a6f2
--- /dev/null
+++ b/example/pubspec.example.yaml
@@ -0,0 +1,12 @@
+# add a config to your pubspec.yaml
+script_runner:
+  shell: /bin/zsh
+  scripts:
+    - test: dart test
+    - lint-fix: dart fix --apply
+    - name: build:apk
+      cmd: flutter build apk
+    - name: build:ipa
+      cmd: flutter build ipa
+    - name: build:all
+      cmd: build:apk && build:ipa
diff --git a/example/script_runner.example.yaml b/example/script_runner.example.yaml
new file mode 100644
index 0000000..1d5269a
--- /dev/null
+++ b/example/script_runner.example.yaml
@@ -0,0 +1,12 @@
+# add a config in the script_runner.yaml
+# note! there is no `script_runner` key at the root here:
+shell: /bin/zsh
+scripts:
+  - test: dart test
+  - lint-fix: dart fix --apply
+  - name: build:apk
+    cmd: flutter build apk
+  - name: build:ipa
+    cmd: flutter build ipa
+  - name: build:all
+    cmd: build:apk && build:ipa