diff --git a/README.md b/README.md
index 2981ad7..f04a5b3 100644
--- a/README.md
+++ b/README.md
@@ -10,3 +10,5 @@ From the Julia REPL, type `]` to enter the Pkg REPL mode and run
 ```julia
 pkg> add SpinShuttling
 ```
+
+![two_spin_shuttling](./docs/src/assets/animation2spins.gif)
\ No newline at end of file
diff --git a/docs/src/assets/animation.gif b/docs/src/assets/animation.gif
new file mode 100644
index 0000000..9ed06cb
Binary files /dev/null and b/docs/src/assets/animation.gif differ
diff --git a/docs/src/assets/animation2spins.gif b/docs/src/assets/animation2spins.gif
new file mode 100644
index 0000000..4976fe2
Binary files /dev/null and b/docs/src/assets/animation2spins.gif differ