Overview

Overview

Freestyle Web Deploy API is a serverless deployment platform primarily for deploying websites you didn't write, whether your customers wrote them or your AI did.

It comes with automatic TLS certificates, domain mapping + routing, customer domain verification, and more.

When to use it?

Freestyle Web Deploy API deploys to a node compatible serverless runtime. That means it supports all major JavaScript frameworks, like Next.js, Remix, Astro, SvelteKit, and more. Along with all server frameworks like Express, Fastify, and Hono. It can also host static files via any JS backend that serves them.

It has decoupled domains from deployments completely, making it incredibly easy to deploy websites to your customers' domains, to add deployment preview urls and to build custom domain routing logic.

Freestyle Web Deploy's also scale to and from zero incredibly fast (~5ms startup, ~150ms initial response time on full NextJS apps), and are pruned aggressively to keep costs low. This makes them especially good for supporting a free tier with sporatic and unpredictable traffic, while also being able to handle high traffic spikes.

Freestyle also supports long running serverless processes. Unlike other serverless providers who timeout based on time since last request, Freestyle Web Deploy's timeout based on time since last TCP Packet, meaning that a long running websocket can ping the server at a rate faster than the timeout (completely configurable) and keep the process alive indefinitely. This makes it ideal for AI Chatbots, real-time collaboration, or any other live applications.

It also supports uncompiled TypeScript, so you can send it TypeScript files and they will just work. Because Freestyle also has hyper fast deploys, this makes it very useful for rapid server iteration with AI.

When not to use it?

Freestyle Web Deploy API does not run binaries, it only runs TypeScript/JavaScript. If you are trying to run Python, Ruby, Go, or any other binary it will not work. This extends to docker containers — Freestyle Web Deploy API is not a container API, it is a serverless deployment API.

It also does not support insecure http traffic, all traffic through it is encrypted with TLS. This means that if you are trying to deploy a website that requires insecure http traffic, it will not work.

It is generally made for deploying APIs, websites, and anything JavaScript/TypeScript your customers or AI wrote. It has great tooling for working with the issues that come up with code you didn't write. For deploying your own code, it will still work but you may find nicer UIs and tooling elsewhere.

How to use it?

• First, check out the Deploying a Website guide
• Then, when you want to verify your customer's domains, check out the Domain Verification guide and Deploy to Custom Domain guide
• If you're dealing with complex traffic and routing behaviors, check out the Domain Mapping guide
• If you're using Expo, NextJS, or Vite or Static Assets, see the guides and notes for those systems
• If you're needing specific configurations, check out the Advanced Configuration notes