@aligent/nx-appbuilder 0.2.0

package/README.md

@@ -0,0 +1,203 @@
+# Nx App Builder
+
+The `@aligent/nx-appbuilder` package provides Nx generators for Adobe App Builder development. It scaffolds a workspace shell and individual App Builder apps inside an Nx monorepo, wired up against Aligent's `@adobe/aio-sdk` / `@adobe/aio-commerce-lib-*` conventions.
+
+## Generators
+
+### Preset Generator
+
+The preset generator initialises a new App Builder monorepo. It is invoked indirectly via either `@aligent/create-workspace` (the Aligent-flavoured wrapper) or vanilla `create-nx-workspace`, and produces the workspace shell only — apps are added afterwards with the `app` generator.
+
+#### Usage
+
+```bash
+# Recommended: the Aligent wrapper. Requires corepack to be enabled.
+npx @aligent/create-workspace@latest --preset=@aligent/nx-appbuilder
+
+# Or directly via create-nx-workspace (will prompt for nodeVersion if omitted):
+npx create-nx-workspace@latest --preset=@aligent/nx-appbuilder
+```
+
+> The `@aligent/create-workspace` wrapper calls `create-nx-workspace` under the hood, prompts for the preset's options (workspace name, target Node.js version), and removes the npm-bootstrap artefacts (`package-lock.json`, `node_modules`, `.nx`) afterwards so the workspace is ready for `yarn install`.
+
+#### Options
+
+| Option | Type   | Required | Default | Description                                                                                                   |
+|--------|--------|----------|---------|---------------------------------------------------------------------------------------------------------------|
+| `name` | string | Yes      | -       | Workspace name (kebab-case). Used as the `@aligent/<name>` npm package name and the workspace directory name. |
+
+#### Post-generation setup
+
+After running the preset generator, configure the npm registry token before the first `npm install`:
+
+- **`NPM_TOKEN`** — the generated `.npmrc` points `@aligent` at `https://npm.corp.aligent.consulting/` and reads `${NPM_TOKEN}` for auth. Generate a token by signing in to the registry with your GitHub account, then export it in your shell:
+
+  ```bash
+  export NPM_TOKEN=<your-token>
+  ```
+
+#### What it creates
+
+The preset generator scaffolds:
+
+- **Root configuration files**:
+  - `package.json` - Workspace manifest with `lint` / `check-types` / `test` / `build` scripts (affected + run-many variants)
+  - `nx.json` - Nx workspace configuration with cached `lint` / `check-types` / `test` / `build` target defaults
+  - `.npmrc` - Aligent private registry configuration
+  - `.nvmrc` - Pinned Node.js version (v22)
+  - `.gitignore` - Standard ignores for Node, Nx, Parcel and Adobe AppBuilder
+  - `README.md` - Workspace-level usage guide
+
+The preset does **not** scaffold any apps — see the `app` generator below.
+
+### App Generator
+
+The app generator creates a new Adobe App Builder app inside an existing workspace. The generator drives a series of prompts (or accepts CLI flags) that toggle which feature subtrees are rendered into the new app's directory.
+
+#### Usage
+
+```bash
+npx nx g @aligent/nx-appbuilder:app <app-name>
+```
+
+Pass any of the feature flags below to skip the corresponding prompt, e.g.:
+
+```bash
+npx nx g @aligent/nx-appbuilder:app my-app \
+    --hasAdminUI=true \
+    --sidebarCategory=sales \
+    --hasCommerceWebhooks=true
+```
+
+#### Options
+
+| Option                  | Type    | Required | Default            | Description                                                                                                                                                 |
+|-------------------------|---------|----------|--------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `name`                  | string  | Yes      | -                  | App name (kebab-case). Used as the directory name and the suffix of the `@aligent/<name>` package name.                                                     |
+| `description`           | string  | No       | `''`               | Short description of the app, used in `package.json` and the generated README.                                                                              |
+| `displayName`           | string  | No       | Title-cased `name` | Human-readable display name used in `app.commerce.config.ts` and the generated README.                                                                      |
+| `hasAdminUI`            | boolean | No       | `false`            | Generates the Commerce backend UI extension (`commerce/backend-ui/1`) — custom admin pages and sidebar menu items.                                          |
+| `sidebarCategory`       | enum    | No       | `none`             | Sidebar category for the admin menu item. One of `catalog`, `sales`, `customers`, `content`, `none`. Only used when `hasAdminUI=true`; prompted if omitted. |
+| `hasBusinessConfig`     | boolean | No       | `false`            | Generates the Commerce configuration extension (`commerce/configuration/1`) — merchant-facing fields under Stores → Configuration.                          |
+| `hasCommerceWebhooks`   | boolean | No       | `false`            | Adds a `webhooks` section to `app.commerce.config.ts` for binding Commerce extensibility hooks to runtime actions.                                          |
+| `hasEvents`             | boolean | No       | `false`            | Generates a sample event handler under `src/actions/` and an `eventing` block in `app.commerce.config.ts` for Commerce + external event subscriptions.      |
+| `hasRestActions`        | boolean | No       | `false`            | Generates a sample REST action under `src/actions/` and registers it in the runtime manifest.                                                               |
+| `hasScheduledActions`   | boolean | No       | `false`            | Generates a sample cron-triggered action under `src/actions/` along with the `triggers` and `rules` entries that fire it.                                   |
+| `hasCustomInstallSteps` | boolean | No       | `false`            | Generates an `installation` block in `app.commerce.config.ts` and a sample step under `scripts/install/`.                                                   |
+
+> Setting `hasAdminUI`, `hasBusinessConfig`, or `hasCommerceWebhooks` automatically pulls in the `commerce-extensibility` subtree and the `@adobe/aio-commerce-lib-*` dependencies.
+
+#### What it creates
+
+The app generator always renders a **base** subtree into `<app-name>/`:
+
+- **App-level files**:
+  - `app.config.yaml` - App Builder manifest with the runtime package, action declarations, triggers and rules (composed from the selected flags)
+  - `package.json` - Pinned dependencies and `lint` / `lint:fix` / `check-types` / `test` scripts (per-target variants for actions, web and tests)
+  - `package.json` `nx.targets` block - declares the custom `check-types` and `deploy` targets; `lint` and `test` are inferred by the `@nx/eslint/plugin` and `@nx/vitest` plugins from `eslint.config.mjs` and `vitest.config.ts`
+  - `tsconfig.json` / `tsconfig.base.json` - TypeScript project config
+  - `babel.actions.config.js` - Babel preset for App Builder actions
+  - `eslint.config.mjs` / `prettier.config.mjs` - Lint and formatter config (`@aligent/ts-code-standards`)
+  - `vitest.config.ts` - Vitest config
+  - `.editorconfig`, `.nvmrc`, `.gitignore`, `README.md`
+
+- **Action and test scaffolding**:
+  - `src/actions/tsconfig.json` - TypeScript config for the App Builder actions
+  - `tests/tsconfig.json` - TypeScript config for the test suite
+  - `hooks/check-action-types.sh` - `pre-app-build` hook that type-checks actions before deploy
+  - `global-types/@adobe/aio-sdk/*.d.ts` - Local type augmentations for the Adobe AIO SDK
+
+- **Root updates**:
+  - Adds `<app-name>` to the root `package.json` workspaces array
+
+Additional subtrees are layered on top depending on the selected flags:
+
+| Flag                                                            | Subtree rendered                          | Notable additions                                                                                                                                                                                                 |
+|-----------------------------------------------------------------|-------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| any of `hasAdminUI`, `hasBusinessConfig`, `hasCommerceWebhooks` | `commerce-extensibility/`                 | `app.commerce.config.ts`, `install.yaml`, `commerce/extensibility/1` extension config; pulls in `@adobe/aio-commerce-lib-app` / `-config`.                                                                        |
+| `hasAdminUI`                                                    | `commerce-backend-ui/`                    | React 19 + Spectrum admin UI under `src/commerce-backend-ui-1/`, `web-src/` entry point, action utils, registration, `pre-app-build` web type-check hook.                                                         |
+| `hasBusinessConfig`                                             | `commerce-config/`                        | `commerce/configuration/1` extension config wired into `app.commerce.config.ts`; adds a `businessConfig.schema` block to `app.commerce.config.ts`.                                                                |
+| `hasCommerceWebhooks`                                           | none (modifies `commerce-extensibility/`) | Adds a `webhooks` section to `app.commerce.config.ts` for binding Commerce extensibility hooks to runtime actions or external URLs. No new files; relies on the `commerce-extensibility/` subtree being rendered. |
+| `hasRestActions`                                                | `rest-actions/`                           | `src/actions/rest-sample.ts` registered as a web action in `app.config.yaml`.                                                                                                                                     |
+| `hasEvents`                                                     | `events/`                                 | `src/actions/handle-sample-event.ts`, sample Commerce + external event subscriptions, `aio-lib-events` global types.                                                                                              |
+| `hasScheduledActions`                                           | `scheduled/`                              | `src/actions/cron-sample.ts` plus the `triggers`/`rules` entries that fire it on a cron schedule.                                                                                                                 |
+| `hasCustomInstallSteps`                                         | `install-steps/`                          | `scripts/install/sample-step.js` and an `installation.customInstallationSteps` entry in `app.commerce.config.ts`.                                                                                                 |
+
+#### Example
+
+```bash
+# Standalone backend integration with REST actions and scheduled jobs
+npx nx g @aligent/nx-appbuilder:app order-sync \
+    --hasRestActions=true \
+    --hasScheduledActions=true
+
+# Commerce admin UI with business configuration and webhook bindings
+npx nx g @aligent/nx-appbuilder:app loyalty-rules \
+    --hasAdminUI=true \
+    --sidebarCategory=customers \
+    --hasBusinessConfig=true \
+    --hasCommerceWebhooks=true
+```
+
+## Project Structure
+
+After running the preset generator and adding one or more apps, your workspace will look like:
+
+```
+my-workspace/
+├── my-app/
+│   ├── src/
+│   │   ├── actions/
+│   │   │   ├── tsconfig.json
+│   │   │   └── ...               # rest / event / cron action samples (per flag)
+│   │   ├── commerce-backend-ui-1/  # only if hasAdminUI
+│   │   ├── commerce-configuration-1/  # only if hasBusinessConfig
+│   │   └── commerce-extensibility-1/  # only if any commerce-lib flag
+│   ├── tests/
+│   ├── hooks/
+│   ├── global-types/
+│   ├── scripts/install/          # only if hasCustomInstallSteps
+│   ├── app.config.yaml
+│   ├── app.commerce.config.ts    # only if any commerce-lib flag
+│   ├── install.yaml              # only if any commerce-lib flag
+│   ├── package.json              # includes nx.targets for check-types and deploy
+│   └── ...
+├── nx.json
+├── package.json
+├── .npmrc
+└── .nvmrc
+```
+
+## Development
+
+### Building
+
+```bash
+npx nx build nx-appbuilder
+```
+
+The `@nx/js:tsc` build executor compiles `src/**/*.ts` to `dist/src/` and copies the templates under `src/generators/<gen>/files/` verbatim. Template files use the `.template` suffix (e.g. `app.commerce.config.ts.template`) so they aren't picked up by lint or `tsc`; `@nx/devkit`'s `generateFiles` strips the suffix at generation time.
+
+### Running tests / lint / type-check
+
+```bash
+npx nx test nx-appbuilder
+npx nx lint nx-appbuilder
+npx nx typecheck nx-appbuilder
+```
+
+### Local testing
+
+To try the generator locally against a sibling workspace without publishing:
+
+```bash
+# In the consumer workspace:
+npm install --save-dev /absolute/path/to/packages/nx-appbuilder
+npx nx g @aligent/nx-appbuilder:app my-app
+```
+
+Or use the local Verdaccio registry — see the root `CLAUDE.md` for the `nx start-local-registry` workflow.
+
+## License
+
+MIT

