# Deploy JavaScript app builds on StaticX

> Host static JavaScript app bundles from Vite, Vue, React, Svelte, Astro, and other build systems that output files ready for a CDN.

Canonical: https://staticx.site/javascript-apps

## Build output, not servers

StaticX hosts the compiled files your JavaScript app produces. It is ideal for static SPAs, landing pages, documentation sites, and exported frontends.

## Immutable deployments

Each upload becomes a deployment, so teams can ship quickly while keeping rollback and analytics tied to the exact files that went live.

## Agent-ready publishing

AI agents can create or update JavaScript sites through MCP, the CLI, or the API using scoped tokens and explicit deploy instructions.

## Deploy a JavaScript app safely

StaticX hosts compiled frontends. Build your app first, then publish the files that browsers can actually load.

1. **Build locally or in CI** — Run the framework build command for Vite, Vue, React, Svelte, Astro, or another static output pipeline.
2. **Deploy the output root** — Upload the contents of dist, build, public, or out with index.html at the root. Do not deploy node_modules or source-only files.
3. **Check routing and forms** — Add 404.html for missing pages, configure SPA fallbacks where needed, and use StaticX form rules for lead capture.

## Static hosting works best when the runtime is already in the browser.

Most JavaScript marketing sites, dashboards, documentation portals, and AI-generated frontends do not need a running server. Once built, they are HTML, CSS, JavaScript, images, and JSON files.

StaticX keeps that output simple: files are published as a versioned deployment, analytics and forms attach to the release, and custom domains stay connected while you keep shipping new versions.

## What to check before publishing

- **Base paths** — If assets load from the wrong path, set the framework base or public path before building.
- **Client-side routing** — SPAs need a fallback page so refreshes on /about or /pricing do not become 404s.
- **Environment values** — Browser apps receive environment variables at build time. Do not expect StaticX to inject runtime server variables.

## FAQ

### Does StaticX run JavaScript servers?

No. StaticX hosts static browser assets. If your app needs a long-running Node server or WebSocket backend, host that backend separately.

### Can I deploy React, Vue, Angular, Svelte, and Astro?

Yes, as long as the project builds to static files with an index.html and the referenced assets.

### Can AI agents deploy JavaScript apps?

Yes. Give the agent a scoped token and instructions to build, verify index.html and 404.html, deploy the output root, and return the live URL or exact API error.

[View on staticx.site](https://staticx.site/javascript-apps)