Sync from a8e1c0a7402940e0fc5beef669522b315052df1blatest

1 files changed, 21 insertions, 0 deletions

diff --git a/examples/README.md b/examples/README.md
new file mode 100644
index 000000000..1482084d4
--- /dev/null
+++ b/examples/README.md
@@ -0,0 +1,21 @@
+# Astro Examples Library
+
+The easiest way to check out one of these examples on your machine is by running this command in an empty directory:
+
+```sh
+npm create astro@latest -- --template [EXAMPLE_NAME]
+```
+
+## Community Examples
+
+Visit [awesome-astro](https://github.com/one-aalam/awesome-astro) for a full list of community examples. You can use `npm create astro@latest` to check out any community examples:
+
+```sh
+npm create astro@latest -- --template [GITHUB_USER]/[REPO_NAME]
+```
+
+Paths to examples nested inside of a repo are also supported:
+
+```sh
+npm create astro@latest -- --template [GITHUB_USER]/[REPO_NAME]/path/to/example
+```