FAQ

Quick answers to common questions. For step-by-step fixes, see Troubleshooting.

Projects

Where are my projects stored?

Under the app data directory (e.g. on macOS: ~/Library/Application Support/com.federicovalla.ssscript/projects/). Use Open projects folder on the entry screen. See Project structure.

Can I open a project created outside the app?

Yes — place the folder in the projects directory (with a valid project.json if possible) and open it from the entry screen list.

What’s the difference between Single entry and Multi entry?

Single entry ships one production bundle (app.js). Multi entry builds per-page scripts from src/pages/ for sites where each Webflow page loads its own file. See Starters.

Do I need to install Bun or Node?

No. The app ships and manages a pinned Bun version for dev server, builds, and the agent runtime. See Bun runtime.

Editor & code

Which files can I edit?

Primarily src/ (modules, styles, lib) and biome.json at the project root. Other paths are read-only in the editor. See Project structure — Editable paths.

Can I add HTML files for Webflow layout?

No. Markup lives in Webflow Designer. Modules receive existing DOM via data-module and data-* hooks. See Module system.

Where does CSS go?

Layout and typography belong in Webflow. Repo CSS is only for Webflow-impossible cases (keyframes, pre-JS hidden states) in src/styles/mod/<name>.css.

AI

AI prompt sending and hosted features require an account. Local editing and the dev server work without signing in. See Install the app.

Can I use a different AI provider or model?

The app routes model traffic through the Ssscript web API. You pick a model from the AI panel header; provider keys stay server-side. See AI edits — Models.

What are `/build`, `/plan`, and `/general`?

Agent modes you pick by typing / in the prompt: build edits code, plan analyzes without editing, general handles broader multi-step work. There is no /webflow or /figma mode — those tools turn on automatically when connected. See AI edits.

The AI didn’t change any files — is that normal?

Yes, for analysis-only prompts or /plan mode. Try a concrete follow-up with file names and expected outcomes.

Webflow & deploy

Where do I paste the loader script?

Site or page Custom Code → Head in Webflow. Use the Embed modal in the app to copy or apply the unified loader. See Embedding in Webflow.

How does dev vs production loading work?

On .webflow.io staging, the loader tries the local dev server first and falls back to your deployed URL. On production domains, it loads deployed assets directly.

How do I connect Webflow MCP?

Sign in and link a site per project. Once connected, the agent uses Webflow tools automatically in /build. See Webflow integration.

Publish failed — what now?

Check sign-in, subscription status, and the Publish overlay error. Run Install then build from the terminal panel. See Troubleshooting — Build & publish.

Account & billing

How do I check credits?

Open Account from the app header. See Account & auth.

Can I use Ssscript offline?

Local editing works once a project is open. AI, publish, and account features require internet.

I saw an announcement toast on startup — what is it?

Occasionally the Ssscript team broadcasts a short announcement (for example, a notable release or service note) that appears as a toast when the app launches. Dismiss it with OK; each message shows only once. It’s separate from update notifications.

Is there a component library?

Yes. Open the command palette (⌘⇧P) with a project open and run Open component library to browse curated blocks and copy their JavaScript. See Component library.

FAQ