Fix problems with Design Language Connect
What to do when Connect won't open, can't reach the portal, or can't connect a tool.
Find what you see below. When a row in Design Language Connect shows an error, it uses the tool's own message; Settings › General › Show the log has the details.
Installing and opening
| What you see | What to do |
|---|---|
| macOS says it can't check the app | Choose Done, then in System Settings › Privacy & Security choose Open Anyway. You do this once; updates need no approval. |
| Windows says it protected your PC | Choose More info, then Run anyway. You do this once. |
| Windows asks for Microsoft Edge WebView2 | Older PCs may not have it. Choose Yes to download it from Microsoft, install it, then open Connect again. |
| Ubuntu 22.04's store can't install the package | Run sudo apt install ./design-language-connect.deb in your Downloads folder. |
| No icon by the clock on Ubuntu | Ubuntu shows it through its AppIndicator extension, on by default. Other GNOME desktops need the "AppIndicator and KStatusNotifierItem Support" extension. Without it, open the window from your apps. |
| The window stays blank on Ubuntu | Start it from a terminal with design-language-connect and send the messages it prints to your admin. |
Connecting and updating
| What you see | What to do |
|---|---|
| Can't reach the portal | Check Portal address in Settings › General and that the portal is up, then choose Try again. You can still disconnect tools; connecting and updating need the portal. |
| Needs Node.js 20 or later | Choose Get Node.js, install it, then choose Check for updates. |
Needs the claude or codex command | Install Claude Code or Codex, then choose Check for updates. |
| No supported tools on this computer yet | Install a supported tool, then choose Check for updates. A tool appears once it's installed. |
| The design language is already in Codex or Claude Code from another place | It came from a team marketplace or another folder. Update it there, or remove it and connect it in Connect. |
Signing in
| What you see | What to do |
|---|---|
| This code isn't valid any more | Codes last 10 minutes and work once. Choose Sign in in Connect again. |
| Your sign-in expired or was revoked on the portal | Choose Sign in again. VS Code, Cursor and Antigravity rows then offer Update to refresh their sign-in. |
| Your browser can't reach the approval page | Use Paste a token: see Sign in to Connect. |
| The approval page says access tokens aren't in your plan | Ask your admin. |
Still stuck
Send your admin what the row or alert says and the relevant lines from Show the log. If you can't use the app at all, the same engine runs in a terminal: see Use Connect from the terminal.