package/generators.json

@@ -0,0 +1,18 @@
+{
+    "$schema": "http://json-schema.org/schema",
+    "name": "@aligent/nx-appbuilder",
+    "version": "0.1.0",
+    "generators": {
+        "preset": {
+            "factory": "./src/generators/preset/preset",
+            "schema": "./src/generators/preset/schema.json",
+            "description": "Scaffold a new Aligent AppBuilder monorepo (used by create-nx-workspace).",
+            "x-use-standalone-layout": true
+        },
+        "app": {
+            "factory": "./src/generators/app/generator",
+            "schema": "./src/generators/app/schema.json",
+            "description": "Scaffold a new Adobe App Builder app inside an existing workspace."
+        }
+    }
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@aligent/nx-appbuilder",
+  "version": "0.2.0",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "typings": "./src/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aligent/microservice-development-utilities.git",
+    "directory": "packages/nx-appbuilder"
+  },
+  "dependencies": {
+    "@nx/devkit": "22.4.2",
+    "enquirer": "^2.3.6"
+  },
+  "generators": "./generators.json",
+  "author": "Aligent",
+  "license": "MIT",
+  "types": "./src/index.d.ts"
+}

package/src/generators/app/files/base/.editorconfig.template

@@ -0,0 +1,18 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true
+max_line_length = 100
+
+
+[{package.json,*.yml,*.md}]
+indent_size = 2
+indent_style = space
+
+[*.md]
+trim_trailing_whitespace = false

