Deployment Configuration

Oblien provides flexible configuration options to match your project's specific needs.

Framework Selection

While Oblien auto-detects your framework, you can manually override it:

Supported Frameworks

Build Settings

Install Command

The command used to install dependencies:

npm install

For other package managers:

yarn install
pnpm install
bun install

Build Command

The command to build your production bundle:

npm run build

Output Directory

Where your build artifacts are located:

• Next.js: .next (for server builds) or out (for static export)
• React/Vue/Vite: dist or build
• SvelteKit: build or .svelte-kit
• Static Sites: ./ (root directory)

Root Directory

If your project is in a monorepo or subdirectory:

./packages/web
./apps/frontend
./client

Runtime Settings

Port

The port your application runs on (default: 3000):

3000  # Most Node.js frameworks
8080  # Alternative common port
5000  # Flask, older frameworks

Start Command

For server-rendered applications:

npm start
node server.js
npm run start:prod

Server Mode

• Static: Serve pre-built HTML/CSS/JS files
• Server: Run a Node.js server for SSR/API routes

Branch Configuration

Default Branch

The branch to deploy from (usually main or master).

Available Branches

You can deploy from any branch in your repository:

1. Select branch from dropdown
2. Click Deploy
3. Each branch can have its own deployment

Advanced Options

Custom Build Environment

Coming soon: Custom environment variables, Node.js version selection, and build timeout configuration.

Monorepo Support

For monorepos, specify:

• Root directory of your app
• Package manager workspace configuration
• Build dependencies

Example for Turborepo:

{
  "rootDirectory": "./apps/web",
  "buildCommand": "npm run build --filter=web"
}

Configuration Examples

Next.js App Router

Framework: Next.js
Build Command: npm run build
Output Directory: .next
Port: 3000
Server Mode: Server

Static React App

Framework: React
Build Command: npm run build
Output Directory: build
Server Mode: Static

Nuxt 3 Application

Framework: Nuxt
Build Command: npm run build  
Output Directory: .output
Port: 3000
Server Mode: Server

Vite + React

Framework: Vite
Build Command: npm run build
Output Directory: dist
Server Mode: Static

Best Practices

1. Test Locally First: Always ensure npm run build works locally
2. Use Standard Commands: Stick to conventional npm scripts when possible
3. Check Dependencies: Ensure all build dependencies are in package.json
4. Optimize Build: Use production builds for better performance
5. Review Logs: Check build logs if something doesn't work as expected

Need More Control?

For complex use cases, you can:

• Create custom build scripts in your repository
• Use build hooks (coming soon)
• Contact support for enterprise configurations