About Supported Frameworks

Every Wix-managed headless project runs on Wix infrastructure, whatever framework you build with. How much Wix handles for you depends on that framework.

This article covers the 2 options, what each one gives you, and which frameworks Wix can run.

Choose your framework

• Astro (full integration): Recommended if you're starting fresh or already build with Astro.
• Other frameworks (limited integration): Available if your build is client-only or runs on Cloudflare Workers.

Astro (full integration)

Scaffold a new project with AI or the Wix CLI, or link an Astro project you already have. Wix's Astro integration handles authentication automatically, adds built-in SEO support, analytics tracking, and error and log monitoring, manages your secrets, and lets you add extensions.

Other frameworks (limited integration)

Deploy a frontend you already have and keep the framework you built it with. Wix hosts and runs your site, and you preview and release it with the CLI. You create a Wix client and set up authentication yourself.

Wix doesn't build these projects. You build locally with your framework's own tooling and deploy the build output.

What Wix can run

You can deploy client files, server code, or both:

• Client files: A static build, such as a single-page app built with React, Vue, or vanilla HTML and JavaScript.
• Server code: Anything targeting the Cloudflare Workers runtime. Deploy a backend on its own, a client and backend side by side, or a full-stack framework that has a Cloudflare adapter.

Frameworks whose server output can't run on Cloudflare Workers aren't supported.

What you can deploy depends on how you create the project

The framework rules above describe what Wix can run. Each way of creating a project narrows them further:

How you create the project	Client files	Server code
Initializing from your terminal	Any build output	Yes, when built for the Cloudflare Workers runtime
Uploading your files	Static files only. See What You Can Upload.	No
Sending a Claude Design	One HTML page	No

Capability comparison

Capability	Astro	Other frameworks
Managed hosting with global CDN	✓	✓
Analytics tracking	✓	✗
Wix business APIs	✓	✓
Backend code	✓	✓ When built for the Cloudflare Workers runtime
Automatic authentication	✓	✗
Built-in SEO support	✓	✗
Secrets management	✓	✗
Error and log monitoring	✓	✗
App extensions	✓	✗
CLI commands	Full command set	preview and release only
Builds	Wix builds your project	You build locally and release the build output

See also

• About Wix-Managed Headless
• About the Astro Integration
• The wix.config.json File