Frameworks

CupaDev works with all major web frameworks. Zero configuration required - we automatically detect your framework and configure the optimal build settings.

Zero Configuration

CupaDev automatically detects your framework by analyzing your package.json and project structure. In most cases, you don't need to configure anything - just push your code and we handle the rest.

Auto-detect framework

Identifies Next.js, React, Vue, etc.

Smart build commands

Automatically runs the right commands

Output detection

Finds build output automatically

Environment setup

Node version and dependencies handled

Supported Frameworks

Next.js

The React Framework for Production

App Router & Pages Router
Automatic API Routes
Image Optimization
ISR & SSR
Build Command
npm run build
Output Directory
.next
View guide

React + Vite

Fast, modern React applications

Lightning-fast HMR
Optimized builds
Native ESM
TypeScript support
Build Command
npm run build
Output Directory
dist
View guide

Nuxt.js

The Intuitive Vue Framework

Auto-imports
File-based routing
SSR & SSG
Server API
Build Command
npm run build
Output Directory
.output
View guide

SvelteKit

Cybernetically enhanced web apps

No virtual DOM
Truly reactive
Less code
Adapter-based
Build Command
npm run build
Output Directory
build
View guide

Vue.js

Progressive JavaScript Framework

Composition API
Reactive data
Single-file components
Vue Router
Build Command
npm run build
Output Directory
dist
View guide

Astro

Ship less JavaScript

Content-focused
Island architecture
Framework agnostic
Optimized output
Build Command
npm run build
Output Directory
dist
View guide

Custom Configuration

While CupaDev works with zero configuration, you can customize your build settings if needed.

Project Settings

Override build settings in your project dashboard:

  • Build CommandCustomize the command to build your app
  • Output DirectorySpecify where build output is located
  • Install CommandOverride dependency installation
  • Node VersionSelect Node.js version (14.x, 16.x, 18.x, 20.x)

cupadev.json

Add a configuration file to your repository root:

{
  "buildCommand": "npm run build",
  "outputDirectory": "dist",
  "installCommand": "npm install",
  "framework": "nextjs",
  "nodeVersion": "18.x",
  "environmentVariables": {
    "NODE_ENV": "production"
  }
}

Build Process

Understanding what happens when you deploy:

1. Clone Repository

Your Git repository is cloned to our build servers

2. Install Dependencies

npm/yarn/pnpm install runs automatically

3. Build Application

Your build command executes with environment variables

4. Optimize Assets

Automatic minification, compression, and optimization

5. Deploy to Edge

Distributed globally across our CDN network

6. Generate URL

Unique deployment URL with automatic SSL

Troubleshooting

Build fails during npm install

Check your package.json for correct dependencies. Try deleting node_modules and package-lock.json locally, then reinstall.

Wrong framework detected

Override the framework in project settings or add a cupadev.json configuration file.

Build succeeds but site doesn't work

Check that your output directory is correct. For Next.js use .next, for Vite/React use dist.