package/src/generators/app/files/base/.gitignore.template

@@ -0,0 +1,9 @@
+# NodeJS packages
+node_modules
+
+# AppBuilder/aio CLI outputs
+dist
+.parcel-cache
+.env
+.aio
+.aws.tmp*

package/src/generators/app/files/base/.nvmrc.template

@@ -0,0 +1 @@
+v<%= nodeVersion %>

package/src/generators/app/files/base/README.md.template

@@ -0,0 +1,44 @@
+# <%= displayName %>
+
+<%= description %>
+
+## Development
+
+Run any of these from the monorepo root. Replace `npm install` with
+`yarn install` / `pnpm install` if that's your preferred package manager —
+the workspace works the same either way.
+
+```bash
+# Install dependencies
+npm install
+
+# Lint
+npx nx lint <%= name %>
+
+# Type-check
+npx nx run <%= name %>:check-types
+
+# Test
+npx nx test <%= name %>
+
+# Deploy
+npx nx run <%= name %>:deploy
+```
+
+## Structure
+
+<%_ const usesCommerceLib = hasAdminUI || hasBusinessConfig || hasCommerceWebhooks; _%>
+<%_ if (usesCommerceLib) { _%>
+This app integrates with Adobe Commerce via App Management
+(`@adobe/aio-commerce-lib-app`). The merchant-facing config, eventing, webhook
+subscriptions, and custom install steps are all declared in
+`app.commerce.config.ts`; the lib provisions them at install time.
+<%_ if (hasAdminUI) { _%>
+
+The admin UI lives under `src/commerce-backend-ui-1/`. Add pages and
+components inside `web-src/src/components/`.
+<%_ } _%>
+<%_ } else { _%>
+This is a standalone Adobe App Builder integration. Backend actions live under
+`src/actions/`. There is no Commerce admin UI and no business configuration.
+<%_ } _%>

