diff --git a/vignettes/articles/examples.Rmd b/vignettes/articles/examples.Rmd
new file mode 100644
index 0000000..69b4ac7
--- /dev/null
+++ b/vignettes/articles/examples.Rmd
@@ -0,0 +1,19 @@
+---
+title: "Example projects"
+resource_files:
+  - images/
+---
+
+```{r setup, include = FALSE}
+library(quillt)
+```
+
+
+The examples below illustrate the use of revealjs with various packages and layouts. If you want to learn more about how the dashboards were created each example includes a link to its source code. 
+
+
+```{r, echo=FALSE}
+examples(yml = "examples.yml")
+```
+
+**blogdown** repo contains an example on how to dynamically generate the `example.yml` taking screenshot of the featured examples. See [`example.Rmd`](https://github.com/rstudio/blogdown/blob/master/vignettes/articles/examples.Rmd) in the repository.
diff --git a/vignettes/articles/examples.yml b/vignettes/articles/examples.yml
new file mode 100644
index 0000000..fc13082
--- /dev/null
+++ b/vignettes/articles/examples.yml
@@ -0,0 +1,7 @@
+# - title: Title to use
+#   img: image local or url
+#   href: link to the example
+#   source: link to the source repo
+#   # (optional) allows to filter examples
+#   showcase: true
+#   shiny: true