Quick Starts Overview

Wix Headless has several quick starts. The right one depends on what you already have and how much you want Wix to manage. To learn more about the options, see Choose Your Development Path.

The quick starts fall into two paths:

• Wix-managed headless (recommended): Wix hosts and runs your frontend. It's based on Astro — scaffold with AI or the CLI, or link an existing Astro project — and Wix's Astro integration handles authentication for you too.
• Self-managed headless: You host your frontend and handle authentication yourself, connecting to Wix only for business data and APIs.

Wix-managed headless

Wix hosts and runs your frontend and connects it to Wix business solutions. When building with Astro, which is the default when scaffolding with AI or the CLI, Wix's Astro integration handles authentication for you and lets you add extensions.

Quick Start	Best for	Framework	Authentication
Quick Start with AI	Getting to a deployed project fastest, from a prompt	New Astro project	Automatic
Quick Start with the Wix CLI	Scaffolding a new project from your terminal	New Astro project	Automatic
Quick Start from an Existing Astro Project	Linking an Astro project you already have	Existing Astro project	Automatic
Quick Start from Claude Design	Sending a Claude Design build directly to Wix	Claude Design	You set up
Quick Start from Your Own Frontend	Deploying an existing single-page app to Wix hosting	Existing SPA	You set up

Self-managed headless

You host your frontend and handle authentication yourself. Wix provides the business data and APIs.

Quick Start	Best for	Framework
Quick Start a Self-Managed Headless Project	Full control over framework, hosting, and auth	Any
Start from an Existing Wix Site	Extending a site you already have with a new frontend	Any

See also

• Choose Your Development Path
• Headless AI Toolkit