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.

Before you begin

Make sure:

• You're logged in to your Wix account.
• You have Node.js (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:

   Copy

   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 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 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.

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.
• 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.

See also

• About Authentication for Self-Managed Headless
• About Wix-Managed Headless