npm create @wix/new init

Initializes a new Wix-managed headless project in the current folder.

The command signs you in, creates the project, and saves the generated configuration locally so you can start developing. The business name is derived from the current folder's name, and the project is created from the blank template.

Before you begin

You need to have a folder that already contains your project code.

Usage

Run this command at the root of the folder you want to connect. It runs without prompts.

What the command does

The command operates on the current folder in place, without creating a new project folder or modifying your existing files. It:

• Provisions a Wix site for your project, listed on the Sites page of your Wix account.
• Writes a wix.config.json file containing the site's siteId and the appId of its private app.

After the command runs, your folder contains a wix.config.json similar to the following:

To preview or release your project, build it with your framework's own tooling, then run wix preview or wix release.

Errors

The command fails if the current folder already contains a wix.config.json file.

create headless vs. init

Both commands provision the same Wix headless project and write a local wix.config.json file that connects it to your code. A Wix headless project consists of:

• Site: The Wix site your code targets, identified by the siteId in wix.config.json. It's the same entity as your business, which is the workspace in your Wix account with a dashboard, billing, and business solutions, listed on the Sites page.
• Private app: Authorizes that code to call the site's APIs and add extensions, identified by the appId in wix.config.json.

When to use each

• create headless scaffolds a complete, opinionated Astro project for you. It generates project files from a site template, installs dependencies, initializes a Git repository, and publishes your site. Use it when you want Wix to set up the project structure and frontend for you.
• init connects project code you already have. It only provisions the Wix headless project and writes wix.config.json, leaving the rest of your folder untouched. It doesn't generate a template, install dependencies, initialize Git, or publish your site. Use it when you just want to connect existing code to Wix.