Add reactotron for RN network debugging#12399

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
faridsalau merged 2 commits into from
Jun 24, 2025
Merged

Add reactotron for RN network debugging #12399

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
627dabe
Add reactotron
faridsalau Jun 24, 2025
dab3717
update readme
faridsalau Jun 24, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion packages/mobile/.eslintrc.js
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -6,7 +6,8 @@ module.exports = {
extends: ['audius'],
globals: {
Atomics: 'readonly',
SharedArrayBuffer: 'readonly'
SharedArrayBuffer: 'readonly',
__DEV__: 'readonly'
},
parser: '@typescript-eslint/parser',
parserOptions: {
Expand Down
68 changes: 68 additions & 0 deletions packages/mobile/REACTOTRON_SETUP.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
# Reactotron Setup for Audius Mobile

Reactotron has been added to the Audius mobile app for enhanced debugging capabilities.

## Installation

Reactotron is already configured in the project. You just need to install the desktop app.

### Download Reactotron Desktop App

Download the desktop app from: https://github.com/infinitered/reactotron/releases

Choose the appropriate version for your operating system (Windows, Mac, or Linux).

## Configuration

The configuration is already set up in `ReactotronConfig.js` with the following features:

- React Native plugins enabled
- AsyncStorage integration
- Network request monitoring (ignores symbolicate requests)
- Error tracking
- Custom app name: "Audius Mobile"

## Usage

### For iOS Simulator

1. Start the Reactotron desktop app
2. Run the mobile app with `npm run ios:dev`
3. Reactotron should automatically connect

### For Android Emulator/Device

1. Set up port forwarding (required for Android):
```bash
adb reverse tcp:9090 tcp:9090
```
2. Start the Reactotron desktop app
3. Run the mobile app with `npm run android:dev`
4. Reactotron should connect

### For Physical iOS Device

1. Find your computer's IP address
2. Update `ReactotronConfig.js` and change `host: 'localhost'` to your IP address
3. Make sure your device and computer are on the same network
4. Start Reactotron and run the app

## Features Available

- **Timeline**: See all actions, API calls, and logs in real-time
- **State**: Inspect Redux state and dispatched actions
- **API**: Monitor network requests and responses
- **AsyncStorage**: View and edit AsyncStorage contents
- **Custom Commands**: Send custom commands to your app
- **Performance**: Track render times and performance metrics

## Development Only

Reactotron is automatically disabled in production builds and only runs when `__DEV__` is true.

## Troubleshooting

- **Connection Issues**: Make sure the port 9090 is not blocked by firewall
- **Android Not Connecting**: Ensure `adb reverse tcp:9090 tcp:9090` is run
- **Physical Device**: Use your computer's IP address instead of localhost
- **Multiple Apps**: Each app instance shows as a separate connection in Reactotron
10 changes: 8 additions & 2 deletions packages/mobile/README.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -53,18 +53,24 @@ If you run into issues, try cleaning the android build folder
cd android && ./gradlew clean && cd ..
```


## Running Storybook
1.

1.

```
npm run start:storybook
```

2. Uncomment line three in src/app/index.ts, essentially you need to export the App component from storybook.

## Debugging

To debug the app follow the instructions [here](https://reactnative.dev/docs/debugging?js-debugger=new-debugger)

### Reactotron

For enhanced debugging capabilities, Reactotron has been integrated into the mobile app. See the [Reactotron Setup Guide](./REACTOTRON_SETUP.md) for installation and usage instructions.

You can also start react and redux devtools with

```
Expand Down
20 changes: 20 additions & 0 deletions packages/mobile/ReactotronConfig.js
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
import AsyncStorage from '@react-native-async-storage/async-storage'
import Reactotron from 'reactotron-react-native'

Reactotron.setAsyncStorageHandler(AsyncStorage)
.configure({
name: 'Audius Mobile',
host: 'localhost', // server ip for remote debugging
port: 9090
})
.useReactNative({
asyncStorage: false, // there are more options to the async storage.
networking: {
// optionally, you can turn it off with false.
ignoreUrls: /symbolicate/
},
editor: false, // there are more options to editor
errors: { veto: (stackFrame) => false }, // or turn it off with false
overlay: false // just turning off overlay
})
.connect() // let's connect!
5 changes: 5 additions & 0 deletions packages/mobile/index.js
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,11 @@
/* eslint-disable import/first */
/* eslint-disable import/order */
import 'react-native-gesture-handler'

// Import Reactotron in development mode only
if (__DEV__) {
require('./ReactotronConfig')
}
// react-native has an issue with inverted lists on Android, and it got worse
// with Android 13. To avoid it we patch a react-native style, but that style
// got deprecated in React Native 0.70. For now the deprecation is limited to a
Expand Down
1 change: 1 addition & 0 deletions packages/mobile/package.json
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -222,6 +222,7 @@
"prettier": "3.4.2",
"react-native-clean-project": "4.0.3",
"react-test-renderer": "18.3.1",
"reactotron-react-native": "^5.1.14",
"replace-in-file": "6.3.5",
"typescript": "5.0.4"
},
Expand Down
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '

Skip to content
Add reactotron for RN network debugging#12399

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

faridsalau
merged 2 commits into

from

Jun 24, 2025
 Merged


Add reactotron for RN network debugging
#12399
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
627dabe

Add reactotron


faridsalau Jun 24, 2025
dab3717

update readme


faridsalau Jun 24, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


3 changes: 2 additions & 1 deletion
packages/mobile/.eslintrc.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -6,7 +6,8 @@ module.exports = {
 extends: ['audius'],
 globals: {
 Atomics: 'readonly',
 SharedArrayBuffer: 'readonly'
 SharedArrayBuffer: 'readonly',
 __DEV__: 'readonly'
 },
 parser: '@typescript-eslint/parser',
 parserOptions: {
Expand Down

68 changes: 68 additions & 0 deletions
packages/mobile/REACTOTRON_SETUP.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
# Reactotron Setup for Audius Mobile

Reactotron has been added to the Audius mobile app for enhanced debugging capabilities.

## Installation

Reactotron is already configured in the project. You just need to install the desktop app.

### Download Reactotron Desktop App

Download the desktop app from: https://github.com/infinitered/reactotron/releases

Choose the appropriate version for your operating system (Windows, Mac, or Linux).

## Configuration

The configuration is already set up in `ReactotronConfig.js` with the following features:

- React Native plugins enabled
- AsyncStorage integration
- Network request monitoring (ignores symbolicate requests)
- Error tracking
- Custom app name: "Audius Mobile"

## Usage

### For iOS Simulator

1. Start the Reactotron desktop app
2. Run the mobile app with `npm run ios:dev`
3. Reactotron should automatically connect

### For Android Emulator/Device

1. Set up port forwarding (required for Android):
 ```bash
 adb reverse tcp:9090 tcp:9090
 ```
2. Start the Reactotron desktop app
3. Run the mobile app with `npm run android:dev`
4. Reactotron should connect

### For Physical iOS Device

1. Find your computer's IP address
2. Update `ReactotronConfig.js` and change `host: 'localhost'` to your IP address
3. Make sure your device and computer are on the same network
4. Start Reactotron and run the app

## Features Available

- **Timeline**: See all actions, API calls, and logs in real-time
- **State**: Inspect Redux state and dispatched actions
- **API**: Monitor network requests and responses
- **AsyncStorage**: View and edit AsyncStorage contents
- **Custom Commands**: Send custom commands to your app
- **Performance**: Track render times and performance metrics

## Development Only

Reactotron is automatically disabled in production builds and only runs when `__DEV__` is true.

## Troubleshooting

- **Connection Issues**: Make sure the port 9090 is not blocked by firewall
- **Android Not Connecting**: Ensure `adb reverse tcp:9090 tcp:9090` is run
- **Physical Device**: Use your computer's IP address instead of localhost
- **Multiple Apps**: Each app instance shows as a separate connection in Reactotron

10 changes: 8 additions & 2 deletions
packages/mobile/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -53,18 +53,24 @@ If you run into issues, try cleaning the android build folder
cd android && ./gradlew clean && cd ..
```


## Running Storybook
1. 

1.

```
npm run start:storybook
```

2. Uncomment line three in src/app/index.ts, essentially you need to export the App component from storybook.

## Debugging

To debug the app follow the instructions [here](https://reactnative.dev/docs/debugging?js-debugger=new-debugger)

### Reactotron

For enhanced debugging capabilities, Reactotron has been integrated into the mobile app. See the [Reactotron Setup Guide](./REACTOTRON_SETUP.md) for installation and usage instructions.

You can also start react and redux devtools with

```
Expand Down

20 changes: 20 additions & 0 deletions
packages/mobile/ReactotronConfig.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
import AsyncStorage from '@react-native-async-storage/async-storage'
import Reactotron from 'reactotron-react-native'

Reactotron.setAsyncStorageHandler(AsyncStorage)
 .configure({
 name: 'Audius Mobile',
 host: 'localhost', // server ip for remote debugging
 port: 9090
 })
 .useReactNative({
 asyncStorage: false, // there are more options to the async storage.
 networking: {
 // optionally, you can turn it off with false.
 ignoreUrls: /symbolicate/
 },
 editor: false, // there are more options to editor
 errors: { veto: (stackFrame) => false }, // or turn it off with false
 overlay: false // just turning off overlay
 })
 .connect() // let's connect!

5 changes: 5 additions & 0 deletions
packages/mobile/index.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,6 +1,11 @@
/* eslint-disable import/first */
/* eslint-disable import/order */
import 'react-native-gesture-handler'

// Import Reactotron in development mode only
if (__DEV__) {
 require('./ReactotronConfig')
}
// react-native has an issue with inverted lists on Android, and it got worse
// with Android 13. To avoid it we patch a react-native style, but that style
// got deprecated in React Native 0.70. For now the deprecation is limited to a
Expand Down

1 change: 1 addition & 0 deletions
packages/mobile/package.json

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -222,6 +222,7 @@
 "prettier": "3.4.2",
 "react-native-clean-project": "4.0.3",
 "react-test-renderer": "18.3.1",
 "reactotron-react-native": "^5.1.14",
 "replace-in-file": "6.3.5",
 "typescript": "5.0.4"
 },
Expand Down

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Add reactotron for RN network debugging#12399

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

faridsalau
merged 2 commits into

from

Jun 24, 2025
 Merged


Add reactotron for RN network debugging
#12399
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
627dabe

Add reactotron


faridsalau Jun 24, 2025
dab3717

update readme


faridsalau Jun 24, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


3 changes: 2 additions & 1 deletion
packages/mobile/.eslintrc.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -6,7 +6,8 @@ module.exports = {
 extends: ['audius'],
 globals: {
 Atomics: 'readonly',
 SharedArrayBuffer: 'readonly'
 SharedArrayBuffer: 'readonly',
 __DEV__: 'readonly'
 },
 parser: '@typescript-eslint/parser',
 parserOptions: {
Expand Down

68 changes: 68 additions & 0 deletions
packages/mobile/REACTOTRON_SETUP.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
# Reactotron Setup for Audius Mobile

Reactotron has been added to the Audius mobile app for enhanced debugging capabilities.

## Installation

Reactotron is already configured in the project. You just need to install the desktop app.

### Download Reactotron Desktop App

Download the desktop app from: https://github.com/infinitered/reactotron/releases

Choose the appropriate version for your operating system (Windows, Mac, or Linux).

## Configuration

The configuration is already set up in `ReactotronConfig.js` with the following features:

- React Native plugins enabled
- AsyncStorage integration
- Network request monitoring (ignores symbolicate requests)
- Error tracking
- Custom app name: "Audius Mobile"

## Usage

### For iOS Simulator

1. Start the Reactotron desktop app
2. Run the mobile app with `npm run ios:dev`
3. Reactotron should automatically connect

### For Android Emulator/Device

1. Set up port forwarding (required for Android):
 ```bash
 adb reverse tcp:9090 tcp:9090
 ```
2. Start the Reactotron desktop app
3. Run the mobile app with `npm run android:dev`
4. Reactotron should connect

### For Physical iOS Device

1. Find your computer's IP address
2. Update `ReactotronConfig.js` and change `host: 'localhost'` to your IP address
3. Make sure your device and computer are on the same network
4. Start Reactotron and run the app

## Features Available

- **Timeline**: See all actions, API calls, and logs in real-time
- **State**: Inspect Redux state and dispatched actions
- **API**: Monitor network requests and responses
- **AsyncStorage**: View and edit AsyncStorage contents
- **Custom Commands**: Send custom commands to your app
- **Performance**: Track render times and performance metrics

## Development Only

Reactotron is automatically disabled in production builds and only runs when `__DEV__` is true.

## Troubleshooting

- **Connection Issues**: Make sure the port 9090 is not blocked by firewall
- **Android Not Connecting**: Ensure `adb reverse tcp:9090 tcp:9090` is run
- **Physical Device**: Use your computer's IP address instead of localhost
- **Multiple Apps**: Each app instance shows as a separate connection in Reactotron

10 changes: 8 additions & 2 deletions
packages/mobile/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -53,18 +53,24 @@ If you run into issues, try cleaning the android build folder
cd android && ./gradlew clean && cd ..
```


## Running Storybook
1. 

1.

```
npm run start:storybook
```

2. Uncomment line three in src/app/index.ts, essentially you need to export the App component from storybook.

## Debugging

To debug the app follow the instructions [here](https://reactnative.dev/docs/debugging?js-debugger=new-debugger)

### Reactotron

For enhanced debugging capabilities, Reactotron has been integrated into the mobile app. See the [Reactotron Setup Guide](./REACTOTRON_SETUP.md) for installation and usage instructions.

You can also start react and redux devtools with

```
Expand Down

20 changes: 20 additions & 0 deletions
packages/mobile/ReactotronConfig.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
import AsyncStorage from '@react-native-async-storage/async-storage'
import Reactotron from 'reactotron-react-native'

Reactotron.setAsyncStorageHandler(AsyncStorage)
 .configure({
 name: 'Audius Mobile',
 host: 'localhost', // server ip for remote debugging
 port: 9090
 })
 .useReactNative({
 asyncStorage: false, // there are more options to the async storage.
 networking: {
 // optionally, you can turn it off with false.
 ignoreUrls: /symbolicate/
 },
 editor: false, // there are more options to editor
 errors: { veto: (stackFrame) => false }, // or turn it off with false
 overlay: false // just turning off overlay
 })
 .connect() // let's connect!

5 changes: 5 additions & 0 deletions
packages/mobile/index.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,6 +1,11 @@
/* eslint-disable import/first */
/* eslint-disable import/order */
import 'react-native-gesture-handler'

// Import Reactotron in development mode only
if (__DEV__) {
 require('./ReactotronConfig')
}
// react-native has an issue with inverted lists on Android, and it got worse
// with Android 13. To avoid it we patch a react-native style, but that style
// got deprecated in React Native 0.70. For now the deprecation is limited to a
Expand Down

1 change: 1 addition & 0 deletions
packages/mobile/package.json

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -222,6 +222,7 @@
 "prettier": "3.4.2",
 "react-native-clean-project": "4.0.3",
 "react-test-renderer": "18.3.1",
 "reactotron-react-native": "^5.1.14",
 "replace-in-file": "6.3.5",
 "typescript": "5.0.4"
 },
Expand Down

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Add reactotron for RN network debugging#12399

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

faridsalau
merged 2 commits into

from

Jun 24, 2025
 Merged


Add reactotron for RN network debugging
#12399
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
627dabe

Add reactotron


faridsalau Jun 24, 2025
dab3717

update readme


faridsalau Jun 24, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


3 changes: 2 additions & 1 deletion
packages/mobile/.eslintrc.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -6,7 +6,8 @@ module.exports = {
 extends: ['audius'],
 globals: {
 Atomics: 'readonly',
 SharedArrayBuffer: 'readonly'
 SharedArrayBuffer: 'readonly',
 __DEV__: 'readonly'
 },
 parser: '@typescript-eslint/parser',
 parserOptions: {
Expand Down

68 changes: 68 additions & 0 deletions
packages/mobile/REACTOTRON_SETUP.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
# Reactotron Setup for Audius Mobile

Reactotron has been added to the Audius mobile app for enhanced debugging capabilities.

## Installation

Reactotron is already configured in the project. You just need to install the desktop app.

### Download Reactotron Desktop App

Download the desktop app from: https://github.com/infinitered/reactotron/releases

Choose the appropriate version for your operating system (Windows, Mac, or Linux).

## Configuration

The configuration is already set up in `ReactotronConfig.js` with the following features:

- React Native plugins enabled
- AsyncStorage integration
- Network request monitoring (ignores symbolicate requests)
- Error tracking
- Custom app name: "Audius Mobile"

## Usage

### For iOS Simulator

1. Start the Reactotron desktop app
2. Run the mobile app with `npm run ios:dev`
3. Reactotron should automatically connect

### For Android Emulator/Device

1. Set up port forwarding (required for Android):
 ```bash
 adb reverse tcp:9090 tcp:9090
 ```
2. Start the Reactotron desktop app
3. Run the mobile app with `npm run android:dev`
4. Reactotron should connect

### For Physical iOS Device

1. Find your computer's IP address
2. Update `ReactotronConfig.js` and change `host: 'localhost'` to your IP address
3. Make sure your device and computer are on the same network
4. Start Reactotron and run the app

## Features Available

- **Timeline**: See all actions, API calls, and logs in real-time
- **State**: Inspect Redux state and dispatched actions
- **API**: Monitor network requests and responses
- **AsyncStorage**: View and edit AsyncStorage contents
- **Custom Commands**: Send custom commands to your app
- **Performance**: Track render times and performance metrics

## Development Only

Reactotron is automatically disabled in production builds and only runs when `__DEV__` is true.

## Troubleshooting

- **Connection Issues**: Make sure the port 9090 is not blocked by firewall
- **Android Not Connecting**: Ensure `adb reverse tcp:9090 tcp:9090` is run
- **Physical Device**: Use your computer's IP address instead of localhost
- **Multiple Apps**: Each app instance shows as a separate connection in Reactotron

10 changes: 8 additions & 2 deletions
packages/mobile/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -53,18 +53,24 @@ If you run into issues, try cleaning the android build folder
cd android && ./gradlew clean && cd ..
```


## Running Storybook
1. 

1.

```
npm run start:storybook
```

2. Uncomment line three in src/app/index.ts, essentially you need to export the App component from storybook.

## Debugging

To debug the app follow the instructions [here](https://reactnative.dev/docs/debugging?js-debugger=new-debugger)

### Reactotron

For enhanced debugging capabilities, Reactotron has been integrated into the mobile app. See the [Reactotron Setup Guide](./REACTOTRON_SETUP.md) for installation and usage instructions.

You can also start react and redux devtools with

```
Expand Down

20 changes: 20 additions & 0 deletions
packages/mobile/ReactotronConfig.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
import AsyncStorage from '@react-native-async-storage/async-storage'
import Reactotron from 'reactotron-react-native'

Reactotron.setAsyncStorageHandler(AsyncStorage)
 .configure({
 name: 'Audius Mobile',
 host: 'localhost', // server ip for remote debugging
 port: 9090
 })
 .useReactNative({
 asyncStorage: false, // there are more options to the async storage.
 networking: {
 // optionally, you can turn it off with false.
 ignoreUrls: /symbolicate/
 },
 editor: false, // there are more options to editor
 errors: { veto: (stackFrame) => false }, // or turn it off with false
 overlay: false // just turning off overlay
 })
 .connect() // let's connect!

5 changes: 5 additions & 0 deletions
packages/mobile/index.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,6 +1,11 @@
/* eslint-disable import/first */
/* eslint-disable import/order */
import 'react-native-gesture-handler'

// Import Reactotron in development mode only
if (__DEV__) {
 require('./ReactotronConfig')
}
// react-native has an issue with inverted lists on Android, and it got worse
// with Android 13. To avoid it we patch a react-native style, but that style
// got deprecated in React Native 0.70. For now the deprecation is limited to a
Expand Down

1 change: 1 addition & 0 deletions
packages/mobile/package.json

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -222,6 +222,7 @@
 "prettier": "3.4.2",
 "react-native-clean-project": "4.0.3",
 "react-test-renderer": "18.3.1",
 "reactotron-react-native": "^5.1.14",
 "replace-in-file": "6.3.5",
 "typescript": "5.0.4"
 },
Expand Down

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '

Skip to content
Add reactotron for RN network debugging#12399

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

faridsalau
merged 2 commits into

from

Jun 24, 2025
 Merged


Add reactotron for RN network debugging
#12399
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
627dabe

Add reactotron


faridsalau Jun 24, 2025
dab3717

update readme


faridsalau Jun 24, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


3 changes: 2 additions & 1 deletion
packages/mobile/.eslintrc.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -6,7 +6,8 @@ module.exports = {
 extends: ['audius'],
 globals: {
 Atomics: 'readonly',
 SharedArrayBuffer: 'readonly'
 SharedArrayBuffer: 'readonly',
 __DEV__: 'readonly'
 },
 parser: '@typescript-eslint/parser',
 parserOptions: {
Expand Down

68 changes: 68 additions & 0 deletions
packages/mobile/REACTOTRON_SETUP.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
# Reactotron Setup for Audius Mobile

Reactotron has been added to the Audius mobile app for enhanced debugging capabilities.

## Installation

Reactotron is already configured in the project. You just need to install the desktop app.

### Download Reactotron Desktop App

Download the desktop app from: https://github.com/infinitered/reactotron/releases

Choose the appropriate version for your operating system (Windows, Mac, or Linux).

## Configuration

The configuration is already set up in `ReactotronConfig.js` with the following features:

- React Native plugins enabled
- AsyncStorage integration
- Network request monitoring (ignores symbolicate requests)
- Error tracking
- Custom app name: "Audius Mobile"

## Usage

### For iOS Simulator

1. Start the Reactotron desktop app
2. Run the mobile app with `npm run ios:dev`
3. Reactotron should automatically connect

### For Android Emulator/Device

1. Set up port forwarding (required for Android):
 ```bash
 adb reverse tcp:9090 tcp:9090
 ```
2. Start the Reactotron desktop app
3. Run the mobile app with `npm run android:dev`
4. Reactotron should connect

### For Physical iOS Device

1. Find your computer's IP address
2. Update `ReactotronConfig.js` and change `host: 'localhost'` to your IP address
3. Make sure your device and computer are on the same network
4. Start Reactotron and run the app

## Features Available

- **Timeline**: See all actions, API calls, and logs in real-time
- **State**: Inspect Redux state and dispatched actions
- **API**: Monitor network requests and responses
- **AsyncStorage**: View and edit AsyncStorage contents
- **Custom Commands**: Send custom commands to your app
- **Performance**: Track render times and performance metrics

## Development Only

Reactotron is automatically disabled in production builds and only runs when `__DEV__` is true.

## Troubleshooting

- **Connection Issues**: Make sure the port 9090 is not blocked by firewall
- **Android Not Connecting**: Ensure `adb reverse tcp:9090 tcp:9090` is run
- **Physical Device**: Use your computer's IP address instead of localhost
- **Multiple Apps**: Each app instance shows as a separate connection in Reactotron

10 changes: 8 additions & 2 deletions
packages/mobile/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -53,18 +53,24 @@ If you run into issues, try cleaning the android build folder
cd android && ./gradlew clean && cd ..
```


## Running Storybook
1. 

1.

```
npm run start:storybook
```

2. Uncomment line three in src/app/index.ts, essentially you need to export the App component from storybook.

## Debugging

To debug the app follow the instructions [here](https://reactnative.dev/docs/debugging?js-debugger=new-debugger)

### Reactotron

For enhanced debugging capabilities, Reactotron has been integrated into the mobile app. See the [Reactotron Setup Guide](./REACTOTRON_SETUP.md) for installation and usage instructions.

You can also start react and redux devtools with

```
Expand Down

20 changes: 20 additions & 0 deletions
packages/mobile/ReactotronConfig.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
import AsyncStorage from '@react-native-async-storage/async-storage'
import Reactotron from 'reactotron-react-native'

Reactotron.setAsyncStorageHandler(AsyncStorage)
 .configure({
 name: 'Audius Mobile',
 host: 'localhost', // server ip for remote debugging
 port: 9090
 })
 .useReactNative({
 asyncStorage: false, // there are more options to the async storage.
 networking: {
 // optionally, you can turn it off with false.
 ignoreUrls: /symbolicate/
 },
 editor: false, // there are more options to editor
 errors: { veto: (stackFrame) => false }, // or turn it off with false
 overlay: false // just turning off overlay
 })
 .connect() // let's connect!

5 changes: 5 additions & 0 deletions
packages/mobile/index.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,6 +1,11 @@
/* eslint-disable import/first */
/* eslint-disable import/order */
import 'react-native-gesture-handler'

// Import Reactotron in development mode only
if (__DEV__) {
 require('./ReactotronConfig')
}
// react-native has an issue with inverted lists on Android, and it got worse
// with Android 13. To avoid it we patch a react-native style, but that style
// got deprecated in React Native 0.70. For now the deprecation is limited to a
Expand Down

1 change: 1 addition & 0 deletions
packages/mobile/package.json

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -222,6 +222,7 @@
 "prettier": "3.4.2",
 "react-native-clean-project": "4.0.3",
 "react-test-renderer": "18.3.1",
 "reactotron-react-native": "^5.1.14",
 "replace-in-file": "6.3.5",
 "typescript": "5.0.4"
 },
Expand Down

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Add reactotron for RN network debugging#12399

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

faridsalau
merged 2 commits into

from

Jun 24, 2025
 Merged


Add reactotron for RN network debugging
#12399
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
627dabe

Add reactotron


faridsalau Jun 24, 2025
dab3717

update readme


faridsalau Jun 24, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


3 changes: 2 additions & 1 deletion
packages/mobile/.eslintrc.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -6,7 +6,8 @@ module.exports = {
 extends: ['audius'],
 globals: {
 Atomics: 'readonly',
 SharedArrayBuffer: 'readonly'
 SharedArrayBuffer: 'readonly',
 __DEV__: 'readonly'
 },
 parser: '@typescript-eslint/parser',
 parserOptions: {
Expand Down

68 changes: 68 additions & 0 deletions
packages/mobile/REACTOTRON_SETUP.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
# Reactotron Setup for Audius Mobile

Reactotron has been added to the Audius mobile app for enhanced debugging capabilities.

## Installation

Reactotron is already configured in the project. You just need to install the desktop app.

### Download Reactotron Desktop App

Download the desktop app from: https://github.com/infinitered/reactotron/releases

Choose the appropriate version for your operating system (Windows, Mac, or Linux).

## Configuration

The configuration is already set up in `ReactotronConfig.js` with the following features:

- React Native plugins enabled
- AsyncStorage integration
- Network request monitoring (ignores symbolicate requests)
- Error tracking
- Custom app name: "Audius Mobile"

## Usage

### For iOS Simulator

1. Start the Reactotron desktop app
2. Run the mobile app with `npm run ios:dev`
3. Reactotron should automatically connect

### For Android Emulator/Device

1. Set up port forwarding (required for Android):
 ```bash
 adb reverse tcp:9090 tcp:9090
 ```
2. Start the Reactotron desktop app
3. Run the mobile app with `npm run android:dev`
4. Reactotron should connect

### For Physical iOS Device

1. Find your computer's IP address
2. Update `ReactotronConfig.js` and change `host: 'localhost'` to your IP address
3. Make sure your device and computer are on the same network
4. Start Reactotron and run the app

## Features Available

- **Timeline**: See all actions, API calls, and logs in real-time
- **State**: Inspect Redux state and dispatched actions
- **API**: Monitor network requests and responses
- **AsyncStorage**: View and edit AsyncStorage contents
- **Custom Commands**: Send custom commands to your app
- **Performance**: Track render times and performance metrics

## Development Only

Reactotron is automatically disabled in production builds and only runs when `__DEV__` is true.

## Troubleshooting

- **Connection Issues**: Make sure the port 9090 is not blocked by firewall
- **Android Not Connecting**: Ensure `adb reverse tcp:9090 tcp:9090` is run
- **Physical Device**: Use your computer's IP address instead of localhost
- **Multiple Apps**: Each app instance shows as a separate connection in Reactotron

10 changes: 8 additions & 2 deletions
packages/mobile/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -53,18 +53,24 @@ If you run into issues, try cleaning the android build folder
cd android && ./gradlew clean && cd ..
```


## Running Storybook
1. 

1.

```
npm run start:storybook
```

2. Uncomment line three in src/app/index.ts, essentially you need to export the App component from storybook.

## Debugging

To debug the app follow the instructions [here](https://reactnative.dev/docs/debugging?js-debugger=new-debugger)

### Reactotron

For enhanced debugging capabilities, Reactotron has been integrated into the mobile app. See the [Reactotron Setup Guide](./REACTOTRON_SETUP.md) for installation and usage instructions.

You can also start react and redux devtools with

```
Expand Down

20 changes: 20 additions & 0 deletions
packages/mobile/ReactotronConfig.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
import AsyncStorage from '@react-native-async-storage/async-storage'
import Reactotron from 'reactotron-react-native'

Reactotron.setAsyncStorageHandler(AsyncStorage)
 .configure({
 name: 'Audius Mobile',
 host: 'localhost', // server ip for remote debugging
 port: 9090
 })
 .useReactNative({
 asyncStorage: false, // there are more options to the async storage.
 networking: {
 // optionally, you can turn it off with false.
 ignoreUrls: /symbolicate/
 },
 editor: false, // there are more options to editor
 errors: { veto: (stackFrame) => false }, // or turn it off with false
 overlay: false // just turning off overlay
 })
 .connect() // let's connect!

5 changes: 5 additions & 0 deletions
packages/mobile/index.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,6 +1,11 @@
/* eslint-disable import/first */
/* eslint-disable import/order */
import 'react-native-gesture-handler'

// Import Reactotron in development mode only
if (__DEV__) {
 require('./ReactotronConfig')
}
// react-native has an issue with inverted lists on Android, and it got worse
// with Android 13. To avoid it we patch a react-native style, but that style
// got deprecated in React Native 0.70. For now the deprecation is limited to a
Expand Down

1 change: 1 addition & 0 deletions
packages/mobile/package.json

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -222,6 +222,7 @@
 "prettier": "3.4.2",
 "react-native-clean-project": "4.0.3",
 "react-test-renderer": "18.3.1",
 "reactotron-react-native": "^5.1.14",
 "replace-in-file": "6.3.5",
 "typescript": "5.0.4"
 },
Expand Down

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '

Skip to content
Add reactotron for RN network debugging#12399

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

faridsalau
merged 2 commits into

from

Jun 24, 2025
 Merged


Add reactotron for RN network debugging
#12399
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
627dabe

Add reactotron


faridsalau Jun 24, 2025
dab3717

update readme


faridsalau Jun 24, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


3 changes: 2 additions & 1 deletion
packages/mobile/.eslintrc.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -6,7 +6,8 @@ module.exports = {
 extends: ['audius'],
 globals: {
 Atomics: 'readonly',
 SharedArrayBuffer: 'readonly'
 SharedArrayBuffer: 'readonly',
 __DEV__: 'readonly'
 },
 parser: '@typescript-eslint/parser',
 parserOptions: {
Expand Down

68 changes: 68 additions & 0 deletions
packages/mobile/REACTOTRON_SETUP.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
# Reactotron Setup for Audius Mobile

Reactotron has been added to the Audius mobile app for enhanced debugging capabilities.

## Installation

Reactotron is already configured in the project. You just need to install the desktop app.

### Download Reactotron Desktop App

Download the desktop app from: https://github.com/infinitered/reactotron/releases

Choose the appropriate version for your operating system (Windows, Mac, or Linux).

## Configuration

The configuration is already set up in `ReactotronConfig.js` with the following features:

- React Native plugins enabled
- AsyncStorage integration
- Network request monitoring (ignores symbolicate requests)
- Error tracking
- Custom app name: "Audius Mobile"

## Usage

### For iOS Simulator

1. Start the Reactotron desktop app
2. Run the mobile app with `npm run ios:dev`
3. Reactotron should automatically connect

### For Android Emulator/Device

1. Set up port forwarding (required for Android):
 ```bash
 adb reverse tcp:9090 tcp:9090
 ```
2. Start the Reactotron desktop app
3. Run the mobile app with `npm run android:dev`
4. Reactotron should connect

### For Physical iOS Device

1. Find your computer's IP address
2. Update `ReactotronConfig.js` and change `host: 'localhost'` to your IP address
3. Make sure your device and computer are on the same network
4. Start Reactotron and run the app

## Features Available

- **Timeline**: See all actions, API calls, and logs in real-time
- **State**: Inspect Redux state and dispatched actions
- **API**: Monitor network requests and responses
- **AsyncStorage**: View and edit AsyncStorage contents
- **Custom Commands**: Send custom commands to your app
- **Performance**: Track render times and performance metrics

## Development Only

Reactotron is automatically disabled in production builds and only runs when `__DEV__` is true.

## Troubleshooting

- **Connection Issues**: Make sure the port 9090 is not blocked by firewall
- **Android Not Connecting**: Ensure `adb reverse tcp:9090 tcp:9090` is run
- **Physical Device**: Use your computer's IP address instead of localhost
- **Multiple Apps**: Each app instance shows as a separate connection in Reactotron

10 changes: 8 additions & 2 deletions
packages/mobile/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -53,18 +53,24 @@ If you run into issues, try cleaning the android build folder
cd android && ./gradlew clean && cd ..
```


## Running Storybook
1. 

1.

```
npm run start:storybook
```

2. Uncomment line three in src/app/index.ts, essentially you need to export the App component from storybook.

## Debugging

To debug the app follow the instructions [here](https://reactnative.dev/docs/debugging?js-debugger=new-debugger)

### Reactotron

For enhanced debugging capabilities, Reactotron has been integrated into the mobile app. See the [Reactotron Setup Guide](./REACTOTRON_SETUP.md) for installation and usage instructions.

You can also start react and redux devtools with

```
Expand Down

20 changes: 20 additions & 0 deletions
packages/mobile/ReactotronConfig.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
import AsyncStorage from '@react-native-async-storage/async-storage'
import Reactotron from 'reactotron-react-native'

Reactotron.setAsyncStorageHandler(AsyncStorage)
 .configure({
 name: 'Audius Mobile',
 host: 'localhost', // server ip for remote debugging
 port: 9090
 })
 .useReactNative({
 asyncStorage: false, // there are more options to the async storage.
 networking: {
 // optionally, you can turn it off with false.
 ignoreUrls: /symbolicate/
 },
 editor: false, // there are more options to editor
 errors: { veto: (stackFrame) => false }, // or turn it off with false
 overlay: false // just turning off overlay
 })
 .connect() // let's connect!

5 changes: 5 additions & 0 deletions
packages/mobile/index.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,6 +1,11 @@
/* eslint-disable import/first */
/* eslint-disable import/order */
import 'react-native-gesture-handler'

// Import Reactotron in development mode only
if (__DEV__) {
 require('./ReactotronConfig')
}
// react-native has an issue with inverted lists on Android, and it got worse
// with Android 13. To avoid it we patch a react-native style, but that style
// got deprecated in React Native 0.70. For now the deprecation is limited to a
Expand Down

1 change: 1 addition & 0 deletions
packages/mobile/package.json

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -222,6 +222,7 @@
 "prettier": "3.4.2",
 "react-native-clean-project": "4.0.3",
 "react-test-renderer": "18.3.1",
 "reactotron-react-native": "^5.1.14",
 "replace-in-file": "6.3.5",
 "typescript": "5.0.4"
 },
Expand Down

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Universal Dark Mode - works on any site
(function() {
var enabled = true;
function applyDarkMode() {
if (!enabled) return;
// Create style element if it doesn't exist
var style = document.getElementById('universal-dark-mode-style');
if (!style) {
style = document.createElement('style');
style.id = 'universal-dark-mode-style';
document.head.appendChild(style);
}
// Dark mode CSS - inverts colors but preserves images/video
style.textContent = '
/* Invert everything except media */
html {
filter: invert(1) hue-rotate(180deg) !important;
background: #1a1a2e !important;
}
/* Restore images, videos, iframes, canvas */
img, video, iframe, canvas, svg, picture, [style*="background-image"] {
filter: invert(1) hue-rotate(180deg) !important;
}
/* Preserve specific elements that should not be inverted */
.no-dark-mode, .no-dark-mode *,
[data-theme="light"], [data-theme="light"],
.ace_editor, .ace_editor *,
.CodeMirror, .CodeMirror *,
.monaco-editor, .monaco-editor *,
.markdown-body pre, .markdown-body pre *,
.highlight, .highlight *,
pre code, pre code * {
filter: none !important;
}
/* Fix common UI elements */
.modal, .popup, .dropdown-menu, .tooltip, .popover {
filter: invert(1) hue-rotate(180deg) !important;
background: #2d2d44 !important;
border-color: #444 !important;
}
/* Scrollbars */
::-webkit-scrollbar { background: #1a1a2e !important; }
::-webkit-scrollbar-thumb { background: #444 !important; }
::-webkit-scrollbar-thumb:hover { background: #555 !important; }
/* Selection */
::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
';
}
function removeDarkMode() {
var style = document.getElementById('universal-dark-mode-style');
if (style) style.remove();
}
// Toggle with Alt+Shift+D
document.addEventListener('keydown', function(e) {
if (e.altKey && e.shiftKey && e.key === 'D') {
e.preventDefault();
enabled = !enabled;
if (enabled) {
applyDarkMode();
console.log('[Universal Dark Mode] Enabled');
} else {
removeDarkMode();
console.log('[Universal Dark Mode] Disabled');
}
}
});
// Apply on load
applyDarkMode();
// Re-apply on dynamic content
var observer = new MutationObserver(function(mutations) {
if (enabled && !document.getElementById('universal-dark-mode-style')) {
applyDarkMode();
}
});
observer.observe(document.head, { childList: true });
console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');
})();
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();

Skip to content
Add reactotron for RN network debugging#12399

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

faridsalau
merged 2 commits into

from

Jun 24, 2025
 Merged


Add reactotron for RN network debugging
#12399
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
627dabe

Add reactotron


faridsalau Jun 24, 2025
dab3717

update readme


faridsalau Jun 24, 2025

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


3 changes: 2 additions & 1 deletion
packages/mobile/.eslintrc.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -6,7 +6,8 @@ module.exports = {
 extends: ['audius'],
 globals: {
 Atomics: 'readonly',
 SharedArrayBuffer: 'readonly'
 SharedArrayBuffer: 'readonly',
 __DEV__: 'readonly'
 },
 parser: '@typescript-eslint/parser',
 parserOptions: {
Expand Down

68 changes: 68 additions & 0 deletions
packages/mobile/REACTOTRON_SETUP.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
# Reactotron Setup for Audius Mobile

Reactotron has been added to the Audius mobile app for enhanced debugging capabilities.

## Installation

Reactotron is already configured in the project. You just need to install the desktop app.

### Download Reactotron Desktop App

Download the desktop app from: https://github.com/infinitered/reactotron/releases

Choose the appropriate version for your operating system (Windows, Mac, or Linux).

## Configuration

The configuration is already set up in `ReactotronConfig.js` with the following features:

- React Native plugins enabled
- AsyncStorage integration
- Network request monitoring (ignores symbolicate requests)
- Error tracking
- Custom app name: "Audius Mobile"

## Usage

### For iOS Simulator

1. Start the Reactotron desktop app
2. Run the mobile app with `npm run ios:dev`
3. Reactotron should automatically connect

### For Android Emulator/Device

1. Set up port forwarding (required for Android):
 ```bash
 adb reverse tcp:9090 tcp:9090
 ```
2. Start the Reactotron desktop app
3. Run the mobile app with `npm run android:dev`
4. Reactotron should connect

### For Physical iOS Device

1. Find your computer's IP address
2. Update `ReactotronConfig.js` and change `host: 'localhost'` to your IP address
3. Make sure your device and computer are on the same network
4. Start Reactotron and run the app

## Features Available

- **Timeline**: See all actions, API calls, and logs in real-time
- **State**: Inspect Redux state and dispatched actions
- **API**: Monitor network requests and responses
- **AsyncStorage**: View and edit AsyncStorage contents
- **Custom Commands**: Send custom commands to your app
- **Performance**: Track render times and performance metrics

## Development Only

Reactotron is automatically disabled in production builds and only runs when `__DEV__` is true.

## Troubleshooting

- **Connection Issues**: Make sure the port 9090 is not blocked by firewall
- **Android Not Connecting**: Ensure `adb reverse tcp:9090 tcp:9090` is run
- **Physical Device**: Use your computer's IP address instead of localhost
- **Multiple Apps**: Each app instance shows as a separate connection in Reactotron

10 changes: 8 additions & 2 deletions
packages/mobile/README.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -53,18 +53,24 @@ If you run into issues, try cleaning the android build folder
cd android && ./gradlew clean && cd ..
```


## Running Storybook
1. 

1.

```
npm run start:storybook
```

2. Uncomment line three in src/app/index.ts, essentially you need to export the App component from storybook.

## Debugging

To debug the app follow the instructions [here](https://reactnative.dev/docs/debugging?js-debugger=new-debugger)

### Reactotron

For enhanced debugging capabilities, Reactotron has been integrated into the mobile app. See the [Reactotron Setup Guide](./REACTOTRON_SETUP.md) for installation and usage instructions.

You can also start react and redux devtools with

```
Expand Down

20 changes: 20 additions & 0 deletions
packages/mobile/ReactotronConfig.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
import AsyncStorage from '@react-native-async-storage/async-storage'
import Reactotron from 'reactotron-react-native'

Reactotron.setAsyncStorageHandler(AsyncStorage)
 .configure({
 name: 'Audius Mobile',
 host: 'localhost', // server ip for remote debugging
 port: 9090
 })
 .useReactNative({
 asyncStorage: false, // there are more options to the async storage.
 networking: {
 // optionally, you can turn it off with false.
 ignoreUrls: /symbolicate/
 },
 editor: false, // there are more options to editor
 errors: { veto: (stackFrame) => false }, // or turn it off with false
 overlay: false // just turning off overlay
 })
 .connect() // let's connect!

5 changes: 5 additions & 0 deletions
packages/mobile/index.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -1,6 +1,11 @@
/* eslint-disable import/first */
/* eslint-disable import/order */
import 'react-native-gesture-handler'

// Import Reactotron in development mode only
if (__DEV__) {
 require('./ReactotronConfig')
}
// react-native has an issue with inverted lists on Android, and it got worse
// with Android 13. To avoid it we patch a react-native style, but that style
// got deprecated in React Native 0.70. For now the deprecation is limited to a
Expand Down

1 change: 1 addition & 0 deletions
packages/mobile/package.json

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -222,6 +222,7 @@
 "prettier": "3.4.2",
 "react-native-clean-project": "4.0.3",
 "react-test-renderer": "18.3.1",
 "reactotron-react-native": "^5.1.14",
 "replace-in-file": "6.3.5",
 "typescript": "5.0.4"
 },
Expand Down