@nextrush/dev

// Your code
@Service()
class UserService {
  constructor(private db: Database) {} // DI needs to know this is 'Database'
}

// After esbuild
let UserService = class {
  constructor(db) {}
};
// No type info! DI can't resolve 'Database'

# Auto-detects entry and runtime
npx nextrush dev

# Specify entry file
npx nextrush dev ./src/app.ts

# Custom port
npx nextrush dev --port 4000

# Build with defaults
npx nextrush build

# With options
npx nextrush build --minify --outDir dist

nextrush dev [entry] [options]

# Basic usage
nextrush dev

# Custom entry
nextrush dev src/server.ts

# Custom port
nextrush dev --port 8080

# Enable debugger
nextrush dev --inspect

# Watch additional paths
nextrush dev --watch ./src --watch ./config

nextrush build [entry] [options]

# Basic build
nextrush build

# Custom entry and output
nextrush build ./src/index.ts --outDir build

# Production build with minification
nextrush build --minify

# Target a specific ES version
nextrush build --target esnext --no-sourcemap

dist/
├── index.js         # Compiled JavaScript
├── index.js.map     # Source map
├── index.d.ts       # Type declarations
└── ...

npx nextrush dev
npx nextrush build

bun nextrush dev
bun nextrush build

deno run -A nextrush dev
deno run -A nextrush build

import { dev, build } from '@nextrush/dev';

// Start dev server
await dev('./src/index.ts', { port: 3000 });

// Run production build
await build('./src/index.ts', { outDir: 'dist', minify: true });

import { dev, type DevOptions } from '@nextrush/dev';

await dev('./src/index.ts', { port: 3000 });

import { build, type BuildOptions } from '@nextrush/dev';

await build('./src/index.ts', { outDir: 'dist', minify: true });

import {
  detectRuntime,
  isNode,
  isBun,
  isDeno,
  getRuntimeInfo,
  type Runtime,
  type RuntimeInfo,
} from '@nextrush/dev';

// Check current runtime
const runtime: Runtime = detectRuntime();
console.log(runtime); // 'node' | 'bun' | 'deno'

// Runtime guards
if (isNode()) {
  console.log('Running on Node.js');
}

// Detailed info
const info: RuntimeInfo = getRuntimeInfo();
console.log(info.version); // '22.0.0'

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true,
    "target": "ES2022",
    "module": "ESNext",
    "moduleResolution": "bundler"
  }
}

{
  "scripts": {
    "dev": "nextrush dev",
    "build": "nextrush build",
    "start": "node dist/index.js"
  }
}

// src/index.ts
// reflect-metadata is auto-imported by the nextrush meta-package
import { createApp, createRouter, listen } from 'nextrush';
import { controllersPlugin } from 'nextrush/class';

const app = createApp();
const router = createRouter();

// Auto-discovers all @Controller classes in ./src (any file name, any depth)
await app.plugin(
  controllersPlugin({
    router,
    root: './src',
    prefix: '/api',
  })
);

app.route('/', router);
await listen(app, 3000);

nextrush dev
# → Watching for file changes...
# → Server running on http://localhost:3000

# Build with minification
nextrush build --minify

# Deploy
node dist/index.js

# .github/workflows/build.yml
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: pnpm/action-setup@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20

      - run: pnpm install
      - run: pnpm nextrush build
      - uses: actions/upload-artifact@v4
        with:
          name: dist
          path: dist/

@Service()
class UserService {
  constructor(
    private db: DatabaseService, // DI resolves this
    private logger: LoggerService // And this
  ) {}
}

grep -r "metadata\|design:paramtypes" dist/

# Ensure dependencies installed
pnpm install

# Check import path
# ❌ import { thing } from './module.ts'
# ✅ import { thing } from './module'

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true
  }
}

# Check source structure
ls src/

# Ensure all files are .ts

deno run --allow-all --node-modules-dir nextrush build

// CLI
export { cli, legacyDevCli } from '@nextrush/dev';

// Commands
export { dev, devCli, devHelp, type DevOptions } from '@nextrush/dev';
export { build, buildCli, buildHelp, type BuildOptions } from '@nextrush/dev';

// Runtime detection
export {
  detectRuntime,
  getRuntimeExecutable,
  getRuntimeInfo,
  isBun,
  isDeno,
  isNode,
  type Runtime,
  type RuntimeInfo,
} from '@nextrush/dev';

// Config utilities
export { findEntry, getDefaultWatchPaths, loadConfig, type NextRushConfig } from '@nextrush/dev';