Framework Detection - Replov Docs
Skip to main content

Framework Detection

Automatic framework detection and build configuration with Nixpacks

Replov uses Nixpacks to automatically detect your application's framework and configure the build process. No configuration files needed in most cases.

How It Works

1

Scan Repository

Nixpacks scans your repository for framework indicators (package.json, requirements.txt, etc.)

2

Detect Framework

Identifies the framework and runtime version

3

Generate Build Plan

Creates an optimized build configuration

4

Build & Deploy

Executes the build and creates a Docker image

Zero Configuration
For most frameworks, you don't need any configuration files. Nixpacks handles everything automatically.

Supported Frameworks

Node.js

Detected by:

  • package.json

Supported:

  • • Express.js
  • • Next.js
  • • Nest.js
  • • Nuxt.js
  • • Remix
  • • Astro

Python

Detected by:

  • requirements.txt
  • pyproject.toml
  • Pipfile

Supported:

  • • Django
  • • Flask
  • • FastAPI
  • • Streamlit
  • • Gunicorn

Go

Detected by:

  • go.mod

Supported:

  • • Gin
  • • Echo
  • • Fiber
  • • Standard library

Ruby

Detected by:

  • Gemfile

Supported:

  • • Ruby on Rails
  • • Sinatra
  • • Rack apps

Static Sites

Detected by:

  • index.html
  • Build output directory

Supported:

  • • React (Vite, CRA)
  • • Vue.js
  • • Angular
  • • Svelte
  • • HTML/CSS/JS

Detection Examples

Next.js Application

package.jsonjson
{
"name": "my-nextjs-app",
"scripts": {
"dev": "next dev",
"build": "next build",
"start": "next start"
},
"dependencies": {
"next": "^14.0.0",
"react": "^18.2.0"
}
}

Nixpacks detects Next.js from the next dependency and automatically runs npm run build and npm start.

FastAPI Application

requirements.txttext
fastapi==0.104.1
uvicorn[standard]==0.24.0
pydantic==2.5.0

Nixpacks detects FastAPI and automatically installs dependencies and starts with uvicorn main:app --host 0.0.0.0.

Go API

go.modgo
module github.com/username/my-api
go 1.21
require (
github.com/gin-gonic/gin v1.9.1
)

Nixpacks detects Go, builds the binary with go build, and runs it.

Runtime Versions

Replov reads the runtime declarations committed with your project and passes the selected version to the build system:

RuntimeVersion FileExample
Node.js.nvmrc or package.json"node": "18.x"
Python.python-version or runtime.txt3.11
Gogo.modgo 1.21
Ruby.ruby-version or Gemfile3.2.0
Flutterpubspec.yaml or .fvmrcsdk: ^3.12.1
PHPcomposer.json"php": "^8.4"
Rustrust-toolchain.tomlchannel = "1.88.0"
Javapom.xml, Gradle, or .java-version<java.version>24</java.version>
Specify Versions
Commit a runtime declaration when your application needs a specific version. When no version is declared, Replov uses the platform default and identifies that choice in the build log.

Override Detection

If automatic detection doesn't work, you can override it with a nixpacks.toml file:

nixpacks.tomltoml
[phases.setup]
nixPkgs = ["nodejs-18_x", "python311"]
[phases.install]
cmds = ["npm install", "pip install -r requirements.txt"]
[phases.build]
cmds = ["npm run build"]
[start]
cmd = "npm start"
Custom configuration is rarely needed. Use it only when automatic detection fails or you need special build steps.

Troubleshooting Detection

Wrong Framework Detected

If Nixpacks detects the wrong framework, ensure your project has the correct indicator files (package.json, requirements.txt, etc.) in the root directory.

Build Fails

Check the build logs for errors. Common issues: missing dependencies, incorrect start command, or wrong runtime version.

Monorepo Detection

For monorepos, specify the root directory of your service in the deployment settings.

Viewing Build Logs

You can view detailed build logs in the Replov dashboard:

  1. 1. Go to your service page
  2. 2. Click on the "Deployments" tab
  3. 3. Select a deployment to view its build logs
  4. 4. Look for the "Framework Detection" section to see what was detected
Debug Mode
Enable verbose logging in your deployment settings to see detailed framework detection information.