setup-project

Setup Project: $ARGUMENTS

If $ARGUMENTS is empty, ask: (1) project name, (2) preferred SAP Fiori theme (default: horizon).

Phase 1: Check Prerequisites

node --version   # must be ≥ 18.19
ng version       # Angular CLI must be installed

If Angular CLI is missing:

npm install -g @angular/cli

Report both versions. If Node < 18.19, stop and tell the user to upgrade Node before continuing.

Phase 2: Create Angular Project

If the user does not already have a project:

ng new [project-name] \
  --routing \
  --style=scss \
  --ssr=false \
  --package-manager=npm
cd [project-name]

If the user has an existing project, ask for its root path and cd there, then skip to Phase 3.

Phase 3: Install fundamental-ngx

Attempt ng add first:

ng add @fundamental-ngx/core

ng add installs peer dependencies and patches angular.json. However, it is known to fail with "Can not add index to parent of type array" on the budget update step, and may silently skip the styles patch even when it reports success. After it runs:

1. Check that angular.json "styles" array was updated (see Phase 4). If not, apply the patch manually.
2. Check that package.json now lists fundamental-styles and @sap-theming/theming-base-content. If not, install manually.

If ng add fails entirely (exit code 1) or the environment is offline, install manually:

npm install \
  @fundamental-ngx/core \
  @fundamental-ngx/platform \
  @fundamental-ngx/cdk \
  @fundamental-ngx/i18n \
  @angular/cdk \
  fundamental-styles \
  @sap-theming/theming-base-content

Note: @fundamental-ngx/platform is not installed by ng add @fundamental-ngx/core. If you plan to use platform form components (fdp-*), install it too.

Phase 4: Configure Theme

Ask the user which theme they want, or use the argument. Map to file paths:

Theme name	CSS variable file
horizon (default)	sap_horizon/css_variables.css
horizon-dark	sap_horizon_dark/css_variables.css
quartz	sap_fiori_3/css_variables.css
quartz-dark	sap_fiori_3_dark/css_variables.css
hcb	sap_hcb/css_variables.css
hcw	sap_hcw/css_variables.css