package/src/generators/app/files/base/app.config.yaml.template

@@ -0,0 +1,77 @@
+<%_
+const usesCommerceExtensions = hasAdminUI || hasBusinessConfig || hasCommerceWebhooks;
+const hasAnyAction = hasRestActions || hasEvents || hasScheduledActions;
+const preBuildSteps = ['./hooks/check-action-types.sh'];
+if (hasAdminUI) preBuildSteps.push('./hooks/check-web-types.sh');
+const preAppBuild = preBuildSteps.join(' && ');
+_%>
+application:
+    hooks:
+        pre-app-build: <%- preAppBuild %>
+    actions: src/actions
+    runtimeManifest:
+        packages:
+            <%= runtimePackageName %>:
+                license: Apache-2.0
+<%_ if (!hasAnyAction) { _%>
+                actions: {}
+<%_ } else { _%>
+                actions:
+<%_ if (hasRestActions) { _%>
+                    rest-sample:
+                        function: src/actions/rest-sample.ts
+                        web: 'yes'
+                        runtime: nodejs:<%= nodeMajor %>
+                        inputs:
+                            LOG_LEVEL: debug
+                        annotations:
+                            require-adobe-auth: true
+                            final: true
+<%_ } _%>
+<%_ if (hasEvents) { _%>
+                    handle-sample-event:
+                        function: src/actions/handle-sample-event.ts
+                        web: 'yes'
+                        runtime: nodejs:<%= nodeMajor %>
+                        inputs:
+                            LOG_LEVEL: debug
+                        annotations:
+                            require-adobe-auth: true
+                            final: true
+<%_ } _%>
+<%_ if (hasScheduledActions) { _%>
+                    cron-sample:
+                        function: src/actions/cron-sample.ts
+                        web: 'no'
+                        runtime: nodejs:<%= nodeMajor %>
+                        inputs:
+                            LOG_LEVEL: debug
+                        annotations:
+                            final: true
+<%_ } _%>
+<%_ } _%>
+<%_ if (hasScheduledActions) { _%>
+                triggers:
+                    cron-sample-trigger:
+                        feed: /whisk.system/alarms/alarm
+                        inputs:
+                            cron: '0 * * * *'
+                rules:
+                    cron-sample-rule:
+                        trigger: cron-sample-trigger
+                        action: cron-sample
+<%_ } _%>
+<%_ if (usesCommerceExtensions) { _%>
+
+extensions:
+<%_ if (hasAdminUI) { _%>
+    commerce/backend-ui/1:
+        $include: src/commerce-backend-ui-1/ext.config.yaml
+<%_ } _%>
+<%_ if (hasBusinessConfig) { _%>
+    commerce/configuration/1:
+        $include: src/commerce-configuration-1/ext.config.yaml
+<%_ } _%>
+    commerce/extensibility/1:
+        $include: src/commerce-extensibility-1/ext.config.yaml
+<%_ } _%>

