Documentation

Supported Technologies

SnapDeploy automatically detects and builds applications for these languages and frameworks.

Node.js

Supported Versions

18 20 22 (LTS)

Your project's declared version (package.json engines) is detected automatically; 18/20/22 build from our fast image mirror, other versions from the official Node image.

Frameworks

  • Express.js
  • Fastify
  • Nest.js
  • Koa
  • Hapi
  • Next.js (API Routes)

Package Managers

  • npm
  • yarn
  • pnpm

Build Tools

  • Webpack
  • Vite
  • esbuild
  • Rollup

Python

Supported Versions

3.11 (default) 3.9 – 3.12 detected

The version is detected from your project (e.g. pyproject.toml, runtime.txt); 3.11 builds from our fast mirror, others from the official Python image. pip, Poetry, uv and pyproject-only projects are all supported.

Frameworks

  • Django
  • Flask
  • FastAPI
  • Starlette
  • Tornado

Package Managers

  • pip (requirements.txt)
  • Poetry (pyproject.toml)
  • Pipenv (Pipfile)

Detection

Auto-detected via requirements.txt, pyproject.toml, or Pipfile

Go

Supported Versions

1.21 (default) go.mod version detected

1.21 builds from our fast mirror; other versions declared in go.mod use the official Go image.

Frameworks

  • Gin
  • Echo
  • Fiber
  • Chi
  • Standard library (net/http)

Ruby

Supported Versions

3.2 (default) Gemfile version detected

3.2 builds from our fast mirror; other versions declared in your Gemfile use the official Ruby image.

Frameworks

  • Ruby on Rails
  • Sinatra
  • Hanami

Java

Supported Versions

8 11 17 (default) 21

The version is detected from your build file (Maven/Gradle); Eclipse Temurin images throughout, 17 from our fast mirror.

Frameworks

  • Spring Boot
  • Quarkus
  • Micronaut
  • Jakarta EE

Build Tools

  • Maven (pom.xml)
  • Gradle (build.gradle)

Packaging

  • JAR (executable)
  • WAR (with embedded Tomcat)

PHP

Supported Versions

8.2 (default) composer version detected

The version comes from your composer.json platform requirement; 8.2 builds from our fast mirror, others from the official PHP image.

Frameworks

  • Laravel
  • Symfony
  • Slim
  • CodeIgniter

Frontend & Static Sites

Frontend Frameworks

  • React (Create React App, Vite)
  • Vue.js (Vue CLI, Vite)
  • Angular
  • Svelte / SvelteKit
  • Next.js (SSR and static export)
  • Nuxt.js (Static Mode)

Static Site Generators

  • HTML/CSS/JavaScript
  • Hugo
  • Jekyll
  • Gatsby
  • Astro

Static sites are served via optimized Nginx configuration with caching and compression. The build output folder (dist, build, or a custom Vite outDir) is detected automatically — no configuration needed.

Build-time environment variables: public-prefixed vars (VITE_*, NEXT_PUBLIC_*, REACT_APP_*, …) set on your container are forwarded into the build automatically, so values like your Supabase URL reach the compiled bundle. SnapDeploy also scans your repo and tells you which variables it needs before the first deploy.

AI-Built Apps (Lovable, Bolt, v0, Replit)

Exports from AI app builders deploy first-try — push the code to GitHub, connect it, and SnapDeploy detects the stack:

  • Lovable (current stack): TanStack Start apps build with the Nitro node-server preset and run as full server-side apps — not just static exports
  • Lovable (classic), Bolt, v0: Vite SPAs with the output folder auto-detected, served by Nginx with SPA routing
  • Replit & agent-built projects (Claude Code, Cursor, Codex): deploy like any Node/Python/static project
  • Supabase-backed apps: the env-var scan names the exact VITE_SUPABASE_* keys you need and where to find them

Docker Images

Deploy any Docker image from:

  • Docker Hub (public and private)
  • Amazon ECR
  • GitHub Container Registry (ghcr.io)
  • Google Container Registry
  • Any private registry with credentials
Scaling Troubleshooting