> 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 Projects Started from Your Own Frontend ## Article: About Wix-Managed Headless Projects Started from Your Own Frontend ## Article Link: https://dev.wix.com/docs/go-headless/wix-managed-headless/start-from-your-own-frontend/about-wix-managed-headless-projects-started-from-your-own-frontend.md ## Article Content: # About Wix-Managed Headless Projects Started from Your Own Frontend You can create a Wix-managed headless project from your own existing frontend project. This flow deploys your site, as Wix hosts the frontend, and integrates with Wix business solutions. This flow only supports single-page app (SPA) projects, such as React, Vue, or vanilla HTML/JS. > **Note:** This flow always creates a new Wix Headless project. It's not possible to import files into an existing one. ## Architecture and benefits When you create a Wix-managed headless project from your own frontend, you get a full-stack project 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. - **Secrets management:** Securely manage your project's [environment variables](https://dev.wix.com/docs/go-headless/wix-managed-headless/project-development/environment-variables/about-environment-variables-in-the-cli.md) and secrets. - **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. ## Wix business solutions Creating a Wix-managed headless project from your own frontend allows you to access and use Wix business solutions. You can integrate with eCommerce, Bookings, Pricing Plans, Events, and more. ## Authentication Authentication isn't handled automatically when you bring your own frontend. You must manage authentication manually. To work with Wix APIs in your Headless project, you need to be authorized to call APIs. The authorization strategy you choose depends on what kind of headless project you are developing. - [**Visitors and Members (OAuth)**](https://dev.wix.com/docs/go-headless/self-managed-headless/authentication/about-authentication.md#visitor-and-member-oauth): A project for use by customers, such as anonymous visitors and logged-in members. To get started with this authorization strategy, start by [creating an OAuth app](https://dev.wix.com/docs/go-headless/self-managed-headless/authentication/oauth/about-oauth-authentication.md). - [**Admin (API Key)**](https://dev.wix.com/docs/go-headless/self-managed-headless/authentication/about-authentication.md#admin-api-key): An external project with customized administrative access to your Wix account's sites and projects. To get started with this authorization strategy, start by [generating an API key](https://dev.wix.com/docs/go-headless/self-managed-headless/authentication/about-admin-operations.md). In some cases, you may want to use more than 1 authorization strategy or use a number of API keys in the same project. > **Note:** The authorization strategy serves 2 purposes: > > - Authorizes your app to call Wix APIs. > - Directs your calls to Wix APIs to a site or project. To learn more about authorization strategies, see [Authorization Strategies](https://dev.wix.com/docs/go-headless/self-managed-headless/authentication/about-authentication.md). ## CLI and extensions You can [manage your project using the CLI](https://dev.wix.com/docs/go-headless/wix-managed-headless/start-from-your-own-frontend/development-of-a-project-started-from-your-own-frontend.md#project-management-with-the-cli), including top-level commands like `npx wix login` and `npx wix logout`, and project-level commands for previewing and releasing. Extensions aren't yet available for Headless projects started from your own frontend. ## How to start a project from your own frontend There are different ways to start a project from your own frontend. Regardless of the method you choose, this creates the `wix.config.json` configuration file to link your frontend code to the new Wix Headless project. - **[Claude Design](https://dev.wix.com/docs/go-headless/wix-managed-headless/start-from-your-own-frontend/start-a-wix-managed-headless-project-using-claude-design.md)**: If you've built a design in Claude Design, you can use the Wix Connector to send your design directly to Wix Headless. - **[CLI](https://dev.wix.com/docs/go-headless/wix-managed-headless/start-from-your-own-frontend/start-a-wix-managed-headless-project-using-the-cli.md)**: If you prefer to work locally from your terminal, you can initialize a new Wix Site and Headless Project from your current directory using the CLI. ## See also - [Start a Wix-Managed Headless Project Using Claude Design](https://dev.wix.com/docs/go-headless/wix-managed-headless/start-from-your-own-frontend/start-a-wix-managed-headless-project-using-claude-design.md) - [Start a Wix-Managed Headless Project from Your Own Frontend Using the CLI](https://dev.wix.com/docs/go-headless/wix-managed-headless/start-from-your-own-frontend/start-a-wix-managed-headless-project-using-the-cli.md) - [Development of a Project Started from Your Own Frontend](https://dev.wix.com/docs/go-headless/wix-managed-headless/start-from-your-own-frontend/development-of-a-project-started-from-your-own-frontend.md)