Skip to content
Docs
Download

Troubleshooting

AI edits

Section titled “AI edits”

”AI auth token is missing” or AI panel won’t send

Section titled “”AI auth token is missing” or AI panel won’t send”
  • Sign in again and resend your prompt.
  • If it keeps happening, fully sign out and sign back in.

AI shows “No code changes were proposed”

Section titled “AI shows “No code changes were proposed””
  • This is a valid outcome when your prompt is too broad or asks only for analysis.
  • Try a concrete follow-up: mention exact file names and the expected result.
  • If you used @@plan or @@explore, these modes intentionally do not produce edits.

Runtime doesn’t start

Section titled “Runtime doesn’t start”
  • Wait for the AI status to move past [connecting] Ssscript.
  • If it stays stuck, restart the app and retry from the same project.
  • Check the connectivity icons in the header — the cloud icon shows runtime status and the AI icon shows key status.

I hit a real AI error and want help

Section titled “I hit a real AI error and want help”
  • If the AI panel shows a hard error (red / error state), use Report this error (you must be signed in). That sends a sanitized diagnostic bundle — see Bug reports & AI diagnostics.
  • For silent crashes or app-wide errors, a toast may offer to submit a bug report automatically.

Build & publish

Section titled “Build & publish”

Build fails in the app

Section titled “Build fails in the app”
  • Open the terminal panel and run Install first.
  • Then run build again and fix any reported errors before publishing.

Publish button disabled or publish fails

Section titled “Publish button disabled or publish fails”
  • Confirm you are signed in.
  • Confirm you have an active subscription if publishing is gated.
  • Use the Publish overlay status:
    • Building project… means local build is in progress.
    • Uploading build output… means hosted upload is in progress.
    • Publish failed: … includes the immediate failure reason.

I want to verify what is live on Cloudflare

Section titled “I want to verify what is live on Cloudflare”
  • In the Publish modal, click Current Files (top-right).
  • Use the file list to open asset URLs directly and verify what is currently deployed.
  • In the same modal, check Last published at for a quick freshness check.

I need to undo a publish

Section titled “I need to undo a publish”
  • Use the Rollback action in the Deploy overlay to restore the previously deployed version. See Deploy & embed — Rollback for details.

Projects

Section titled “Projects”

Where are my projects stored?

Section titled “Where are my projects stored?”
  • Projects live under the app data directory (e.g. on macOS: ~/Library/Application Support/.../projects). Use Open projects folder from the entry screen to open that folder.

Can’t open a project

Section titled “Can’t open a project”
  • Ensure the project folder contains a valid project.json. If you moved the folder, you may need to open it via Open projects folder and then open the project from the list again.

Integrations

Section titled “Integrations”

Webflow won’t connect

Section titled “Webflow won’t connect”
  • Make sure you are signed in with a Webflow account that has access to the site you want to link.
  • If the connection modal stalls during OAuth, try closing and reopening it.
  • Check your internet connection — the OAuth flow and MCP both require an active connection.

Figma Dev Mode doesn’t appear

Section titled “Figma Dev Mode doesn’t appear”
  • Figma Dev Mode MCP requires a valid Figma access token. Follow the setup steps in Figma integration to configure it.
  • If you previously set a token and it expired, reconfigure from the Figma connection modal.

Account & credits

Section titled “Account & credits”

How do I check my remaining credits?

Section titled “How do I check my remaining credits?”
  • Open the Account screen from the app header. The Usage section shows credits used vs total available, with a progress bar and reset date.

I ran out of credits

Section titled “I ran out of credits”
  • Buy a credit refill (€10 or €20 top-up) from the Account screen. Credits are added instantly.
  • Alternatively, wait for your billing period to renew — included credits refill automatically.

How do I upgrade my plan?

Section titled “How do I upgrade my plan?”
  • Open Account and click the plan upgrade button. Checkout opens in your browser via Polar. See Account & auth — Plans for plan details.

Connectivity & updates

Section titled “Connectivity & updates”

The app says “Connect to the internet”

Section titled “The app says “Connect to the internet””
  • Ssscript requires an internet connection for AI, publishing, and account features. When offline, the app shows a connection prompt on the entry screen. Local editing still works once a project is open, but AI and publish are unavailable.

I got an update notification

Section titled “I got an update notification”
  • When a new version is available, the app shows a toast with the release notes and a download link. Click the link to download the latest version. You can also check the Changelog for details.
  • On macOS, download the new .dmg and replace the existing app. Your projects and settings are preserved.

For step-by-step usage, see AI edits, Deploy & embed, and Embedding in Webflow.