@evjs/cli

CLI and configuration for the @evjs/cli meta-framework.

Install

npm install -g @evjs/cli

Zero-Config

No configuration file is needed. ev dev and ev build work out of the box with sensible defaults:

• Entry: ./src/main.tsx
• HTML: ./index.html
• Client dev server: port 3000
• API server (dev): port 3001
• Server functions auto-discovered via "use server" directive

Commands

| Command | Description | |---------|-------------| | ev init [name] | Scaffold a new project from a template | | ev dev | Start dev server (client HMR + API watch) | | ev build | Production build (client + server) |

ev init [name]

Templates: basic-csr, basic-server-fns, trpc-server-fns. Option: -t, --template <template> to skip interactive selection.

ev dev

Uses webpack Node API directly (no temp config files):

1. WebpackDevServer (port 3000) — client bundle with HMR.
2. Node API Server (port 3001) — auto-starts when server bundle is emitted, uses node --watch.

ev build

Runs webpack via Node API with NODE_ENV=production:

• dist/client/ — optimized client assets with content hashes.
• dist/server/main.[hash].js — server bundle (entry discovered via dist/server/manifest.json).

Configuration

Create ev.config.ts in the project root (optional):

import { defineConfig } from "@evjs/cli";

export default defineConfig({
  client: {
    entry: "./src/main.tsx",
    html: "./index.html",
    dev: { port: 3000 },
  },
  server: {
    endpoint: "/api/fn",
    middleware: [],
    dev: { port: 3001 },
  },
});

The client.dev and server.dev fields accept extra options that are merged with defaults.