Oblien Docs

Supported Frameworks

Oblien automatically detects and supports a wide range of modern web frameworks. Each framework comes with optimized default configurations.

Full Framework Support

Next.js

Detection: Automatically detected from next.config.js or next.config.mjs

  • Framework ID: next
  • Build Command: npm run build
  • Install Command: bun install
  • Output Directory: .next
  • Server Mode: Supported (SSR, API Routes, App Router)
  • Static Export: Supported (use out directory)

Best For: Full-stack React applications, server-side rendering, API routes


Nuxt

Detection: Automatically detected from nuxt.config.js or nuxt.config.ts

  • Framework ID: nuxt
  • Build Command: npm run build
  • Install Command: bun install
  • Output Directory: .nuxt
  • Server Mode: Supported (Nuxt 2 & 3)

Best For: Vue-based full-stack applications


Astro

Detection: Automatically detected from astro.config.mjs

  • Framework ID: astro
  • Build Command: npm run build
  • Install Command: bun install
  • Output Directory: dist
  • Server Mode: Static only

Best For: Content-focused sites, blogs, documentation


Vite (+ React/Vue/Svelte)

Detection: Automatically detected from vite.config.js or vite.config.ts

  • Framework ID: vite
  • Build Command: npm run build
  • Install Command: bun install
  • Output Directory: dist
  • Server Mode: Static only

Best For: Modern SPA applications, fast development builds


SvelteKit

Detection: Automatically detected from svelte.config.js

  • Framework ID: sveltekit
  • Build Command: npm run build
  • Install Command: bun install
  • Output Directory: .svelte-kit
  • Server Mode: Static builds

Best For: Svelte-based applications with routing


Angular

Detection: Automatically detected from angular.json

  • Framework ID: angular
  • Build Command: npm run build
  • Install Command: bun install
  • Output Directory: dist
  • Server Mode: Static only

Best For: Enterprise Angular applications


Vue.js

Detection: Automatically detected from vue.config.js or package.json

  • Framework ID: vue
  • Build Command: npm run build
  • Install Command: bun install
  • Output Directory: dist
  • Server Mode: Static only

Best For: Vue 2/3 single-page applications


React (Create React App)

Detection: Automatically detected from react-scripts in package.json

  • Framework ID: react
  • Build Command: npm run build
  • Install Command: bun install
  • Output Directory: build
  • Server Mode: Static only

Best For: React SPAs, simple React apps


Node.js

Manual Selection: Choose when building a custom Node.js server

  • Framework ID: node
  • Build Command: (None - runs directly)
  • Install Command: bun install
  • Output Directory: . (root)
  • Server Mode: Full control

Best For: Custom Express/Fastify servers, APIs, custom Node applications


Static HTML

Manual Selection: Choose for vanilla HTML/CSS/JS sites

  • Framework ID: static
  • Build Command: (None)
  • Install Command: bun install
  • Output Directory: . (root)
  • Server Mode: Static file serving

Best For: Landing pages, pure HTML/CSS/JS sites, static assets

Configuration Matrix

FrameworkBuild CommandOutput DirServer ModeStatic Export
Next.jsnpm run build.nextYesout
Nuxtnpm run build.nuxtYesNo
Astronpm run builddistNoYes
Vitenpm run builddistNoYes
SvelteKitnpm run build.svelte-kitNoYes
Angularnpm run builddistNoYes
Vue.jsnpm run builddistNoYes
React (CRA)npm run buildbuildNoYes
Node.js(custom).YesNo
Static(none).NoYes

Package Manager

Oblien uses Bun as the default package manager for faster installs:

bun install  # Fast dependency installation

You can override this in your build configuration if needed:

npm install
yarn install
pnpm install

Framework Detection

Oblien automatically detects your framework by analyzing:

  1. Configuration files: next.config.js, nuxt.config.js, vite.config.js, etc.
  2. package.json dependencies: Looks for framework-specific packages
  3. Project structure: Checks for framework-specific folders and files

Manual Override

You can always manually select or change the framework during deployment configuration if auto-detection doesn't work as expected.

Coming Soon

  • Remix - Full-stack React framework
  • Qwik - Resumable framework
  • SolidJS - Reactive UI library
  • Gatsby - React-based static site generator

Framework-Specific Tips

Next.js Tips

For Static Export:

// next.config.js
module.exports = {
  output: 'export',
  images: {
    unoptimized: true
  }
};

For Server Mode:

  • API routes work automatically
  • Set port via PORT environment variable
  • Output directory: .next

Vite + React Tips

Ensure build script exists:

{
  "scripts": {
    "build": "vite build",
    "preview": "vite preview"
  }
}

SvelteKit Tips

Configure adapter:

// svelte.config.js
import adapter from '@sveltejs/adapter-static';

export default {
  kit: {
    adapter: adapter({
      pages: 'build',
      assets: 'build'
    })
  }
};

Need Help?