Skip to main content
The official sample lives in its own repository (not inside the dashboard or widget monorepo): https://github.com/ethioreview/er-widget-sample It installs the published npm packages and renders React, Web Component, and iframe embeds against sandbox keys.

​
Who this is for

Frontend developers and students validating CORS, layout, and click-through links before staging.

​
Prerequisites

​
Clone and run

Open http://localhost:5173 — you should see the five synthetic sandbox testimonials in both the React and Web Component sections. Dashboard checklist: Sandbox test in the dashboard · Create sandbox keys.

​
Option — plain HTML without cloning

​
Verify

You should see synthetic review cards. Each card links to a sandbox EthioReview review URL (paths under /sandbox/organizations/...).
If the page is blank, open DevTools → Network and check for 403 on the widget reviews request. Fix allowed origins first.

​
One failure mode

Mixing pk_live_* into the sample app — you will either see live data on localhost (if the origin is allowlisted) or hard failures. Keep the sample app on pk_test_* until you intentionally promote.

​
Next

Web Component embed → · Create production keys →