> 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: Quick Start from Your Own Frontend

## Article: Quick Start from Your Own Frontend

## Article Link: https://dev.wix.com/docs/go-headless/get-started/quick-starts/wix-managed-headless/quick-start-from-your-own-frontend.md

## Article Content:

# Quick Start from Your Own Frontend

Deploy an existing single-page app (SPA) as a Wix-managed headless project. Wix hosts and runs your frontend and connects it to Wix business solutions, while you keep the framework you already have.

<blockquote class="important">

**Important:** When you deploy your own existing frontend, Wix doesn't handle authentication for you. You create a [Wix Client](https://dev.wix.com/docs/api-reference/articles/sdk-setup-and-usage/set-up-a-wix-client.md) and set up authentication yourself, the same as for [self-managed headless](https://dev.wix.com/docs/go-headless/self-managed-headless/authentication/about-authentication.md). Automatic authentication and extensions are available only with [Wix's Astro integration](https://dev.wix.com/docs/go-headless/about-headless/choose-your-path.md).

</blockquote>

> **Coming from Claude Design?** You can [send a Claude Design build directly to Wix Headless](https://dev.wix.com/docs/go-headless/get-started/quickstart-from-claude-design.md).
## Before you begin

Make sure:

- You're logged in to your Wix account.
- You have [Node.js](https://nodejs.org/en/) (v20.11.0 or higher).
- Your project isn't already linked to Wix (it doesn't contain a `wix.config.json` file).

## Step 1 | Connect your project to Wix

1. Navigate to the root of your existing project directory.
2. Run:

   ```bash
   npm create @wix/new@latest init
   ```

   This creates a new Wix Headless project and a `wix.config.json` file that links your frontend to it. If you aren't logged in, the CLI prompts you to log in.
3. Run [`npx wix release`](https://dev.wix.com/docs/wix-cli/command-reference/project-commands/release.md) to deploy your site.

## Step 2 | Set up authentication

Initializing your project creates a client ID for you, stored as the `appId` in your `wix.config.json` file. Authentication is yours to wire up, but the groundwork is already done.

To set up authentication, install the [Wix JavaScript SDK](https://dev.wix.com/docs/sdk.md) and create a client with `OAuthStrategy`, passing the `appId` from `wix.config.json` as your client ID.

For more information on handling site visitors and members, see [About Authentication for Self-Managed Headless](https://dev.wix.com/docs/go-headless/self-managed-headless/authentication/about-authentication.md).

## Continue developing

After your project is set up, keep building:

- **Develop with an AI agent.** Point your agent at the Wix Headless skill to finish setup and integrate Wix business solutions. For more information, see the [Headless AI Toolkit](https://dev.wix.com/docs/go-headless/get-started/headless-ai-toolkit.md).
- **Manage business data in the dashboard.** Manage products, bookings, blog posts, forms, members, and more directly from your project dashboard. No code required.
- **Preview and deploy with the CLI.** Your project supports `npx wix preview` to test locally, `npx wix release` to publish, and global commands like `npx wix login`. See the [CLI command reference](https://dev.wix.com/docs/wix-cli/command-reference/introduction.md).

## See also

- [About Authentication for Self-Managed Headless](https://dev.wix.com/docs/go-headless/self-managed-headless/authentication/about-authentication.md)
- [About Wix-Managed Headless](https://dev.wix.com/docs/go-headless/wix-managed-headless/about-wix-managed-headless.md)