Supported Frameworks
Stackpad automatically detects your framework from your package.json and configuration files. Here’s a complete list of supported frameworks and how they’re detected.
Auto-detected frameworks
| Framework | Detection | Default port | Build command | Start command |
|---|---|---|---|---|
| Next.js | next in dependencies | 3000 | next build | next start |
| Remix | @remix-run/node in dependencies | 3000 | remix build | remix-serve |
| Astro | astro in dependencies | 4321 | astro build | astro preview |
| Nuxt | nuxt in dependencies | 3000 | nuxt build | nuxt start |
| SvelteKit | @sveltejs/kit in dependencies | 3000 | vite build | node build |
| React Router v7 | react-router v7+ in dependencies | 3000 | react-router build | react-router-serve |
| Express | express in dependencies | 3000 | From package.json | node entrypoint |
| Hono | hono in dependencies | 3000 | From package.json | node entrypoint |
| Static site | No server framework | 80 | From package.json | Static file server |
Detection priority
If multiple frameworks are detected (e.g. Next.js + Express), Stackpad uses the following priority:
- Next.js
- Remix
- Nuxt
- SvelteKit
- React Router v7
- Astro
- Hono
- Express
- Static site
Package managers
Stackpad detects your package manager from the lockfile:
| Lockfile | Package manager | Install command |
|---|---|---|
pnpm-lock.yaml | pnpm | pnpm install --frozen-lockfile |
yarn.lock | yarn | yarn install --frozen-lockfile |
package-lock.json | npm | npm ci |
Output modes
Server-rendered (default)
Server-rendered frameworks (Next.js, Remix, Nuxt, etc.) run as a Node.js server. Stackpad builds the application and starts the server process.
Static export
If your framework is configured for static export (e.g. output: 'export' in Next.js), Stackpad builds the static files and serves them with a lightweight web server.
Standalone (Next.js)
When output: 'standalone' is set in next.config.js, Stackpad uses Next.js’s standalone output for a minimal production bundle. This is recommended for the best performance.
Unsupported languages
Stackpad’s auto-detection currently supports JavaScript/TypeScript frameworks. For other languages (Go, Rust, Python, Ruby, etc.), you can use templates to deploy pre-configured stacks.
What’s next?
- Framework detection — how detection works in detail
- Templates — deploy pre-configured stacks
- Git push deploy — the full deployment pipeline