ShadRox v0.0.9 — durable runs, evidence-backed checks, free + BYOK. Release notes →

Preview support

See it running, beside the code.

ShadRox serves static sites and detected web projects locally, asks before it installs or launches anything, and checks the rendered frame so you know the preview actually worked. Here is exactly what that covers.

Preview support

Preview the web projects you are working on.

ShadRox can serve static sites and launch detected Node-based web projects with supported package scripts. It detects Python, Go, PHP, Java, and .NET entry points — the runtime itself must be installed on your machine. Opening a project workspace automatically starts its detected preview script and may offer to install missing dependencies.

Currently supported

Static sites Vite & Next.js Nuxt · Astro · SvelteKit Angular · webpack · Parcel Node-based web projects Python · Go · PHP · Java · .NET

Good to know

Backend runtime must be installed on your machineSome external sites block embedded previewsClick-to-source works for pages served by ShadRox
Managed run actions, with your approval before anything installs or launches.

Under the hood

How a preview runs.

Five steps between opening a folder and seeing the page. Two of them are yours: approving what runs, and reading the result.

Nothing installs behind your back.

Every managed run action — dependency install or detected script — waits for your approval before it touches the project.

  1. 01

    Detect the project type

    on open

    ShadRox reads the folder you opened and works out what it is: a static site, a Node web project with a supported package script, or a detected backend entry point.

  2. 02

    Ask before anything runs

    your approval

    Installing missing dependencies and launching a detected script are managed run actions. Both ask for your approval first — nothing installs or starts on its own.

  3. 03

    Serve the project locally

    on your machine

    The project is served locally and rendered in the in-app preview panel, beside the editor, the chat and the terminal it came from.

  4. 04

    Grade the rendered frame

    bounded check

    A bounded check grades the rendered frame, so a blank or broken preview is reported instead of quietly counting as a success.

  5. 05

    Clean up stale servers

    next start

    Dev servers left behind by an earlier session are cleaned up on the next start, so old processes do not pile up in the background.

Coverage

What it can preview.

Detection happens when you open a folder. What actually runs depends on the project — and on what is installed on your machine.

Markdown files

Open a Markdown file and switch between the rendered page and its markup with the Preview / Source toggle beside the file name.

.mdPreviewSource

Static sites

Plain HTML, CSS and JavaScript folders are served locally and shown in the preview panel — no build step and no configuration.

HTMLCSSJS

Node web projects

Detected frameworks and bundlers running their supported package scripts, including nested projects you pick from a list.

ViteNext.jsNuxtAstroAngularSvelteKitwebpackParcel

Detected backends

Entry points for these backends are detected in your workspace. How far a preview gets depends on the project and its configuration.

The runtime must be installed on your machine.

PythonGoPHPJava.NET

Markdown, both ways.

The Preview / Source switch sits right beside the file name. Read the rendered page, flip to the markup to fix a heading or a link, and flip back — without opening another tool.

README.mdPreviewSource

Try the toggle

README.md

ShadRox

A desktop workspace for the projects on your computer.

  • Editor, AI chat, preview, Git and terminal
  • Bring your own provider key
  • Preview asks before it installs or runs

shadrox.cyou

An illustration of the toggle beside the file name — same file, two views.

Good to know

The limits, stated plainly.

Preview is a convenience, not a universal runtime. These are the edges you will actually meet, plus the two behaviours worth knowing about.

Not every configuration

Detection covers the setups listed above. A project with an unusual configuration may not be detected, or may not run the way you expect.

Some sites block embedding

External sites that refuse to be embedded will not render inside the preview panel, however healthy they are in a browser.

Click-to-source

On pages ShadRox serves, click an element in the preview to jump straight to its source line in the editor.

Approval before action

Managed run actions always ask before anything installs or launches. You stay the one who decides what runs.

Get ShadRox

Point it at your project.

The quickest way to find out whether your setup is covered is to open it. ShadRox detects what it can run and asks before it runs anything.

v0.0.9 · Windows 10 or 11 (64-bit) · the installer is unsigned, so Windows may warn — choose More → Run anyway.

First run, in three steps

  1. 1Continue with Google on first launch — the app stores only email, name, avatar URL, version and platform.
  2. 2Open a project folder from your computer. ShadRox maps it and detects what it can run.
  3. 3Approve the detected preview script when you are asked, then keep working in the same window.