> 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 an Existing Astro Project

## Article: Quick Start from an Existing Astro Project

## Article Link: https://dev.wix.com/docs/go-headless/get-started/quick-starts/wix-managed-headless/quick-start-from-an-existing-astro-project.md

## Article Content:

# Quick Start from an Existing Astro Project

Already have an Astro project? Link it to Wix and deploy it as a Wix-managed headless project with [Wix's Astro integration](https://dev.wix.com/docs/go-headless/about-headless/choose-your-path.md). The integration handles hosting, authentication, and [extensions](https://dev.wix.com/docs/build-apps/develop-your-app/develop-an-app-with-the-cli/supported-extensions/about-extensions-in-the-wix-cli.md) for you, so there's no client setup or authentication to wire up yourself.

The [`headless link`](https://dev.wix.com/docs/wix-cli/command-reference/project-creation/create-headless-link.md) command provisions a Wix business and site, configures your Astro setup for Wix, and installs the dependencies you need. This is the alternative to scaffolding a new Astro project. For that, see [Quick Start with the Wix CLI](https://dev.wix.com/docs/go-headless/get-started/quick-starts/wix-managed-headless/quick-start-with-the-wix-cli.md).

## Before you begin

Make sure:

- You're logged in to your Wix account. If you don't have one, [sign up](https://manage.wix.com/account/custom-apps).
- You have [Node.js](https://nodejs.org/en/) (v20.11.0 or higher).
- Your project uses Astro 5 and contains an Astro configuration file (such as `astro.config.mjs`). Astro 6 isn't supported.
- Your project isn't already linked to Wix (it doesn't contain a `wix.config.json` file).

## Step 1 | Link your project to Wix

1. Navigate to the root folder of your Astro project.
2. Run:

   ```bash
   npm create @wix/new@latest -- headless link
   ```

3. Enter the **name of your business**. This becomes the name of your headless project on Wix and is added to your Wix sites list. The command configures your Astro project for Wix, installs dependencies, and provisions a Wix business and site.

   > **Note:** You can run the command non-interactively by passing the `--business-name` flag. See the [`headless link`](https://dev.wix.com/docs/wix-cli/command-reference/project-creation/create-headless-link.md#flags) flags.

## Step 2 | Test the project

Run `npm run dev` to start the local development environment, then open the link in your terminal to view your site. The environment hot-reloads, so changes appear in the browser immediately.

## Step 3 | Continue developing

Your Astro project is now connected to Wix with the Astro integration handling authentication for you, so you can call [Wix SDK](https://dev.wix.com/docs/sdk.md) methods directly. From here you can:

- [Call Wix APIs with the JavaScript SDK](https://dev.wix.com/docs/api-reference?apiView=SDK.md).
- [Install the Wix plugin](https://dev.wix.com/docs/api-reference/articles/ai-tools/about-the-wix-plugin.md) to set up Wix Skills and the Wix MCP for AI-assisted development.
- [Add extensions](https://dev.wix.com/docs/build-apps/develop-your-app/develop-an-app-with-the-cli/supported-extensions/about-extensions-in-the-wix-cli.md) for custom backend logic and dashboard UIs.

## See also

- [About Wix-Managed Headless](https://dev.wix.com/docs/go-headless/wix-managed-headless/about-wix-managed-headless.md)
- [create headless link](https://dev.wix.com/docs/wix-cli/command-reference/project-creation/create-headless-link.md)