diff --git a/README.md b/README.md
index a8e8f72a1..88685abd7 100644
--- a/README.md
+++ b/README.md
@@ -131,6 +131,19 @@ const modal = setupModal(selector, {
 });
 ```
 
+## Known Issues
+
+The [ledger package](./packages/ledger) can present some issues when used on the [parcel bundler](https://parceljs.org). To solve them add the following aliases to your `package.json`:
+
+```json
+{ 
+  ...
+  "alias": {
+    "@ledgerhq/devices": "@ledgerhq/devices/lib-es"
+  }
+}
+```
+
 ## Contributing
 
 Contributors may find the [`examples`](./examples) directory useful as it provides a quick and consistent way to manually test new changes and/or bug fixes.