Skip to content
Docs
Download

Quick start tutorial

This tutorial gets you from a fresh install to a project you can run and publish.

What you’ll do

Section titled “What you’ll do”
  1. Install the app and create a project.
  2. Open the project in the editor.
  3. Run the dev server and make a change with AI.
  4. (Optional) Publish and embed in Webflow.

Prerequisites

Section titled “Prerequisites”

Step 1 — Create a project

Section titled “Step 1 — Create a project”
  1. Launch Ssscript. You’ll see the entry screen with a logo and project list.
  2. Click Create project.
  3. Enter a project name (e.g. “my-site”).
  4. Choose a starter — Single entry (one production app.js) or Multi entry (per-page bundles from src/pages/). See Starters.
  5. Click Create. The app scaffolds the project and opens it.

Step 2 — Explore the editor

Section titled “Step 2 — Explore the editor”

Once the project opens, you’re in the workspace. Press ⌘2 / Ctrl+2 to switch to Code view if you’re not already there.

  • File tree (left) — browse your project files. The main code lives under src/.
  • Code editor (center) — click a file to open it. Try opening src/app.ts — the entry point.
  • AI panel (right) — your AI assistant. Toggle it with ⌘L / Ctrl+L.
  • Terminal (bottom) — install, run, and build. Toggle with ⌘J / Ctrl+J.

Step 3 — Run and edit

Section titled “Step 3 — Run and edit”
  1. Open the terminal panel (⌘J).
  2. Click Run to start the dev server. You’ll see output like Server running at http://localhost:6454.
  3. Open that URL in your browser to see the project running.

Now make a change using AI:

  1. Open the AI panel (⌘L) or switch to Agent view (⌘1).
  2. Type a prompt:
@@build Add a heading that says "Hello from Ssscript" and style it with a fade-in animation on load
  1. The AI writes the code. Review the diffs — if auto-apply is on, the changes are already saved. Check the browser to see the result (live reload updates automatically).

Step 4 — Publish (optional)

Section titled “Step 4 — Publish (optional)”

Once you’re happy with your project:

  1. Make sure you’re signed in (click the account banner if not).
  2. Click Publish in the header.
  3. Confirm the deploy URL and click Publish now.
  4. When complete, your project is live at https://ssscript.dev/<username>/<project>/.

To embed in Webflow, open Embed from the terminal panel, copy the snippets, and paste them into your Webflow site’s custom code. See Embedding in Webflow for detailed instructions.

Next

Section titled “Next”