> 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: Get Started

## Article: Get Started

## Article Link: https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/get-started.md

## Article Content:

# Get Started

Wix-managed headless projects can be created through code using the Wix CLI, through a visual UI using Wix Vibe, or a combination of both. This article helps you choose the right starting point for your workflow and directs you to the resources you need to get building.

## Choose your starting point

There are 2 primary ways to start a Wix-managed headless project:

- **Wix CLI**: A code-first approach where you develop in your IDE, choose from starter templates, and manage your project through the command line. This is the path covered in depth by the other articles in this section.
- **Wix Vibe**: A UI-based approach where you describe what you want to build using conversational AI prompts. No coding required.

## Start with the Wix CLI

The Wix CLI is the right choice when you want full control over your code and prefer working in your own IDE. The CLI scaffolds a complete [Astro-based project](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/core-concepts/architecture-and-project-structure.md) with [automatic authentication](https://dev.wix.com/docs/go-headless/develop-your-project/wix-managed-headless/authentication/authentication-and-api-integration.md), then you develop, test, and deploy through the command line.

To create a project:

1. Make sure you have [Node.js](https://nodejs.org/en/) v20.11.0 or higher and [Git](https://git-scm.com/) installed.

2. Run the following command:

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

    The CLI then prompts you for the details it needs to set up your project.

    > **Note:** You can run the command non-interactively, which is especially useful for automated scripts and AI agents. To do so, pass the `--project-name`, `--business-name`, and `--site-template` flags, and separate them from npm's own arguments with `--`. Passing only some of these flags causes the CLI to error out or fall back to interactive prompts. For the full list of flags, see [`npm create @wix/new headless`](https://dev.wix.com/docs/wix-cli/command-reference/project-creation/create-headless.md).

3. Follow the prompts to name your project, choose a [template](#templates), and select a directory for your project files.

4. After the CLI finishes generating your project, navigate to your project directory and start the local development environment:

    ```bash
    cd <your-project-directory>
    wix dev
    ```

For the full step-by-step walkthrough, see [Quick Start a Headless Project](https://dev.wix.com/docs/wix-cli/guides/get-started/quick-start-a-headless-project.md) in the CLI documentation.

> **Tip:** If you're working with an AI agent, the [wix-headless skill](https://github.com/wix/skills/tree/main/skills/wix-headless) runs this flow from a single prompt, including discovery, design, and feature wiring.

## Start with Wix Vibe

[Wix Vibe](https://dev.wix.com/docs/go-headless/wix-vibe/about-wix-vibe.md) is the right choice when you want to get a project up and running without writing code, or when you want to explore ideas visually before committing to a code-based workflow.

With Vibe, you describe what you want to build using conversational prompts. Vibe generates a complete project with pages, components, and Wix business solution integrations. You can continue editing in the Vibe editor, or open the project locally and switch to CLI-based development at any time.

For details on working with Vibe, see [About Wix Vibe](https://dev.wix.com/docs/go-headless/wix-vibe/about-wix-vibe.md).

## Templates

When you create a project with the CLI, you can choose a starter template. For details on each template, including links to their source code, see [Wix-Managed Headless Templates](https://dev.wix.com/docs/go-headless/get-started/templates/astro-templates-for-wix-managed-headless.md).

## Next steps

Once you've created your project, these resources help you continue:

- [Wix CLI Development Overview](https://dev.wix.com/docs/wix-cli/guides/development/development-overview.md): Learn about the development process, testing, and building.
- [Wix CLI Project Structure](https://dev.wix.com/docs/wix-cli/guides/get-started/project-structure.md): Understand the files and directories in your project.
- [Build and Deploy a Project](https://dev.wix.com/docs/wix-cli/guides/development/build-and-deploy-a-project.md): Deploy your project to production.
- [Wix JavaScript SDK](https://dev.wix.com/docs/sdk.md): Browse the APIs available for your project.

## See also

- [Quick Start a Headless Project](https://dev.wix.com/docs/wix-cli/guides/get-started/quick-start-a-headless-project.md)
- [About Wix Vibe](https://dev.wix.com/docs/go-headless/wix-vibe/about-wix-vibe.md)
- [Wix-Managed Headless Templates](https://dev.wix.com/docs/go-headless/get-started/templates/astro-templates-for-wix-managed-headless.md)
- [About Wix-Managed Headless](https://dev.wix.com/docs/go-headless/develop-your-project/about-headless-development-paths.md)