package/src/generators/app/files/base/babel.actions.config.js.template

@@ -0,0 +1,6 @@
+// Babel configuration allowing compilation of typescript files in both
+// test and src/action folders
+module.exports = {
+    presets: [['@babel/preset-env', { targets: { node: 'current' } }], '@babel/preset-typescript'],
+    ignore: ['**/src/web/**', '**/node_modules/**'],
+};

package/src/generators/app/files/base/eslint.config.mjs.template

@@ -0,0 +1,8 @@
+import { eslintConfigs } from '@aligent/ts-code-standards';
+
+export default [
+    ...eslintConfigs.react,
+    {
+        ignores: ['**/*.js', '**/*.cjs', '**/*.mjs', '**/coverage'],
+    },
+];

package/src/generators/app/files/base/global-types/@adobe/ADOBE_TYPES.md.template

@@ -0,0 +1,10 @@
+# Type declarations for @adobe/aio-sdk
+
+Although some of the modules contained within the sdk have type definitions, they are not exported by the sdk itself.
+This folder declares a minimal module for the sdk.
+
+## Currently supported
+
+- Core.Logger (from @adobe/aio-lib-core-logging)
+- Core.Config (from @adobe/aio-lib-core-config)
+- Events (from @adobe/aio-lib-events)

package/src/generators/app/files/base/global-types/@adobe/aio-sdk/aio-core-logging.d.ts.template

