About Wix-Managed Headless

Wix-managed headless provides a fully managed solution for developing and hosting your headless project. Unlike self-managed headless, you don't need to configure authentication or manage hosting infrastructure.

Benefits

The benefits of Wix-managed headless include:

• Hosting: Wix handles all builds and deployments, including a global CDN and SSL.
• Automatic scaling: The infrastructure automatically scales to meet traffic demands.
• Simplified setup: Includes automatic OAuth setup and pre-configured environment variables.
• Framework versatility: Built on the Astro framework, allowing you to use components from React, Vue, Svelte, or Solid.
• AI-powered bootstrapping: Ability to use Wix Vibe to generate a full UI and project structure from conversational prompts.

Authentication

One of the biggest advantages of Wix-managed headless is automatic authentication:

• Visitors: The CLI automatically generates and manages visitor tokens in the background. This means anonymous visitors can add items to carts, make bookings, and interact with your site without you writing any authentication code. Session data persists across page visits automatically.
• Members: The CLI provides built-in /api/auth/login and /api/auth/logout endpoints that handle the entire login flow. Just link to these endpoints and the CLI takes care of redirecting to the Wix login page, exchanging tokens, and managing the authenticated session. Learn how to implement member login.
• Admin operations: For server-side tasks like managing products or processing orders, you can use API keys. This method of authentication works the same as in self-managed headless.

You can call Wix JavaScript SDK methods directly without setting up OAuth, creating a Wix client, or managing tokens yourself.

Get started

There are two ways to start a Wix-managed headless project. Both approaches use the Wix CLI for ongoing development and deployment.

Wix Vibe

Wix Vibe is an AI-powered tool that generates a full UI and project structure from conversational prompts. Describe what you want to build, and Vibe creates a working project as a starting point.

After bootstrapping with Vibe, continue development in the Vibe editor or open the project in your preferred IDE and use the Wix CLI.

Wix CLI

The Wix CLI is a command-line tool for creating, developing, and deploying Wix headless projects. Use the CLI to start a project from scratch with full manual control, or to continue developing a project bootstrapped with Vibe.

Quick Start a Wix CLI Headless Project

See also

• About Wix Vibe
• About the Wix CLI