JetBrains Plugin Troubleshooting

This repository details the resolution of common challenges encountered when deploying Sypha within the JetBrains family of IDEs (IntelliJ IDEA, WebStorm, PyCharm, Android Studio, etc.).

Visual Interface Issues (JCEF)

Sypha utilizes the Java Chromium Embedded Framework (JCEF) to render its interactive interface within your IDE. If the Sypha panel does not load or displays a warning, your current IDE runtime may not have JCEF enabled.

Resolving JCEF in Android Studio

1. Open Settings (Windows/Linux) or Preferences (macOS).
2. Use the "Find Action" (Shift+Cmd+A) to search for "Choose Boot Java Runtime..."
3. Select a runtime version that explicitly includes "with JCEF" in its title.
4. Restart Android Studio to initialize the new environment.

Coming Soon !!!

Resolving JCEF in IntelliJ & Others

Modern versions of IntelliJ typically include JCEF by default. If issues persist:

1. Ensure your IDE is updated to the latest stable release.
2. Verify you are using the official JetBrains Runtime (JBR).

Authentication Synchronization

The Redirect Requirement

Sypha’s authentication cycle redirects from your browser back to the IDE using the jetbrains:// protocol.

[!IMPORTANT] For the browser to recognize this protocol, you must have the JetBrains Toolbox App installed. Without the Toolbox, the authentication token cannot be passed securely back to Sypha.

Manual Authentication Backup

If you are unable to install the Toolbox:

1. Navigate to Sypha Settings within your IDE.
2. Manually insert your API key or authentication token into the provider configuration field.
3. Save and refresh the connection.

System Prerequisites

Node.js Integration

Sypha requires a local installation of Node.js to manage its high-concurrency background services.

• Support: We recommend the latest LTS (Long Term Support) version.
• Verification: Ensure node --version returns a valid identifier in your system terminal.