@@ -0,0 +1,15 @@
+import Logger, { AioLoggerConfig } from '@adobe/aio-lib-core-logging';
+
+/**
+ * In the official `AioLoggerConfig` type, `level` is defined as `string`, but the values accepted are:
+ * 'error', 'warn', 'info', 'verbose', 'debug', and 'silly'. See [Adobe Developer
+ * Doc](https://developer.adobe.com/commerce/extensibility/app-development/best-practices/logging-troubleshooting/#set-the-log-level)
+ * for reference.
+ */
+type LogLevel = 'error' | 'warn' | 'info' | 'verbose' | 'debug' | 'silly';
+
+declare module '@adobe/aio-sdk' {
+    export namespace Core {
+        export { Logger, AioLoggerConfig, LogLevel };
+    }
+}

package/src/generators/app/files/base/global-types/@adobe/aio-sdk/aio-lib-core-config.d.ts.template

@@ -0,0 +1,43 @@
+//
+declare module '@adobe/aio-sdk' {
+    namespace Core {
+        // The types declared in @adobe/aio-lib-core-config are inaccurate, providing our own declaration here
+        class ConfigAPI {
+            /**
+             * Gets the value for a key in the Config.
+             * If no parameters are specified, it will return all keys and values of the consolidated Config.
+             * @param [key = ''] - the key to get the value from
+             * @param [source] - 'global', 'local', or 'env'. Defaults to searching the consolidated config.
+             */
+            get(key?: string, source?: string): string | Record<string, string>;
+            /**
+             * Set the value for a key in the Config.
+             * @param key - the key to set the value to
+             * @param value - the value to save for the key
+             * @param [local = false] - Set to true to save the value in the local config. Defaults to false (save to global config).
+             */
+            set(key: string, value: string, local?: boolean): ConfigAPI;
+            /**
+             * Delete a key and its value in the Config.
+             * @param key - the key to delete the value from
+             * @param [local = false] - Set to true to delete the value in the local config. Defaults to false (save to global config).
+             */
+            delete(key: string, local?: boolean): ConfigAPI;
+            /**
+             * Reload the Config from all the config file(s)
+             */
+            reload(): ConfigAPI;
+            /**
+             * Pipe data from stdin.
+             */
+            getPipedData(): Promise<string>;
+            /**
+             * Hoists variables in the ./.env file to process.env
+             * @param force - force the loading of the .env file
+             */
+            dotenv(force?: boolean): void;
+        }
+
+        const Config: ConfigAPI;
+    }
+}

package/src/generators/app/files/base/hooks/check-action-types.sh.template

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+
+echo -e "\n⏩ Checking action types before build... 🔍\n"
+
+if npx tsc --noEmit --project src/actions/tsconfig.json; then
+  echo -e "\n⏩ Action type checking completed successfully! ✅\n"
+  # Exiting with 0 allows the build to continue
+  exit 0
+else
+  echo -e "\n⏩ Action type checking failed: ❌\n"
+  # Exiting with non-zero will cause the build to be skipped/failed
+  exit 1
+fi

package/src/generators/app/files/base/prettier.config.mjs.template

@@ -0,0 +1,3 @@
+import { prettierConfig } from '@aligent/ts-code-standards';
+
+export default prettierConfig;

package/src/generators/app/files/base/src/actions/tsconfig.json.template

@@ -0,0 +1,8 @@
+{
+    "extends": "../../tsconfig.base.json",
+    "compilerOptions": {
+        "sourceMap": true
+    },
+    "include": ["**/*.ts", "../../global-types"],
+    "exclude": []
+}

package/src/generators/app/files/base/tests/tsconfig.json.template

