Skip to main content

​
Overview

Static Hosting is a feature that allows you to host static files on your Xano instance. It’s great for hosting your frontend right alongside your backend, or even just deploying quick tests as you build and iterate on your application. Static Hosting is available on any paid plan.

​
Supported Technologies

Static Hosting is designed to serve pre-built frontend assets — such as HTML, CSS, JavaScript — rather than running a server-side runtime. You can use any modern frontend framework that can be built into static files using a package.json build script. When a package.json file is present, Xano automatically runs your build script (e.g. npm run build) and hosts the generated output.

​
Works With

  • React (Create React App, Vite, Next.js)
  • Vue (Vue CLI or Vite)
  • Svelte and SvelteKit (static adapter)
  • Astro
  • Vanilla HTML/CSS/JS projects (no build step required)
  • Any other framework that outputs static files during build
💡 If your project can produce a static build or dist folder, Xano can host it.

​
Not Supported

Xano Static Hosting does not run server-side languages. That means:
  • No Python (e.g., Django, Flask)
  • No Node.js servers (e.g., Express)
  • No PHP, Ruby, or other server-side frameworks
  • No databases or dynamic rendering at runtime
Static Hosting is designed to be used in conjunction with your Xano backend.

​
Example Project Structure

my-frontend/
    ├─ package.json
    ├─ src/
    │  ├─ index.jsx
    │  └─ ...

​
Creatng a new site

Each workspace has a static hosted site already created for you. You’ll see it labeled as default in the Static Hosting screen.
1

Navigate to Static Hosting

From the left-hand navigation menu, choose Library, and choose Static Hosting.
2

Create a new site

In the top-right corner, click Create New Site.Give your site a name and a description, and click Create.

​
Uploading a site

  • In Xano
  • Using the VS Code Extension
Each upload starts with a build, which you can think of as a snapshot of your site at that time.After creating a site, choose it from the list and click Upload Build.

Upload via ZIP File

Click the Browse files button to select a file, or drag and drop it into the box.

Pull from Git Repository

You’ll need to create a new build to pull changes later; they are not synced automatically.
Provide the URL of your repo in the panel after choosing “Git Repository”.HTTPS urls work only for public repositories. For private repositories, use the SSH URL instead.

​
Deploying your site

Once you’ve uploaded your site, you’ll need to choose whether you want to deploy it to prod or dev. Xano issues you a separate domains for each environment, so you can easily test new builds without impacting your production site. Click on your site in the Static Hosting screen, and then choose the build you want to deploy. From the panel that opens, choose either Deploy Prod or Deploy Dev to deploy your site to the appropriate environment. Xano will run your build script (e.g. npm run build) and deploy the generated output to the appropriate environment. You can see the URLs for your deployed sites in the site management screen. Once the deployment is complete, logs are available by selecting the build and reviewing them in the panel that opens.
⌘I