Wave

Wave is a storefront app with a visual editor and an AI agent built in. Describe a change in plain words and the agent makes it on your store's own pages, or click any section and edit it yourself. Wave works with the Tide theme, which supplies the starting sections and page templates, and shoppers check out on Swell's hosted checkout.

Wave is free. The agent's AI use is billed from your store's AI credits; the rest of the editor doesn't use AI.

Set up Wave in your test environment first, and place a test order there before you go live.

Every page of the store is a live card on one board, in three groups:

Click a card to open it, scroll to pan, and press Ctrl or ⌘ while you scroll to zoom. Fit shows every page. The rail on the left lists the same pages; open one to see its sections. Tags such as New and Changed mark what the draft changed.

The right panel has three tabs:

The top bar shows the save status, Versions, Preview (the draft at desktop, tablet or mobile width) and Publish. Press ? for keyboard shortcuts.

Describe the result you want, on the page you mean. Select a section first, or press /, and your message is about that section. For example:

While the agent works, a status line says what it is doing, and each page it touches shows AI editing. Stop ends the turn. A message you send while it works steers the turn instead.

The agent can:

The agent can't:

The agent won't invent store facts such as policies, prices, product specs, reviews, people, awards or contact details. When a page needs one you haven't given it, it asks, or writes a labelled placeholder such as "[Your return policy]" and lists the placeholders in its reply. Sample content says it is a sample on the page itself. Check for placeholders before you publish.

Ask for an image and the agent generates it (square, wide or tall), saves it to your store's files and sets it on the section. It makes at most 3 images per message and 10 per chat. Upload your logo and favicon in the Theme tab.

Every change the agent makes is test-rendered on each page that uses it before it is saved. A change that fails isn't saved, and the agent gets the reasons so it can fix them.

Click a section on the board to open it in the Inspector. Changes save as you type, and Revert puts the page back as it was when you selected the section. You can also click a line of text on the page and type over it. Text that comes from your store, such as a product name, is edited in the dashboard instead.

Content pages are your store's Swell pages, at /pages/<address>. Add one with Add page, or ask the agent. Each has a name, address, text, layout, visibility, and an SEO title and description. Changing the address redirects the old one. Remove from store unpublishes a page; it is never deleted.

Templates lay out every product, category, blog post and policy page. Product grids, product details, category lists, search results and blog posts come from your catalog. A product, category or page can use an alternate layout of its template.

Menus are your storefront's Swell menus, the same ones as the dashboard's navigation. Edit them from a header or footer section's menu field: add, nest, reorder and remove links to pages, products, categories, blogs or any address.

Content page and menu edits stay in the draft until you publish.

Ask the agent to change colors, fonts, corner radii or the shadow. Each change applies to every page at once. Fonts are chosen from fonts already installed on shoppers' devices; web fonts aren't available yet.

Everything you and the agent change is a draft. Preview shows the draft as shoppers will see it. Publish lists every changed page, section, menu and content page, then makes them live together. It won't publish while a section fails to render, or while the agent is still working. After a publish, shoppers get the new pages on their next page load.

A version is saved before the agent changes the theme, when you publish, as you edit, and when you choose Save version. Open Versions to preview any of them or restore it. Your draft is saved as a version first, so a restore can be undone. Restoring changes the theme only: menus, content pages and store content stay as they are.

Automatic versions are kept 30 days, named ones until you delete them, and published ones for a year. Inline text edits can also be undone with Ctrl or ⌘ + Z while the undo notice shows.

Apps can offer storefront widgets. In the Inspector, Add section lists them under Apps, with a field for each of the widget's settings, or you can ask the agent to place one. In the editor a widget shows as a labelled placeholder; it runs on the storefront.

The agent, image generation and chat titles use AI through Swell. AI use is billed from your store's AI credits, at the AI provider's price plus 20%, and each store starts with $5 of included credits. Check Allow AI in Wave's install dialog, or turn on Allow this app to use AI later on the app's Overview page. Only the store owner and users who can manage apps can change it.

The agent panel tells you when it can't run:

Store-wide settings are on the editor's Theme tab. Colors, fonts, corner radii and the shadow are changed by asking the agent.

A value broke a section. The reasons are listed; change the value, or ask the agent to fix it.

The editor retries on its own, then offers Try again.

Someone else edited the same field. Use mine keeps your change.

Send the message again.

A section fails to render. Show finds it, and Ask the agent to fix it sends the agent the error.

The section shows labelled samples where your store has no data yet. Shoppers don't see the samples.

Edit the text in the dashboard, for example on the product.

A newer version of the editor is available. Reloading keeps your page, selection and unsent message.

Cached pages refresh within a few minutes.

See the messages under AI credits above.

If the Wave storefront is your published one, publish another storefront first. Then in Online Store > Storefront, open the Wave storefront's ⋮ menu and choose Delete storefront.

Then go to Apps > Wave and choose Uninstall app. Uninstalling applies to the environment you are in, so remove the app from the test and live environments separately. Your products, customers and orders aren't affected.

Published content pages and menus are your store's own Swell pages and menus, so they stay after you uninstall. Unpublished drafts of sections, pages and menus are kept with the Wave storefront and are deleted with it.

A storefront's theme is a set of Swell theme files:

The editor and the agent write the draft copy, and Publish copies it to the live one. Section fields are text, textarea, url, image, select and lists, plus data fields, such as a product, a product list, a category list, a menu or a content page, that Wave fills from Swell when it renders.

Pages are rendered on the server, each store's code in its own isolated worker. Section code never runs in the shopper's browser: imports are limited to React and the component kit, and every rendered section passes a strict HTML check. A section that fails is left out of the live page. Anonymous live pages are sent with s-maxage=60, stale-while-revalidate=300; carts, accounts and drafts are never shared.

Wave stores its own data in these collections on your store:

Images the agent generates are saved to the store's files. A model function tells the storefront when catalog and content data it shows changes, and a nightly function removes expired versions and chats.

An app declares its widgets in its own swell.json:

{
  "storefront": {
    "embeds": {
      "script": "frontend://embed.js",
      "blocks": [
        {
          "id": "size_chart",
          "label": "Size chart",
          "description": "A size table for the current product",
          "icon": "ruler",
          "props": [
            {
              "id": "title",
              "type": "text",
              "label": "Title",
              "default": "Sizes"
            }
          ]
        }
      ]
    }
  }
}

Wave loads script from the app's frontend only on pages that place one of its blocks. Each placement is an element with data-app-embed="<app>/<block>" and its settings as JSON in data-app-props; what's inside it is the fallback shoppers see without JavaScript. Prop types are text, textarea, url, number, boolean and select. The optional connect and img lists name the https origins the script may call and load images from.

Swell builds and maintains the Wave app. For help with it, email support@swell.is.