> 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/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 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/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. For a working example built with Wix-managed headless, see [wix-headless.dev](https://wix-headless.dev/). ## Create a project ::::tabs :::Create-with-AI You can build a fully customizable headless project with a single prompt. [wix-headless.dev](https://wix-headless.dev/) is a reference site containing a [skill.md](https://www.wix-headless.dev/skill.md) that instructs your AI agent on how to scaffold and deploy a Wix-managed headless project using the [CLI](https://dev.wix.com/docs/wix-cli.md). To start, describe to your AI agent what you want to build and include the skill URL: ```bash "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 1 step. Your new project appears in your [Wix dashboard](https://support.wix.com/en/article/about-your-wix-dashboard) alongside your sites. Use [Wix AI tools](https://dev.wix.com/docs/api-reference/articles/ai-tools/about-ai-tools.md) to enhance your agent's context and capabilities with Wix. Continue prompting your agent to extend your project's features and functionality. You can also continue developing manually with the CLI. ::: :::Create-with-the-CLI The following command creates a Wix-managed headless [Astro](https://astro.build/) project. You can build the UI with React, Vue, Svelte, Solid, or other Astro integrations. If you need a different framework, such as Next.js or SvelteKit, set up [self-managed headless](https://dev.wix.com/docs/go-headless/self-managed-headless/about-self-managed-headless.md). To create a project, run: ```bash npm create @wix/new@latest headless ``` For non-interactive use (AI tools or scripts), pass the required project details as flags: ```bash npm create @wix/new@latest -- headless \ --project-name \ --business-name \ --site-template ``` For the full list of flags, see the [create headless command](https://dev.wix.com/docs/wix-cli/command-reference/project-creation/create-headless.md). The `create` command provisions the business and site for you and scaffolds the local codebase in 1 step. Your new project appears in your [Wix dashboard](https://support.wix.com/en/article/about-your-wix-dashboard) alongside your sites. ::: :::: ## 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. - **Extend with custom backend logic and dashboard UIs**: Use [extensions](https://dev.wix.com/docs/wix-cli/guides/extensions/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/wix-managed-headless/feature-guides/track-analytics-events.md) like page views, cart actions, and purchases, and forward them to connected analytics platforms such as GA4 and Facebook Pixel. ## Your project's private app Behind the scenes, the CLI creates a private app for your project that powers both authentication and extensions. You don't create, configure, or manage it yourself. For how it works, see [Authentication and API Integration](https://dev.wix.com/docs/go-headless/wix-managed-headless/authentication/authentication-and-api-integration.md). ## 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/get-started/choose-your-path.md). ## See also - [Quick Start with the Wix CLI](https://dev.wix.com/docs/go-headless/wix-managed-headless/get-started/quick-start-with-the-wix-cli.md) - [Authentication and API Integration](https://dev.wix.com/docs/go-headless/wix-managed-headless/authentication/authentication-and-api-integration.md) - [About the Wix CLI](https://dev.wix.com/docs/wix-cli/guides/about-the-wix-cli.md) - [About Wix Headless](https://dev.wix.com/docs/go-headless/get-started/about-wix-headless.md) - [About Headless Development Paths](https://dev.wix.com/docs/go-headless/get-started/choose-your-path.md) - [About Wix Vibe](https://dev.wix.com/docs/go-headless/wix-vibe/about-wix-vibe.md)