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.

Next Steps

Environment Variables

Add secrets and config to your builds

Deployment Guide

Learn about preview and production deploys

Custom Domains

Connect your own domain