Skip to main content
The Webstorio CLI lets you build sites the way developers like to work: real .tsx files in your editor, shared components, version control, and a live local preview. When you’re ready, one command syncs everything to a Webstorio project where the server compiles and hosts it.
Alpha — the Webstorio CLI is in active development, so commands and configuration may change between releases. See the CLI changelog for what’s new, and share feedback at [email protected].

How it works

Pages and components are standard React (.tsx) — there’s no bespoke framework to learn, just React plus the window.webstorio SDK. A Webstorio site is a small set of files:
  • a webstorio.config.ts that lists your pages and components,
  • one .tsx module per page (each with a default export), and
  • shared components you import from your pages.
See Project structure for brand, assets, schemas, and how each folder maps to config. When you push, the CLI composes each page into a single self-contained module — inlining your relative imports (like Testimonials) and keeping allowlisted packages (React, lucide-react, …) as imports. It uploads only that code; the Webstorio server compiles it authoritatively into the stored HTML. The CLI never uploads compiled output, so what you see live always matches what the platform produced.
Production compilation always happens on the Webstorio server. The CLI only composes and uploads source code.

Install

The package exposes a webstorio binary.

Quickstart

New to the CLI? Follow Your first site with the CLI for a guided, step-by-step walkthrough.

Next steps