@@ -0,0 +1,13 @@
+{
+    "extends": "../tsconfig.base.json",
+    "compilerOptions": {
+        "noEmit": true,
+        "allowImportingTsExtensions": true,
+        "baseUrl": "..",
+        "paths": {
+            "@/*": ["src/*"]
+        }
+    },
+    "include": ["**/*.test.ts", "../global-types"],
+    "exclude": []
+}

package/src/generators/app/files/base/tsconfig.base.json.template

@@ -0,0 +1,14 @@
+{
+    "extends": "@aligent/ts-code-standards/tsconfigs-base",
+    "compileOnSave": false,
+    "compilerOptions": {
+        "noEmit": true,
+        "allowImportingTsExtensions": true,
+        "baseUrl": "./src",
+        "paths": {
+            "@/*": ["*"]
+        }
+    },
+    "exclude": ["tests", "**/*.mjs", "**/*.cjs", "node_modules"],
+    "include": ["global-types"]
+}

package/src/generators/app/files/base/tsconfig.json.template

@@ -0,0 +1,3 @@
+{
+    "extends": "./tsconfig.base.json"
+}

package/src/generators/app/files/base/vitest.config.ts.template

@@ -0,0 +1,19 @@
+import path from 'node:path';
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+    test: {
+        environment: 'node',
+        include: [
+            'tests/**/*.test.ts',
+            'tests/**/*.test.tsx',
+            'src/**/*.test.ts',
+            'src/**/*.test.tsx',
+        ],
+    },
+    resolve: {
+        alias: {
+            '@': path.resolve(__dirname, 'src'),
+        },
+    },
+});

package/src/generators/app/files/commerce-backend-ui/extension-manifest.json.template

@@ -0,0 +1,8 @@
+{
+    "name": "<%= name %>",
+    "displayName": "<%= displayName %>",
+    "description": "<%= description %>",
+    "platform": "web",
+    "id": "<%= extensionId %>",
+    "version": "1.0.0"
+}

package/src/generators/app/files/commerce-backend-ui/hooks/check-web-types.sh.template

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+
+echo -e "\n⏩ Checking web types before build... 🔍\n"
+
+if npx tsc --noEmit --project src/commerce-backend-ui-1/web-src/tsconfig.json; then
+  echo -e "\n⏩ Web type checking completed successfully! ✅\n"
+  exit 0
+else
+  echo -e "\n⏩ Web type checking failed: ❌\n"
+  exit 1
+fi

package/src/generators/app/files/commerce-backend-ui/src/commerce-backend-ui-1/actions/registration/index.ts.template

@@ -0,0 +1,32 @@
+<%_ if (sidebarCategory !== 'none') { _%>
+import { EXTENSION_ID } from '../../web-src/src/constants/extension.ts';
+
+<%_ } _%>
+export function main() {
+    return {
+        statusCode: 200,
+        body: {
+            registration: {
+<%_ if (sidebarCategory !== 'none') { _%>
+                menuItems: [
+                    {
+                        id: `${EXTENSION_ID}::<%= appSlug %>`,
+                        title: '<%= displayName %>',
+                        parent: 'aligentApps::<%= sidebarCategory %>',
+                        sortOrder: 10,
+                    },
+                    {
+                        id: 'aligentApps::<%= sidebarCategory %>',
+                        title: '<%= sidebarCategoryTitle %>',
+                        isSection: true,
+                        sortOrder: 20,
+                    },
+                ],
+<%_ } _%>
+                page: {
+                    title: '<%= displayName %>',
+                },
+            },
+        },
+    };
+}

package/src/generators/app/files/commerce-backend-ui/src/commerce-backend-ui-1/actions/tsconfig.json.template

@@ -0,0 +1,8 @@
+{
+    "extends": "../../../tsconfig.base.json",
+    "compilerOptions": {
+        "sourceMap": true
+    },
+    "include": ["**/*.ts", "../../../global-types"],
+    "exclude": []
+}