> 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: About Wix-Managed Headless ## Article: About Wix-Managed Headless ## Article Link: https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/about-wix-managed-headless.md ## Article Content: # About Wix-Managed Headless Wix-managed headless is the recommended path for building headless projects on Wix. It's a fully managed solution that combines Wix [business solutions](https://dev.wix.com/docs/go-headless/get-started/overview/wix-headless-business-solutions.md) with managed infrastructure, automatic authentication, and a modern development stack, so you can focus on building your frontend while Wix handles the backend complexity. Unlike [self-managed headless](https://dev.wix.com/docs/go-headless/develop-your-project/self-managed-headless/about-self-managed-headless.md), you don't need to configure OAuth, manage authentication tokens, or set up hosting. Wix handles builds, deployments, scaling, and security for you. ## Benefits When you create a Wix-managed headless project, you get a complete development environment backed by Wix infrastructure: - **Managed hosting with global CDN**: Wix builds, deploys, and serves your project on a global content delivery network with automatic SSL certificates. The infrastructure scales automatically to meet traffic demands. - **Automatic authentication**: Visitor sessions, member login flows, and token management are all handled for you. You can call [Wix SDK](https://dev.wix.com/docs/sdk.md) methods directly in your code. The SDK is pre-configured with the right credentials, so there's no client setup or token management required. - **Astro-based framework**: Your project is built on the [Astro](https://astro.build/) web framework, which gives you fast, server-rendered pages with the flexibility to use components from React, Vue, Svelte, or Solid wherever you need them. - **Extend with custom backend logic and dashboard UIs**: Use [extensions](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/core-concepts/about-extensions.md) to handle events like order placements, customize business logic, and build management interfaces that appear in the Wix dashboard. - **Analytics tracking**: [Track events](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/analytics-events/track-analytics-events.md) like page views, cart actions, and purchases, and forward them to connected analytics platforms such as GA4 and Facebook Pixel. ## Ways to work with Wix-managed headless You can develop Wix-managed headless projects through code with the [Wix CLI](#wix-cli), through a visual UI with [Wix Vibe](#wix-vibe), or with a combination of both. ### Wix CLI The [Wix CLI](https://dev.wix.com/docs/wix-cli/guides/about-the-wix-cli.md) is the code-first approach. You develop locally in your preferred IDE, use standard coding practices, and deploy through the CLI. The Wix-Managed Headless documentation focuses on this approach, covering the [architecture](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/core-concepts/architecture-and-project-structure.md), [authentication model](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/authentication/authentication-and-api-integration.md), [extensions](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/core-concepts/about-extensions.md), and [development workflow](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/core-concepts/development-build-and-deployment.md) of CLI-based headless projects. To get started, see [Quick Start with the Wix CLI](https://dev.wix.com/docs/wix-cli/guides/get-started/quick-start-a-headless-project.md). ### Wix Vibe [Wix Vibe](https://dev.wix.com/docs/go-headless/wix-vibe/about-wix-vibe.md) is a UI-based approach that lets you create, edit, and manage your project using conversational AI prompts. You describe what you want to build, and Vibe generates the project structure, pages, and components for you. Projects started in Vibe can always be opened locally and developed with the CLI. To get started, see [Build with Wix Vibe](https://dev.wix.com/docs/go-headless/wix-vibe/about-wix-vibe.md). ## Create a project You also don't need to create the project in the Wix dashboard first. To create a Wix-managed headless project with the CLI, run the [create command](https://dev.wix.com/docs/wix-cli/command-reference/project-creation/create-headless.md). The command provisions the business and site for you and scaffolds the local codebase in 1 step. A business is the workspace in your Wix account that holds a single site, its dashboard, and settings such as billing. Each business appears on the [Sites page](https://manage.wix.com/account/sites) of your Wix account, and one Wix account can hold multiple businesses. For a full walkthrough, see [Quick Start a Headless Project](https://dev.wix.com/docs/wix-cli/guides/get-started/quick-start-a-headless-project.md). ## Key concepts The following articles explain the core concepts behind Wix-managed headless projects: - [Architecture and project structure](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/core-concepts/architecture-and-project-structure.md): The Astro framework, project file structure, private app, and hosting infrastructure that power your project. - [Authentication and API integration](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/authentication/authentication-and-api-integration.md): How automatic authentication works for visitors, members, and admins, and how you call Wix APIs in your code. - [Extensions](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/core-concepts/about-extensions.md): Backend event handlers, service plugins, and dashboard UIs that extend your project beyond the frontend. - [Development, build, and deployment](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/core-concepts/development-build-and-deployment.md): Local development with hot reloading, the build-preview-release workflow, environment variables, and AI-assisted development with Wix Skills. When you're ready to start building, see [Get Started](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/get-started.md) for a guide to choosing your entry point and next steps. ## Comparison with self-managed headless Self-managed headless gives you full control over your framework, hosting, and authentication setup. Wix-managed headless trades some of that flexibility for a faster, more automated development experience. For a detailed comparison of both paths, including a feature-by-feature table, see [About Headless Development Paths](https://dev.wix.com/docs/go-headless/develop-your-project/about-headless-development-paths.md). ## See also - [About Wix Headless](https://dev.wix.com/docs/go-headless/get-started/overview/about-wix-headless.md) - [About Headless Development Paths](https://dev.wix.com/docs/go-headless/develop-your-project/about-headless-development-paths.md) - [Wix Headless Business Solutions](https://dev.wix.com/docs/go-headless/get-started/overview/wix-headless-business-solutions.md) - [About the Wix CLI](https://dev.wix.com/docs/wix-cli/guides/about-the-wix-cli.md) - [About Wix Vibe](https://dev.wix.com/docs/go-headless/wix-vibe/about-wix-vibe.md)