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
Scan Repository
Nixpacks scans your repository for framework indicators (package.json, requirements.txt, etc.)
Detect Framework
Identifies the framework and runtime version
Generate Build Plan
Creates an optimized build configuration
Build & Deploy
Executes the build and creates a Docker image
Supported Frameworks
Node.js
Detected by:
package.json
Supported:
- • Express.js
- • Next.js
- • Nest.js
- • Nuxt.js
- • Remix
- • Astro
Python
Detected by:
requirements.txtpyproject.tomlPipfile
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
{"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
fastapi==0.104.1uvicorn[standard]==0.24.0pydantic==2.5.0
Nixpacks detects FastAPI and automatically installs dependencies and starts with uvicorn main:app --host 0.0.0.0.
Go API
module github.com/username/my-apigo 1.21require (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:
| Runtime | Version File | Example |
|---|---|---|
| Node.js | .nvmrc or package.json | "node": "18.x" |
| Python | .python-version or runtime.txt | 3.11 |
| Go | go.mod | go 1.21 |
| Ruby | .ruby-version or Gemfile | 3.2.0 |
| Flutter | pubspec.yaml or .fvmrc | sdk: ^3.12.1 |
| PHP | composer.json | "php": "^8.4" |
| Rust | rust-toolchain.toml | channel = "1.88.0" |
| Java | pom.xml, Gradle, or .java-version | <java.version>24</java.version> |
Override Detection
If automatic detection doesn't work, you can override it with a nixpacks.toml file:
[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"
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. Go to your service page
- 2. Click on the "Deployments" tab
- 3. Select a deployment to view its build logs
- 4. Look for the "Framework Detection" section to see what was detected