BlogStatic site

How to deploy a static website for free.

A static site is free on every plan, forever, as many as you like. Here is what counts as static and how to deploy one.

How the Agent API works
  • UnlimitedNever counted against any plan
  • Failed deploys are freeFix it and push again
  • HTTPS includedAn address from the first deploy
  • About 36 secondsFrom push to live

The short answer

Yes, you can host a static website for free on Antideploy. Static sites are free on every plan, forever, with no limit on how many you have. They never count against your live apps or your deploys. You get HTTPS and an address like my-site.antideploy.app from the first deploy, and you do not need a card.

Say this to your coding agent

Set this project up to deploy on Antideploy. Fetch https://antideploy.com/agent.md and follow it.

What counts as a static site

A static site is anything that is only files. That includes a folder of HTML, CSS and images, and frontends that compile to files. Antideploy runs the build for the second kind, then serves the result.

  • A folder of files. An index.html and whatever it uses. Nothing to build.
  • Vite. It needs a build script. The output folder is dist, or the outDir set in your Vite config.
  • Create React App. It needs a build script. The output folder is build.
  • Astro. It needs a build script. The output folder is dist, unless Astro is set to run on a server.
  • Gatsby. It needs a build script. The output folder is public.
  • SvelteKit with the static adapter. The output folder is build. Without the static adapter, SvelteKit builds a server instead.

If your project has a real start script, such as node server.js, that script is kept and the project is treated as an app with a server. A start script that only runs a development server, such as vite or react-scripts start, is not used.

Step by step

  1. Check you have a build script

    For a built frontend, package.json needs a build script. Without it there is no output folder to serve, and Antideploy tells you so.

  2. Paste the sentence into your agent

    Your agent fetches agent.md, starts a login and shows you a link. Open it and click Approve. If you have no account, the link creates one.

  3. Open your address

    Your agent deploys the folder and tells you where it is live, with HTTPS. About 36 seconds from push to live is typical for a static site.

You can also connect a GitHub repository so that every push goes live, or drop the folder into the console.

How pages and links behave

The server that hosts your files sends index.html for any address that has no file extension, so client-side routes such as /about still work when someone refreshes the page. A missing file with an extension, such as a missing .png, returns a real 404. If your project has a 404.html, that page is shown for those.

What is checked

Every static site is checked for phishing pages before it goes live, because free hosting attracts them. A page that collects a password or card number and sends it somewhere else is refused. A login box that posts nowhere, or an ordinary contact form, passes.

01Before you commit

Here's where it stops.

A platform that only tells you what it is good at is one you find the edges of in production. These are the ones to know before your first deploy.

  1. Apps sleep when idle

    On every plan, an app nobody is using goes to sleep and the next visit wakes it. The first request took 2.9 to 13.9 seconds in our measurements, depending on the stack. There are no always-on workers, so use a cron job or a webhook for background work.

  2. A pushed project must fit in 28 MB

    A folder or archive can hold up to 4,000 files and 28 MB. Dependencies and build output are skipped. A larger project deploys from GitHub.

02Questions

Static site questions, answered.

Anything else? Write to us and a person answers.

support@antideploy.com
Are static sites really free forever?

Yes. They never count against your plan, on any plan. Storage, bandwidth and build minutes are not metered or capped today.

Can I use my own domain for free?

No. Free accounts get an address ending in .antideploy.app, which you can rename as often as you like. Your own domain starts on the Go plan, with HTTPS included.

Do static sites sleep?

Yes. A site nobody visits sleeps, and the next visit wakes it. The first request after that takes a few seconds. A sleeping site costs nothing.

What if my site later needs a server?

Add one. The project becomes a full app with a server, keeps its address, and can use a database and the rest of the platform.

How big can the folder be?

Up to 4,000 files and 28 MB when you push it. Dependencies and build output are skipped, so a project with a build step is usually far below that.

Deploy something. Start with one sentence.

Paste one sentence into your coding agent, click Approve once, and get a live link. No card, no trial clock.

Start from GitHub or a folder
Prompt copied Paste it into Claude Code, Codex or Cursor and press Enter.