diff --git a/README.md b/README.md
index bbc6db8..92881a9 100644
--- a/README.md
+++ b/README.md
@@ -6,11 +6,13 @@ This project includes web components for connecting to Lightning wallets and ena
🆕 Bitcoin Connect also supports a nice invoice payment UI that gives a multitude of options to a user to pay an invoice. Accept payments with a single line of code.
-## 🛝 Try it out here
+## 🛝 Try it out
-
-https://bitcoin-connect.com
-
+[Demo](https://bitcoin-connect.com)
+
+## 🧳 Migration Guide
+
+There are multiple breaking changes in **v3**. See our migration guide [here](doc/MIGRATION_v3.md). Click [here](https://github.com/getAlby/bitcoin-connect/tree/v2.4.2-alpha) for v2.
## 🚀 Quick Start
@@ -28,32 +30,93 @@ https://bitcoin-connect.com
You can use Bitcoin Connect without any build tools:
-> NOTE: LNC connector is not supported!
-
```html
-
+
+
+
+
```
## 🤙 Usage
+### Pure JS
+
+```ts
+import {
+ init,
+ launchModal,
+ launchPaymentModal,
+ requestProvider,
+} from '@getalby/bitcoin-connect-react';
+
+// Initialize Bitcoin Connect
+init({
+ appName: 'My Lightning App', // your app name
+});
+
+// launch modal programmatically
+await launchModal();
+
+// launch modal to receive a payment
+await launchPaymentModal({
+ invoice: 'lnbc...',
+ onPaid: ({preimage}) => alert('Paid: ' + preimage), // NOTE: only fired if paid with WebLN - see full api documentation below
+});
+
+// or request a WebLN provider to use the full WebLN API
+const weblnProvider = await requestProvider();
+const {preimage} = await weblnProvider.sendPayment('lnbc...');
+```
+
+_Continue further down for the full Bitcoin Connect API._
+
### React
```jsx
-import {Button, Modal, launchModal, closeModal} from '@getalby/bitcoin-connect-react';
-
-// render a button
-