From 7495f151b4b674a01fb7005c717069b80145c02f Mon Sep 17 00:00:00 2001
From: Cee Chen <549407+cee-chen@users.noreply.github.com>
Date: Tue, 25 Jul 2023 10:11:15 -0700
Subject: [PATCH] [Wiki] Document puppeteer error on M1/M2 machines (#6989)

Co-authored-by: Trevor Pierce <1Copenut@users.noreply.github.com>
---
 wiki/contributing-to-eui/running-eui-locally.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/wiki/contributing-to-eui/running-eui-locally.md b/wiki/contributing-to-eui/running-eui-locally.md
index 60adf41d67e..08022d3f9e8 100644
--- a/wiki/contributing-to-eui/running-eui-locally.md
+++ b/wiki/contributing-to-eui/running-eui-locally.md
@@ -26,6 +26,15 @@ EUI only uses [yarn@v1 (classic)](https://classic.yarnpkg.com/en/docs/install),
 yarn
 ```
 
+#### Puppeteer issues
+
+If you're on an Apple arm64 machine and receive an error on `yarn` about Puppeteer/the chromium binary not being available, you have two options:
+
+1. If you don't need to run Puppeteer tests locally:
+    - Paste `PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true` into your terminal as an environment variable
+2. If you do need need to run Puppeteer locally:
+    - [Follow these steps](https://github.com/puppeteer/puppeteer/issues/6622#issuecomment-787912758) to install the Chromium binary globally and update your `~/.zshrc`.
+
 ## Running
 
 You can run the documentation locally at [http://localhost:8030/](http://localhost:8030/) with the following command: