Skip to main content

Common Issues and Solutions

This guide provides solutions to common problems you may encounter when using JetWings.

Connection Issues​

IDE Shows "Offline" on Mobile​

Symptoms:

  • Mobile app shows IDE card with "Offline" status
  • Cannot connect to IDE
  • Events stop arriving

Solutions:

  1. Check IDE is running

    Make sure your JetBrains IDE is open and running.

  2. Check connections are enabled in IDE

    Tools > JetWings > Enable Connections
    Status bar should show "Open"

  3. Check internet connectivity

    Both IDE and mobile must have active internet.

  4. Check firewall/proxy settings

    Requires:

    • Standard internet connection (HTTPS)
    • No SSL inspection on JetWings traffic

  5. Review IDE logs

    Help > Show Log in Finder
    Search for: "JetWings"
    Look for: Connection errors, authentication failures

  6. Verify pairing is valid

    If pairing has expired, re-pair devices. See Pairing Guide.

Connection Drops Frequently​

Symptoms:

  • Connection establishes but drops within minutes
  • Reconnection loops
  • "Connection lost" appears repeatedly

Solutions:

  1. Check network stability

    # Test for packet loss
    ping -c 100 8.8.8.8
    # Should show 0% packet loss

  2. Disable aggressive power saving

    macOS:

    System Settings > Battery >
    Uncheck "Put hard disks to sleep when possible"

    Windows:

    Power Options > High Performance

  3. Check VPN compatibility

    Some VPNs may interfere with connections. Try disabling VPN temporarily.

  4. Disable battery optimization (Android)

    Settings > Apps > JetWings > Battery > Don't optimize

Mobile App Cannot Connect​

Symptoms:

  • Mobile shows "Connecting..." indefinitely
  • "Failed to connect" error
  • IDE card shows "Open" but connection fails

Solutions:

  1. Verify IDE status is "Open"

    Mobile app should show IDE card with "Open" status. If "Closed": Enable connections in IDE (Tools > JetWings > Enable Connections) If "Offline": Check IDE is running and has internet

  2. Verify pairing is valid

    Mobile app:

    Long-press IDE card > View Details
    Check: Pairing not expired

  3. Check IDE is accepting connections

    IDE status bar should show green "Open" indicator.

  4. Re-pair if necessary

    If pairing expired or invalid:

    IDE: Tools > JetWings > Pair Mobile Device
    Mobile: Enter new code

  5. Clear mobile app cache

    iOS:

    Settings > General > iPhone Storage > JetWings > Offload App
    Reinstall

    Android:

    Settings > Apps > JetWings > Storage > Clear Cache

IDE Shows "Closed" Unexpectedly​

Symptoms:

  • IDE was "Open" but now shows "Closed"
  • Mobile cannot connect

Solutions:

  1. Re-enable connections

    Tools > JetWings > Enable Connections

  2. Check for errors in IDE logs

    Help > Show Log in Finder
    Search for: "JetWings"

Event Delivery Problems​

Events Not Arriving​

Symptoms:

  • Build completes but no mobile notification
  • Events appear in IDE but not mobile

Solutions:

  1. Verify connection status

    IDE: Status bar should show green "Open" with active connection Mobile: Should show "Connected" status

  2. Check notification permissions

    iOS:

    Settings > Notifications > JetWings > Allow Notifications
    Ensure "Lock Screen" and "Banners" enabled

    Android:

    Settings > Apps > JetWings > Notifications > Enabled
    Check all notification categories enabled

  3. Review event filters

    Mobile app:

    Settings > Notifications > Event Filters
    Ensure event type not filtered out
    Check quiet hours not active

  4. Test with simple event

    Trigger a test build and watch IDE logs:

    Help > Show Log in Finder
    Search for: "Sending event: Build Completed"

Delayed Event Delivery​

Symptoms:

  • Events arrive 5+ seconds after IDE shows completion
  • Mobile lags behind IDE state

Solutions:

  1. Check network latency

    Test your internet connection speed. High latency (> 100ms) can cause delays.

  2. Verify mobile app is foreground

    iOS backgrounds apps aggressively. Keep app open or use push notifications.

  3. Check network routing

    Contact support if delays persist despite good network connection.

Duplicate Events​

Symptoms:

  • Same build notification appears twice
  • Event counter increments by 2

Cause:

JetWings automatically filters out duplicate messages.

Solutions:

  1. Verify deduplication is working

    Mobile app logs should show:

    "Duplicate event detected, filtering out"

  2. Report bug if issue continues

    This may indicate backend issue. Report with logs.

Command Execution Problems​

Commands Not Executing​

Symptoms:

  • Tap "Build Android" in mobile app
  • No response in IDE
  • Command appears "stuck"

Solutions:

  1. Verify run configuration exists

    IDE:

    Run > Edit Configurations
    Find: "Build Android"

  2. Check project is open

    Command requires matching projectPath. Verify:

    IDE: Project view shows project
    Mobile: Correct project selected

  3. Review command payload

    IDE logs:

    Help > Show Log in Finder
    Search for: "Received command: EXECUTE_RUN_CONFIGURATION"
    Check: configurationId and projectPath match

  4. Check command state

    Mobile app:

    Tap command > View Status
    Should show: PENDING → RUNNING → COMPLETED
    If stuck in PENDING: Connection issue
    If stuck in RUNNING: IDE issue

Command Fails Immediately​

Symptoms:

  • Error: "CONFIGURATION_NOT_FOUND"
  • Error: "PROJECT_NOT_FOUND"

Solutions:

  1. Configuration not found

    Verify configuration name exactly matches:

    IDE: Run > Edit Configurations > Configuration name
    Mobile: Should match exactly (case-sensitive)

  2. Project not found

    Verify project path:

    IDE: File > Project Structure > Project Settings
    Note: Full path
    Mobile: Ensure matches exactly

  3. Refresh configuration list

    Mobile app:

    Pull down to refresh
    Or: Settings > Clear Cache

Commands Execute But Output Missing​

Symptoms:

  • Command completes successfully
  • No output/summary shown in mobile app

Cause:

JetWings sends summaries, not full output.

Solutions:

  1. Check completion message

    Mobile should receive:

    RUN_CONFIGURATION_COMPLETED
    summary: "Build succeeded in 45s"

  2. For full output

    Return to IDE:

    View > Tool Windows > Build
    or
    View > Tool Windows > Run

  3. Check IDE logs for details

    Help > Show Log in Finder
    Search for: "JetWings"

Pairing Issues​

Pairing Code Doesn't Work​

Symptoms:

  • Enter code in mobile app
  • Error: "Invalid pairing code"
  • Error: "Pairing code expired"

Solutions:

  1. Check code expiration

    Pairing codes expire after 5 minutes. Request new code:

    IDE: Tools > JetWings > Show Pairing Code

  2. Verify code entry

    • Code format: ABC-DEF (6 characters)
    • Case-insensitive
    • No spaces

  3. Check network connectivity

    Both IDE and mobile must be online during pairing.

  4. Try different network

    Corporate networks may block pairing API. Try:

    • Personal hotspot
    • Home WiFi
    • Different internet connection

  5. Check IDE logs

    Help > Show Log in Finder
    Search for: "Pairing initiated"
    Look for: Error messages

Pairing Succeeds But Cannot Connect​

Symptoms:

  • Pairing completed successfully
  • Mobile shows IDE as "Closed" or "Offline"
  • Tapping IDE card does not connect

Solutions:

  1. Enable connections in IDE

    IDE:

    Tools > JetWings > Enable Connections

    Pairing does not enable connections. You must enable connections in the IDE, then connect from mobile.

  2. Check IDE status on mobile

    Mobile app should show:

    • "Open" - tap to connect
    • "Closed" - enable connections in IDE first
    • "Offline" - check IDE is running and has internet

  3. Verify firewall allows connections

    Check that your firewall allows outbound HTTPS connections.

IDE Performance Issues​

IDE Feels Slow After Installing JetWings​

