Core concepts

AI Environment Parsing

Lunadeck uses AI to automatically detect and configure your project's build environment. This eliminates manual setup and ensures consistent, reproducible builds.

What gets detected

• Framework type — React Native, Flutter, Capacitor, Next.js, etc.
• Package manager — npm, yarn, pnpm, bun
• Node.js version — From .nvmrc, engines field, or best match
• Build commands — Extracted from package.json scripts
• Output directory — Where built assets are placed
• Environment variables — Required build-time variables
• Native plugins — Capacitor/Cordova plugins that need native configuration

How it works

1. Static analysis — Your project files are scanned for configuration markers
2. Dependency resolution — Dependencies are analyzed to determine required native modules
3. Build graph generation — A directed acyclic graph of build steps is created
4. Optimization — Unnecessary steps are pruned, caching opportunities are identified

Overriding detection

You can override any detected setting via the dashboard or a lunadeck.config.json file. Overrides take precedence over AI detection.

Accuracy

Our detection engine has a 95%+ accuracy rate across supported frameworks. If detection fails or produces incorrect results, please report it so we can improve the model.