> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Quick Start with AI

## Article: Quick Start with AI

## Article Link: https://dev.wix.com/docs/go-headless/get-started/quick-starts/wix-managed-headless/quick-start-with-ai.md

## Article Content:

# Quick Start with AI

Go from a single prompt to a deployed Wix-managed headless project. You describe what you want to build, and your AI agent scaffolds the project, provisions the business and site, and deploys it for you. Then you keep prompting to extend it.

This is the fastest way to start. There's nothing to install to try it.

## What you can build

With a single prompt, your agent can build and deploy a complete, working site backed by Wix business solutions: a store, a booking system, a blog, and more.

Describe what you want in plain language:

- *Build a storefront for handmade ceramics with a product catalog and checkout.* ([Wix Stores](https://dev.wix.com/docs/api-reference/business-solutions/stores/introduction.md))
- *Build a booking site for a yoga studio with class schedules and online payments.* ([Wix Bookings](https://dev.wix.com/docs/api-reference/business-solutions/bookings/introduction.md))
- *Build an events page that sells tickets.* ([Wix Events](https://dev.wix.com/docs/api-reference/business-solutions/events/introduction.md))
- *Build a portfolio site for an architecture firm, with projects managed in a CMS.* ([Wix CMS](https://dev.wix.com/docs/api-reference/business-solutions/cms/introduction.md))
- *Build a membership site for a fitness coach with gated, members-only content.* ([Wix Members](https://dev.wix.com/docs/api-reference/crm/members-contacts/members/introduction.md))

Learn more about [featured business solutions for Wix Headless](https://dev.wix.com/docs/go-headless/project-guides/featured-business-solutions.md).

<blockquote classname="tip">

**Tip**: The more detail you give, such as the desired pages, data, and design, the more complete the result. For ready to adapt examples, see the [prompt recipes](#prompt-recipes).

</blockquote>

## Before you begin

Make sure you have:

- [Node.js](https://nodejs.org/en/) (v20.11.0 or higher).
- A Wix account. If you don't have one, [sign up](https://manage.wix.com/account/custom-apps).
- An AI client such as Claude Code, Cursor, Codex, or GitHub Copilot in VS Code.

## Step 1 | Build with a single prompt

[wix-headless.dev](https://wix-headless.dev/) hosts a [skill.md](https://www.wix-headless.dev/skill.md) file that instructs your AI agent on how to scaffold and deploy a Wix-managed headless project using the [Wix CLI](https://dev.wix.com/docs/wix-cli.md). You don't need to install anything to use it.

In your AI client, describe what you want to build and include the skill URL. For example:

```text
Build a storefront for handmade ceramics using https://www.wix-headless.dev/skill.md
```

The agent provisions the business and site for you and scaffolds the local codebase in one step. For more detailed, ready-to-adapt prompts, see [Prompt recipes](#prompt-recipes).

## Step 2 | Find your project

Your project lives in two places:

- **On Wix**: It appears in your [Wix dashboard](https://support.wix.com/en/article/about-your-wix-dashboard) alongside your sites. From there you can open the live URL, manage the site, or connect a custom domain.
- **On your computer**: The project's code is saved as a folder. Your agent chooses where to put it, so if you're not sure, ask it where it saved the project and note the location. You'll need it to keep editing later.

## Step 3 (Recommended) | Install the Wix plugin for ongoing work

The single-prompt skill is enough to scaffold and deploy. For ongoing development, install the [Wix plugin](https://dev.wix.com/docs/go-headless/get-started/headless-ai-toolkit.md#install-the-wix-plugin) in your AI client. It adds [Wix Skills](https://dev.wix.com/docs/api-reference/articles/ai-tools/about-wix-skills.md) and the [Wix MCP](https://dev.wix.com/docs/api-reference/articles/ai-tools/wix-mcp/about-the-wix-mcp.md) together, giving your agent persistent Wix context so it can search Wix docs, scaffold code, and call Wix APIs directly from your chat.

## Step 4 | Keep building

Keep prompting your agent to add features and functionality. Define your data model, add authentication, build UI, and redeploy. You can also continue developing manually with the [Wix CLI](https://dev.wix.com/docs/wix-cli.md) at any time.

You don't need to stay in the same chat to keep working. To pick your project back up later, start a new chat with your agent in the project folder from Step 2 and tell it what you want to change. As long as the agent is working in that folder, it has your code and can keep building.

## Best practices

For the best result, follow these best practices:

- **Structure your prompt.** Group your requirements into functionality, pages, and design so the agent can work through them methodically.
- **Name your data and its schema.** Specify required collection names and fields with their types. For example, a 'projects' collection with Project Name (text), Main Image (image), and Location (text).
- **Ask to seed example content.** Request realistic sample data so the site looks complete out of the box and is easy to review.
- **Specify Wix business solutions.** If you know you need Wix Stores, Bookings, Blog, or the CMS, say so to point the agent at the right APIs.
- **Mention authentication early.** If members need to log in, say so up front so the agent sets it up from the start.
- **Describe behavior, not structure.** Tell the agent what site visitors should be able to do, and let it choose the implementation.
- **Call out responsiveness and accessibility.** Ask for a mobile-friendly layout, good color contrast, and alt text so the result is production-ready.
- **Iterate.** Build the smallest working version first, then keep prompting to extend it.

## Prompt recipes

A short prompt gets you started, but a detailed one gets you a finished site. The recipes below show how to structure a thorough prompt: group your requirements into functionality, pages, and design, name your data up front, and ask the agent to seed realistic example content.

### Portfolio site with a CMS

```text
Using the Wix Headless skill at https://www.wix-headless.dev/skill.md, create a new site hosted on Wix for an architecture firm named Atelier Mercer to showcase their projects.

FUNCTIONALITY
- Use Wix CMS to store projects in a collection named 'projects' with this schema: Project Name (text), Main Image (image), Description (rich text), Location (text), Image Gallery (media gallery), Architect (text), Display on Site (boolean).
- Seed the collection with 10 realistic example projects so the site looks complete out of the box.
- Anywhere projects are listed, only render items where 'Display on Site' is true.
- Generate a detail page for each project dynamically, using the Project Name for a clean URL slug.

PAGES
- Home: full-bleed hero with the firm name and tagline, then a featured grid of projects.
- Projects: full grid of projects where Display on Site is true (each card shows Main Image, Project Name, and Location).
- Project detail: large image, name, location, architect, description, and the image gallery.
- About and Contact pages, with a contact form.

DESIGN
- Minimalist, editorial, and image-forward, with a near-monochrome palette and one subtle accent color.
- Refined serif headings paired with a clean sans for body text; generous whitespace and a strict grid.
- Fully responsive (single-column grid and hamburger nav on mobile) and accessible (good contrast, alt text driven from project data, keyboard-navigable galleries).
```

### Online store with Wix Stores

```text
Using the Wix Headless skill at https://www.wix-headless.dev/skill.md, create a new site hosted on Wix for a pet shop. Use Wix Stores for the catalog and Wix's native checkout.

FUNCTIONALITY
- Use Wix Stores to manage the catalog. Create 5 example products: dog food, cat food, a bird cage with a "Size" option (Small, Medium, Large, each priced differently), a fish tank with a "Capacity" option (20L, 40L, 60L, each priced differently), and a pet toy bundle.
- Give each product a realistic name, description, price, and at least one image, and assign products to sensible categories (Dogs, Cats, Birds, Fish, Accessories).

PAGES
- Home: hero with the shop name and tagline, a few featured products, and links to categories.
- Shop: product grid with image, name, price, and add-to-cart, filterable by category.
- Product detail: images, name, description, price, variant and quantity selectors, and add-to-cart.
- Cart: line items, quantity controls, subtotal, and a checkout button.
- About and Contact pages.
- Persistent header with logo, nav, and a cart icon showing the item count; footer with contact info.

DESIGN
- Friendly, warm, and approachable, but clean and trustworthy for e-commerce.
- Warm palette (creams, soft neutrals) with one or two cheerful accent colors for buttons and highlights.
- Rounded, friendly heading typeface paired with a clean, legible sans for body text.
- Fully responsive and accessible (good contrast, image alt text, keyboard-navigable nav and cart).
```

## See also

- [Headless AI Toolkit](https://dev.wix.com/docs/go-headless/get-started/headless-ai-toolkit.md)
- [About Wix-Managed Headless](https://dev.wix.com/docs/go-headless/wix-managed-headless/about-wix-managed-headless.md)