Docs

Framework Config Detector

Detect stack and generate deployxa.yaml files.

Free · No sign-up · Use it instantly

tools/detectorReady

Framework Configuration Detector

Check files present inside your local directory root to generate matching Deployxa blueprints.

Detected stack: Next.js
GENERATED DEPLOYXA.YAML BUILD CONFIG
app: my-nextjs-site
framework: nextjs
build:
  command: npm run build
  output: .next
run:
  command: npm start

01 / How it works

Understanding Framework Detection Results

Your repository contains file configurations that specify your web stack. The recommended config includes optimized launch scripts, build folders, and service ports to ensure zero-config deployment.

The Developer Guide to Project Configuration and Detection

How Web Stack Detection Works

Cloud platforms use stack detection to automatically configure build pipelines. By analyzing configuration file patterns, package descriptors, and directories, platforms determine how to compile and run your codebase.

Key File Signatures for Popular Stacks

  • Next.js: Detects next.config.js or next.config.mjs and package.json.
  • Laravel: Detects composer.json and artisan.
  • Django: Detects manage.py or requirements.txt.
  • Node.js (Express): Detects package.json with backend entrypoints.
  • Go: Detects go.mod.

Tuning Deployments

Once detected, developers can customize configurations using a root manifest like deployxa.yaml to specify custom build targets, cron runners, and database networks.

02 / FAQ

Questions, answered.

How does the detector recognize frameworks?

It scans folder contents for unique signature files (like package.json, artisan, manage.py) to match runtimes.

What happens if my framework is not recognized?

You can manually define build commands, target ports, and launch scripts in a root deployxa.yaml config file.

Why is port mapping important for web applications?

The proxy must know which port your backend listens on (e.g. 3000, 8000) to correctly route HTTP traffic.

Can I host static sites and APIs in one project?

Yes, mono-repos or multi-service setups can map distinct folders to separate cloud instances.

What is the purpose of deployxa.yaml?

This file overrides auto-detected settings, allowing custom build scripts, cron tasks, and network bindings.

How do I declare Node runtime versions?

Specify the desired node version inside the engines block of your package.json file.

What is a package manager lockfile?

Lockfiles (yarn.lock, package-lock.json) ensure the exact same package versions are compiled on the cloud as locally.

How do I map client-side SPAs on Nginx?

Ensure all non-file route queries fall back to index.html to support React or Vue client routing.

04 / Guides

Read next.

Ready when you are

Finished preparing your project?

Deploy it from Git with automatic builds, HTTPS and rollbacks on Deployxa.

All tools