@eui/cli

Command-line interface for scaffolding and managing eUI applications.

Installation

npm install -g @eui/cli

Usage with npx

Run without installing globally:

npx @eui/cli new

Usage

Generate a new application

eui-cli new

Or simply:

eui-cli

The CLI will prompt you to configure your application:

1. Application Type: Choose between:

   • Desktop (Angular)
   • Mobile Ionic
   • eUI + Spring Boot web module (requires JDK + Maven)
   • eUI + Maven web module (JEE Spring, requires JDK + Maven)

2. Maven Configuration (for web-spring-boot type only):

   • groupId (e.g., ec.europa.digit)
   • artifactId (e.g., myapp)

3. Additional Options (not available for Mobile):

   • eUI ECL app-shell template (for ec.europa.eu apps)
     • If selected, choose between EC theme or EU theme

4. Dependency Installation: Choose whether to install dependencies automatically

5. Package Manager: Select Yarn 1.x or Pnpm (experimental)

6. eui-skills Setup: Optionally install eui-skills after generation

   • Install all (--all): install all skills to all agents without prompts
   • Or configure individually:
     • Agent(s): target specific agents (e.g. cursor, claude-code, or * for all)
     • Skill(s): specific skill names to install (or * for all)
     • Global: install at user-level instead of project-level
     • Skip confirmations: auto-confirm all skills prompts

CLI Flags

Skip prompts by passing flags directly:

# Generate with skills setup (interactive sub-prompts)
eui-cli new --skills

# Install all skills to all agents without prompts
eui-cli new --skills --skillsAll

# Target specific agents and skip confirmations
eui-cli new --skills --skillsAgent "cursor claude-code" --skillsYes

# Install a specific skill globally
eui-cli new --skills --skillsSkill "pr-review" --skillsGlobal

Skills sub-options (--skillsAgent, --skillsSkill, --skillsGlobal, --skillsYes, --skillsAll) require --skills to be set, otherwise the CLI will exit with an error.

Automated Mode

Generate an application without prompts using a configuration string:

eui-cli new --config <config-string> --targetPath <output-directory>

Configuration format:

appType:angular,appOptions:ecl,appOptionsEclTheme:ecl-ec,npmInstall:false

Available options:

• appType: angular, mobile, web-spring-boot, web-maven
• groupId: Maven groupId (for web-spring-boot, e.g., ec.europa.digit)
• artifactId: Maven artifactId (for web-spring-boot, e.g., myapp)
• appOptions: ecl (use underscore for multiple: ecl_option2)
• appOptionsEclTheme: ecl-ec, ecl-eu
• npmInstall: true, false
• packageManager: yarn, pnpm
• skills: true, false
• skillsAll: true, false
• skillsAgent: agent name(s), space-separated or *
• skillsSkill: skill name(s), space-separated or *
• skillsGlobal: true, false
• skillsYes: true, false

Build application

eui-cli build-app [options]

Options:

• --skipLint - Skip linting step
• --skipTest - Skip testing step
• --skipCompile - Skip compilation step
• -c, --configuration <config> - Angular build configuration
• --baseHref, --base-href <href> - Base href for the application
• --statsJson - Generate stats.json file
• --sourceMap - Generate source maps

Serve application

eui-cli serve-app [options]

Options:

• -c, --configuration <config> - Angular build configuration
• -p, --port <port> - Port number (default: 4200)
• -h, --host <host> - Host to serve on
• --proxyConfig <path> - Path to proxy configuration file
• --open - Open browser automatically

Lint application

eui-cli lint-app

Generate SVG sprite

eui-cli generate-sprite -i <input-folder> -o <output-file>

Options:

• -i, --inFolder <path> - Input folder containing SVG files (required)
• -o, --outFile <filename> - Output sprite filename with .svg extension (required)

Requirements

• Node.js 24.x or higher
• npm or yarn

License

EUPL-1.1