Symptoms:

  • Lag when typing
  • Slow build start
  • UI freezes

Solutions:

  1. Check IDE logs for JetWings activity

    Help > Show Log in Finder
    Search for: "JetWings"

  2. Disable the plugin temporarily

    Settings > Plugins > JetWings > Disable

    Restart IDE and test if performance improves. If so, report the issue.

  3. Increase IDE memory

    Help > Edit Custom VM Options:

    -Xmx4096m  # Increase from default

High Memory Usage​

Symptoms:

  • IDE shows "Low memory" warning
  • IDE crashes with OutOfMemoryError

Solutions:

  1. Restart IDE

    File > Invalidate Caches and Restart

  2. Report issue if memory > 100 MB

    This indicates memory leak. Report bug with heap dump.

Mobile App Issues​

App Crashes on Launch​

Solutions:

  1. Update to latest version

    App Store / Play Store: Check for updates

  2. Clear app data

    iOS:

    Settings > General > iPhone Storage > JetWings > Delete App
    Reinstall

    Android:

    Settings > Apps > JetWings > Storage > Clear Data

  3. Check device compatibility

    Minimum requirements:

    • iOS 18.2+
    • Android 8.0 (API 26)+

  4. Report crash

    Report the issue on GitHub Issues with your app version and device info.

Push Notifications Not Working​

iOS Specific:

  1. Check notification settings

    Settings > Notifications > JetWings >
    ☑ Allow Notifications
    ☑ Lock Screen
    ☑ Banners
    ☑ Sounds

  2. Re-enable push permissions

    Delete and reinstall app to reset permissions.

  3. Check Do Not Disturb

    Settings > Focus > Do Not Disturb: Off

Android Specific:

  1. Check notification channels

    Settings > Apps > JetWings > Notifications >
    Enable all channels:
    - Build Events
    - Test Events
    - Git Events
    - General

  2. Battery optimization

    Settings > Battery > Battery Optimization >
    JetWings: Don't optimize

  3. Check notification priority

    Settings > Apps > JetWings > Notifications > Importance: High

Reporting Issues​

Before Reporting​

  1. Search existing issues

    GitHub: https://github.com/edgafner/jetwings/issues

  2. Gather information

    • Plugin version: Settings > Plugins > JetWings
    • IDE version: Help > About
    • Mobile app version: Settings > About
    • Operating systems (IDE and mobile)

  3. Collect logs

    IDE:

    Help > Show Log in Finder
    Find: Lines containing "JetWings"

    Mobile: Include app version from Settings > About.

  4. Create minimal reproduction

    • Simplest steps to reproduce issue
    • Expected vs. actual behavior
    • Screenshots/videos helpful

Issue Template​

**Plugin Version:** 2026.1.x
**IDE Version:** [Your IDE] 2025.3.1
**Mobile App Version:** 1.0.0 (iOS 17.0)

**Steps to Reproduce:**
1. Enable remote monitoring
2. Trigger "Build Android" from mobile
3. Observe: Command stuck in PENDING state

**Expected:** Command executes and completes
**Actual:** Command never starts

**Logs:** (attach IDE and mobile logs)

Quick Reference​

IDE Status Indicators​

IDE StatusMobile ShowsMeaning
Open (green)OpenIDE accepting connections
Closed (gray)ClosedIDE not accepting connections
N/AOfflineIDE not running or unreachable

Mobile Connection Status​

Mobile StatusMeaning
OpenCan tap to connect
ClosedMust enable connections in IDE first
OfflineIDE not running or unreachable
ConnectedActive connection to IDE
Connection lostConnection dropped, can retry

Common Error Codes​

CodeMeaningAction
PROJECT_NOT_FOUNDProject not openOpen project in IDE
CONFIGURATION_NOT_FOUNDRun config missingCheck config exists
UNAUTHORIZEDAuth token invalidRe-pair devices
CONNECTION_LOSTNetwork issueCheck internet
VERSION_MISMATCHPlugin and app major.minor version differUpdate the older component
COMMAND_TIMEOUTCommand too slowIncrease timeout

Support Resources​