# Frameworks

Light Cloud reads your repository and picks the right build. Static frontends go to the CDN, everything else runs as a serverless container. This page is the complete list of what detection recognises.

## Full-stack

Server-rendered apps run as containers that [scale to zero](/create/scaling#min-instances) when idle:

Every framework name links to its deploy guide.

| Framework | Runtime | Default port | Notes |
| --- | --- | --- | --- |
| [Next.js](/platform/frameworks/nextjs) | Node.js | 3000 | Static export serves from the CDN |
| [Nuxt](/platform/frameworks/nuxt) | Node.js | 3000 | |
| [SvelteKit](/platform/frameworks/sveltekit) | Node.js | 3000 | |
| [Remix](/platform/frameworks/remix) | Node.js | 3000 | |
| [Astro](/platform/frameworks/astro) | Node.js | - | Static output, served from the CDN |
| [Django](/platform/frameworks/django) | Python | 8000 | |
| [Ruby on Rails](/platform/frameworks/rails) | Ruby | 3000 | |
| [Laravel](/platform/frameworks/laravel) | PHP | 8080 | |
| [Symfony](/platform/frameworks/symfony) | PHP | 8080 | |
| [WordPress](/platform/frameworks/wordpress) | PHP | 8080 | One-click [database wiring](/platform/databases/connect#set-database_url); also a [stack](/create/templates#wordpress) |
| [Blazor](/platform/frameworks/blazor) | .NET | 8080 | |
| [Wasp](/platform/frameworks/wasp) | Node.js | 8080 | Powers the [Open SaaS template](/create/templates#open-saas) |

## Frontend

Static builds served from a global CDN - unlimited on every plan, with [bandwidth included](/billing/pricing#static-sites) up to a fair-use amount per workspace. Detection also knows each framework's default [output directory](/create/build-settings#output-directory):

| Framework | Output directory |
| --- | --- |
| [React](/platform/frameworks/react) | `dist` |
| [Vue](/platform/frameworks/vue) | `dist` |
| [Angular](/platform/frameworks/angular) | `dist/browser` |
| [Svelte](/platform/frameworks/svelte) | `dist` |
| [SolidJS](/platform/frameworks/solidjs) | `dist` |
| [Qwik](/platform/frameworks/qwik) | `dist` |
| [Gatsby](/platform/frameworks/gatsby) | `public` |
| [Docusaurus](/platform/frameworks/docusaurus) | `build` |
| [Eleventy](/platform/frameworks/eleventy) | `_site` |
| [Astro](/platform/frameworks/astro) | `dist` |
| [Next.js static export](/platform/frameworks/nextjs) | `out` |
| [Plain HTML, CSS, and JavaScript](/platform/frameworks/static-html) | `.` (the repository root) |

Hugo and Jekyll are not built on the platform yet - each needs its own toolchain in the build image. Build locally and deploy the output as static HTML.

## Backend

APIs and servers run as containers, on any of eight runtimes. A plain runtime with no framework works too - a bare Node script or Go module deploys the same way:

| Framework | Runtime | Default port |
| --- | --- | --- |
| [Express](/platform/frameworks/express) | Node.js | 8080 |
| [Fastify](/platform/frameworks/fastify) | Node.js | 3000 |
| [NestJS](/platform/frameworks/nestjs) | Node.js | 3000 |
| [AdonisJS](/platform/frameworks/adonisjs) | Node.js | 3333 |
| [Hono](/platform/frameworks/hono) | Node.js | 3000 |
| [Plain Node.js](/platform/frameworks/nodejs) | Node.js | 8080 |
| [FastAPI](/platform/frameworks/fastapi) | Python | 8000 |
| [Flask](/platform/frameworks/flask) | Python | 8000 |
| [Plain Python](/platform/frameworks/python) | Python | 8000 |
| [Gin](/platform/frameworks/gin) | Go | 8080 |
| [Echo](/platform/frameworks/echo) | Go | 8080 |
| [Fiber](/platform/frameworks/fiber) | Go | 8080 |
| [Plain Go](/platform/frameworks/go) | Go | 8080 |
| [Spring Boot](/platform/frameworks/spring-boot) | Java | 8080 |
| [Quarkus](/platform/frameworks/quarkus) | Java | 8080 |
| [Plain Java](/platform/frameworks/java) | Java | 8080 |
| [Sinatra](/platform/frameworks/sinatra) | Ruby | 3000 |
| [Plain Ruby](/platform/frameworks/ruby) | Ruby | 3000 |
| [ASP.NET](/platform/frameworks/aspnet) | .NET | 8080 |
| [Plain PHP](/platform/frameworks/php) | PHP | 8080 |
| [Dockerfile](/platform/frameworks/docker) | Any | 8080 |

The port is where traffic is routed and what `PORT` is set to - change it in [Build settings](/create/build-settings#port) if your server listens elsewhere. A repository with a Dockerfile runs as is, whatever is inside - see [Deploy with a Dockerfile](/platform/frameworks/docker).

## How detection works

Light Cloud reads the repository and works out the whole build without configuration:

- **Framework** - from dependencies and config files. `next.config.js`, `vite.config.ts`, `angular.json`, and their peers are parsed to find where the build output lands.
- **Package manager** - from the lockfile. `pnpm-lock.yaml`, `yarn.lock`, or `package-lock.json` decide whether the install step runs pnpm, yarn, or npm - with a lockfile present, installs are exact (`npm ci`).
- **Build command and output directory** - from the framework and your `package.json` scripts. The defaults per framework are tabled under [Build settings](/create/build-settings#output-directory).
- **Dockerfile** - a `Dockerfile` in the repo always wins and runs the app as a container, exactly as written. Without one, Light Cloud generates a Dockerfile for the detected framework; generated Node images run on Node 22. See [Builds](/platform/deployments/builds#dockerfiles-generated-or-your-own).

Every detected value is shown before the first deploy and can be overridden - per application, and again per environment. See [Deployments](/platform/deployments).

## Not sure what you'll get?

Create the application and look at the detected settings before deploying - nothing builds until you confirm. If your setup is unusual, set the build command and output directory by hand and the detection stays out of the way.

## Deploy guides

Every framework above has its own deploy guide - click its name in the tables, or expand **Frameworks** in the sidebar for the full list. The most-trodden paths:

- [Next.js](/platform/frameworks/nextjs): SSR behind the edge, or static export on the CDN.
- [React](/platform/frameworks/react): Vite or CRA, built to static files on the CDN.
- [Django](/platform/frameworks/django): Settings, migrations, and static files, containerized.
- [Express](/platform/frameworks/express): The classic Node API on scale to zero.
- [WordPress](/platform/frameworks/wordpress): One-click database wiring, or the full stack template.
- [Dockerfile](/platform/frameworks/docker): Bring your own image recipe for anything else.
