@openmfp/create-portal 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,78 @@
+# @openmfp/create-portal
+
+A CLI tool for scaffolding OpenMFP Portal projects with a full-stack setup.
+
+## Overview
+
+`create-portal` is a project generator that creates a complete OpenMFP Portal application with:
+
+- **Frontend**: Angular application with OpenMFP Portal UI library
+- **Backend**: NestJS server with OpenMFP Portal server library
+- Pre-configured build and development scripts
+- Modern development environment setup
+
+## Prerequisites
+
+- Node.js >= 24.0.0
+- npm >= 11.0.0
+
+## Installation
+
+### Using npx
+
+```bash
+npx @openmfp/create-portal
+```
+
+### Custom Project Name
+
+Create a portal with a specific name:
+
+```bash
+npx @openmfp/create-portal my-awesome-portal
+```
+
+The script will:
+
+1. Create the project directory
+2. Generate all necessary configuration files
+3. Set up frontend and backend structures
+4. Install all dependencies automatically
+5. Display the complete project structure
+
+## Troubleshooting
+
+### Directory Already Exists
+
+If the target directory already exists, the script will exit with an error. Choose a different project name or remove the existing directory.
+
+### Dependency Installation Fails
+
+If automatic installation fails, you can manually install dependencies:
+
+```bash
+cd my-portal
+npm install
+cd frontend && npm install
+cd ../backend && npm install
+```
+## Repository
+
+- GitHub: [@openmfp/create-portal](https://github.com/openmfp/create-portal)
+- npm: [@openmfp/create-portal](https://www.npmjs.com/package/@openmfp/create-portal)
+
+## Contributing
+
+Please refer to the [CONTRIBUTING](CONTRIBUTING.md) file in this repository for instructions on how to contribute to openMFP.
+
+## Code of Conduct
+
+Please refer to the [CODE_OF_CONDUCT.md](https://github.com/openmfp/create-portal?tab=coc-ov-file) of NeoNephos for information on the expected Code of Conduct for contributing to openMFP.
+
+## Licensing
+
+Please see our [LICENSE](https://github.com/openmfp/create-portal?tab=Apache-2.0-1-ov-file) for copyright and license information. Detailed information including third-party components and their licensing/copyright information is available [via the REUSE tool](https://api.reuse.software/info/github.com/openmfp/create-portal).
+
+## Support
+
+For questions and support, please open an issue on the GitHub repository.

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@openmfp/create-portal",
+  "version": "0.1.0",
+  "description": "CLI tool for scaffolding OpenMFP Portal projects",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/openmfp/create-portal.git"
+  },
+  "bin": "./src/generate-portal.js",
+  "author": "OpenMFP",
+  "license": "Apache-2.0",
+  "type": "module",
+  "keywords": [
+    "openmfp",
+    "portal",
+    "cli",
+    "generator",
+    "create"
+  ],
+  "engines": {
+    "node": "25.7.0",
+    "npm": "11.11.0"
+  },
+  "scripts": {
+    "test": "npm run test:unit && npm run test:integration",
+    "test:unit": "node --test test/generate-portal.test.js test/generators.test.js",
+    "test:integration": "node --test test/generate-portal.integration.test.js",
+    "test:watch": "node --test --watch"
+  },
+  "files": [
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "bugs": {
+    "url": "https://github.com/openmfp/create-portal/issues"
+  },
+  "homepage": "https://github.com/openmfp/create-portal#readme"
+}

package/src/generate-portal.js

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+
+import { execSync } from "child_process";
+import fs from "fs";
+import path from "path";
+import { generateBackendFiles } from "./scripts/backend/backend-generator.js";
+import { generateFrontendFiles } from "./scripts/frontend/frontend-generator.js";
+import { generateRootFiles } from "./scripts/root/root-generator.js";
+
+const args = process.argv.slice(2);
+const skipInstall = args.includes("--skip-install");
+const projectName = args.find((arg) => !arg.startsWith("--")) || "my-portal";
+
+console.log(`\n🚀 Creating portal: ${projectName}\n`);
+
+const projectDir = path.join(process.cwd(), projectName);
+
+if (fs.existsSync(projectDir)) {
+  console.error(`❌ Directory "${projectName}" already exists!`);
+  process.exit(1);
+}
+
+function createDir(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+}
+
+function writeFile(filePath, content) {
+  createDir(path.dirname(filePath));
+  fs.writeFileSync(filePath, content, "utf-8");
+}
+
+function displayProjectStructure(dir, prefix = "", isRoot = true) {
+  if (fs.statSync(dir).isDirectory()) {
+    const items = fs
+      .readdirSync(dir)
+      .filter((item) => !item.startsWith(".") && item !== "node_modules")
+      .map((item) => ({
+        name: item,
+        path: path.join(dir, item),
+        isDirectory: fs.statSync(path.join(dir, item)).isDirectory(),
+      }))
+      .sort((a, b) => {
+        if (a.isDirectory && !b.isDirectory) return -1;
+        if (!a.isDirectory && b.isDirectory) return 1;
+        return a.name.localeCompare(b.name);
+      });
+
+    items.forEach((item, index) => {
+      const isLastItem = index === items.length - 1;
+      const connector = isLastItem ? "└── " : "├── ";
+
+      console.log(prefix + connector + item.name + (item.isDirectory ? "/" : ""));
+
+      if (item.isDirectory) {
+        const newPrefix = prefix + (isLastItem ? "    " : "│   ");
+        displayProjectStructure(item.path, newPrefix, false);
+      }
+    });
+  }
+}
+
+createDir(projectDir);
+
+generateRootFiles(projectDir, projectName, writeFile);
+generateBackendFiles(projectDir, writeFile);
+generateFrontendFiles(projectDir, writeFile, createDir);
+
+console.log("✅ Project structure created successfully!");
+displayProjectStructure(projectDir);
+
+if (skipInstall) {
+  console.log("\n⏭️  Skipping dependency installation\n");
+  console.log("🎉 Portal created successfully!\n");
+  console.log("To get started:\n");
+  console.log(`  cd ${projectName}`);
+  console.log("  npm install");
+  console.log("  npm start\n");
+  process.exit(0);
+}
+
+console.log("\n📦 Installing dependencies...\n");
+
+process.chdir(projectDir);
+
+try {
+  console.log("Installing root dependencies...");
+  execSync("npm install", { stdio: "inherit" });
+
+  console.log("\nInstalling frontend dependencies...");
+  execSync("npm run npm:install:ui", { stdio: "inherit" });
+
+  console.log("\nInstalling backend dependencies...");
+  execSync("npm run npm:install:server", { stdio: "inherit" });
+
+  console.log("\n✅ All dependencies installed successfully!\n");
+  console.log("🎉 Portal created successfully!\n");
+  console.log("To get started:\n");
+  console.log(`  cd ${projectName}`);
+  console.log("  npm start\n");
+  console.log("Frontend: http://localhost:4300");
+  console.log("Backend: http://localhost:3000\n");
+} catch (error) {
+  console.error("\n❌ Error installing dependencies:", error.message);
+  console.log("\nYou can install dependencies manually:");
+  console.log(`  cd ${projectName}`);
+  console.log("  npm install\n");
+  process.exit(1);
+}

package/src/scripts/backend/backend-generator.js

@@ -0,0 +1,52 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export function generateBackendFiles(projectDir, writeFile) {
+  const templatesDir = path.join(__dirname, "templates");
+
+  const backendPackageJson = fs.readFileSync(
+    path.join(templatesDir, "package.json"),
+    "utf-8"
+  );
+
+  writeFile(path.join(projectDir, "backend", "package.json"), backendPackageJson);
+
+  const backendTsConfig = fs.readFileSync(
+    path.join(templatesDir, "tsconfig.json"),
+    "utf-8"
+  );
+
+  writeFile(path.join(projectDir, "backend", "tsconfig.json"), backendTsConfig);
+
+  const backendTsConfigBuild = fs.readFileSync(
+    path.join(templatesDir, "tsconfig.build.json"),
+    "utf-8"
+  );
+
+  writeFile(
+    path.join(projectDir, "backend", "tsconfig.build.json"),
+    backendTsConfigBuild
+  );
+
+  const nestCliJson = fs.readFileSync(path.join(templatesDir, "nest-cli.json"), "utf-8");
+
+  writeFile(path.join(projectDir, "backend", "nest-cli.json"), nestCliJson);
+
+  const backendMainTs = fs.readFileSync(
+    path.join(templatesDir, "src", "main.ts"),
+    "utf-8"
+  );
+
+  writeFile(path.join(projectDir, "backend", "src", "main.ts"), backendMainTs);
+
+  const backendAppModuleTs = fs.readFileSync(
+    path.join(templatesDir, "src", "app.module.ts"),
+    "utf-8"
+  );
+
+  writeFile(path.join(projectDir, "backend", "src", "app.module.ts"), backendAppModuleTs);
+}

package/src/scripts/backend/templates/nest-cli.json

@@ -0,0 +1,4 @@
+{
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src"
+}

package/src/scripts/backend/templates/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "backend",
+  "version": "0.0.1",
+  "private": true,
+  "license": "UNLICENSED",
+  "scripts": {
+    "build": "nest build",
+    "start": "nest start",
+    "start:watch": "nest start --watch",
+    "start:dev": "nest start --watch",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/main"
+  },
+  "dependencies": {
+    "@nestjs/common": "^11.1.9",
+    "@nestjs/core": "^11.1.9",
+    "@nestjs/platform-express": "^11.1.9",
+    "@nestjs/serve-static": "^5.0.4",
+    "@openmfp/portal-server-lib": "^0.163.23",
+    "dotenv": "^17.3.1",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.1"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^11.0.12",
+    "@nestjs/schematics": "^11.0.9",
+    "@types/express": "5.0.6",
+    "@types/node": "24.10.14",
+    "typescript": "^5.8.0"
+  },
+  "type": "module"
+}

package/src/scripts/backend/templates/src/app.module.ts

@@ -0,0 +1,22 @@
+import { Module } from '@nestjs/common';
+import { PortalModule, PortalModuleOptions } from '@openmfp/portal-server-lib';
+import { config } from 'dotenv';
+import * as path from 'node:path';
+
+const __filename = new URL(import.meta.url).pathname;
+const __dirname = path.dirname(__filename);
+
+config({ path: './.env' });
+
+const portalOptions: PortalModuleOptions = {
+  frontendDistSources: path.join(
+    __dirname,
+    '../..',
+    'frontend/dist/frontend/browser',
+  ),
+};
+
+@Module({
+  imports: [PortalModule.create(portalOptions)],
+})
+export class AppModule {}

package/src/scripts/backend/templates/src/main.ts

@@ -0,0 +1,9 @@
+import { AppModule } from './app.module.js';
+import { NestFactory } from '@nestjs/core';
+import { NestExpressApplication } from '@nestjs/platform-express';
+
+async function bootstrap() {
+  const app = await NestFactory.create<NestExpressApplication>(AppModule);
+  await app.listen(process.env.PORT || 3000);
+}
+bootstrap();

package/src/scripts/backend/templates/tsconfig.build.json

@@ -0,0 +1,4 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": ["node_modules", "test", "dist", "**/*spec.ts"]
+}

package/src/scripts/backend/templates/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "module": "NodeNext",
+    "moduleResolution": "node16",
+    "esModuleInterop": true,
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2022",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": false,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "forceConsistentCasingInFileNames": false,
+    "noFallthroughCasesInSwitch": false
+  }
+}

package/src/scripts/frontend/frontend-generator.js

@@ -0,0 +1,132 @@
+import path from "path";
+import fs from "fs";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export function generateFrontendFiles(projectDir, writeFile, createDir) {
+  const templatesDir = path.join(__dirname, "templates");
+
+  const frontendPackageJson = fs.readFileSync(
+    path.join(templatesDir, "package.json"),
+    "utf-8"
+  );
+
+  writeFile(
+    path.join(projectDir, "frontend", "package.json"),
+    frontendPackageJson
+  );
+
+  const frontendTsConfig = fs.readFileSync(
+    path.join(templatesDir, "tsconfig.json"),
+    "utf-8"
+  );
+
+  writeFile(
+    path.join(projectDir, "frontend", "tsconfig.json"),
+    frontendTsConfig
+  );
+
+  const frontendTsConfigApp = fs.readFileSync(
+    path.join(templatesDir, "tsconfig.app.json"),
+    "utf-8"
+  );
+
+  writeFile(
+    path.join(projectDir, "frontend", "tsconfig.app.json"),
+    frontendTsConfigApp
+  );
+
+  const angularJson = fs.readFileSync(
+    path.join(templatesDir, "angular.json"),
+    "utf-8"
+  );
+
+  writeFile(
+    path.join(projectDir, "frontend", "angular.json"),
+    angularJson
+  );
+
+  const proxyConfig = fs.readFileSync(
+    path.join(templatesDir, "proxy.config.json"),
+    "utf-8"
+  );
+
+  writeFile(
+    path.join(projectDir, "frontend", "proxy.config.json"),
+    proxyConfig
+  );
+
+  const frontendMainTs = fs.readFileSync(
+    path.join(templatesDir, "src", "main.ts"),
+    "utf-8"
+  );
+
+  writeFile(path.join(projectDir, "frontend", "src", "main.ts"), frontendMainTs);
+
+  const indexHtml = fs.readFileSync(
+    path.join(templatesDir, "src", "index.html"),
+    "utf-8"
+  );
+
+  writeFile(path.join(projectDir, "frontend", "src", "index.html"), indexHtml);
+
+  const stylesScss = fs.readFileSync(
+    path.join(templatesDir, "src", "styles.scss"),
+    "utf-8"
+  );
+
+  writeFile(path.join(projectDir, "frontend", "src", "styles.scss"), stylesScss);
+
+  const appRoutesTs = fs.readFileSync(
+    path.join(templatesDir, "src", "app", "app.routes.ts"),
+    "utf-8"
+  );
+
+  writeFile(path.join(projectDir, "frontend", "src", "app", "app.routes.ts"), appRoutesTs);
+
+  const environmentTs = fs.readFileSync(
+    path.join(templatesDir, "src", "environments", "environment.ts"),
+    "utf-8"
+  );
+
+  writeFile(
+    path.join(projectDir, "frontend", "src", "environments", "environment.ts"),
+    environmentTs
+  );
+
+  const environmentProdTs = fs.readFileSync(
+    path.join(templatesDir, "src", "environments", "environment.prod.ts"),
+    "utf-8"
+  );
+
+  writeFile(
+    path.join(projectDir, "frontend", "src", "environments", "environment.prod.ts"),
+    environmentProdTs
+  );
+
+  const extractVersionsJs = fs.readFileSync(
+    path.join(templatesDir, "build-scripts", "extract-versions.js"),
+    "utf-8"
+  );
+
+  writeFile(
+    path.join(projectDir, "frontend", "build-scripts", "extract-versions.js"),
+    extractVersionsJs
+  );
+
+  const gitkeep = fs.readFileSync(
+    path.join(templatesDir, "src", "assets", ".gitkeep"),
+    "utf-8"
+  );
+
+  writeFile(path.join(projectDir, "frontend", "src", "assets", ".gitkeep"), gitkeep);
+
+  const favicon = fs.readFileSync(
+    path.join(templatesDir, "src", "favicon.ico"),
+    "utf-8"
+  );
+
+  writeFile(path.join(projectDir, "frontend", "src", "favicon.ico"), favicon);
+}

package/src/scripts/frontend/templates/angular.json

@@ -0,0 +1,97 @@
+{
+  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
+  "version": 1,
+  "newProjectRoot": "projects",
+  "projects": {
+    "frontend": {
+      "projectType": "application",
+      "schematics": {
+        "@schematics/angular:component": {
+          "style": "scss"
+        }
+      },
+      "root": "",
+      "sourceRoot": "src",
+      "prefix": "app",
+      "architect": {
+        "build": {
+          "builder": "@angular/build:application",
+          "options": {
+            "outputPath": {
+              "base": "dist/frontend"
+            },
+            "index": "src/index.html",
+            "polyfills": ["@angular/localize/init"],
+            "tsConfig": "tsconfig.app.json",
+            "inlineStyleLanguage": "scss",
+            "assets": [
+              "src/favicon.ico",
+              "src/assets",
+              {
+                "glob": "**",
+                "input": "node_modules/@openmfp/portal-ui-lib/assets/",
+                "output": "/assets/"
+              },
+              {
+                "glob": "**",
+                "input": "node_modules/@luigi-project/core",
+                "output": "/luigi-core"
+              }
+            ],
+            "styles": ["src/styles.scss"],
+            "scripts": [],
+            "browser": "src/main.ts"
+          },
+          "configurations": {
+            "production": {
+              "budgets": [
+                {
+                  "type": "initial",
+                  "maximumWarning": "500kb",
+                  "maximumError": "2mb"
+                },
+                {
+                  "type": "anyComponentStyle",
+                  "maximumWarning": "2kb",
+                  "maximumError": "4kb"
+                }
+              ],
+              "fileReplacements": [
+                {
+                  "replace": "src/environments/environment.ts",
+                  "with": "src/environments/environment.prod.ts"
+                }
+              ],
+              "outputHashing": "all"
+            },
+            "development": {
+              "optimization": false,
+              "extractLicenses": false,
+              "sourceMap": true,
+              "namedChunks": true
+            }
+          },
+          "defaultConfiguration": "production"
+        },
+        "serve": {
+          "builder": "@angular/build:dev-server",
+          "options": {
+            "proxyConfig": "proxy.config.json"
+          },
+          "configurations": {
+            "production": {
+              "buildTarget": "frontend:build:production"
+            },
+            "development": {
+              "buildTarget": "frontend:build:development"
+            }
+          },
+          "defaultConfiguration": "development"
+        }
+      }
+    }
+  },
+  "cli": {
+    "analytics": false
+  }
+}

package/src/scripts/frontend/templates/build-scripts/extract-versions.js

@@ -0,0 +1,21 @@
+const fs = require('fs');
+const path = require('path');
+
+const packageJsonPath = path.join(__dirname, '..', 'package.json');
+const outputPath = path.join(__dirname, '..', 'src', 'assets', 'dependencies-versions.json');
+
+try {
+  const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+  const versions = {
+    ...packageJson.dependencies,
+    ...packageJson.devDependencies,
+  };
+  
+  fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+  fs.writeFileSync(outputPath, JSON.stringify(versions, null, 2));
+  
+  console.log('✓ Dependencies versions extracted');
+} catch (error) {
+  console.error('Error extracting versions:', error);
+  process.exit(1);
+}

package/src/scripts/frontend/templates/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "frontend",
+  "version": "0.0.0",
+  "scripts": {
+    "ng": "ng",
+    "extract-versions": "node ./build-scripts/extract-versions.js",
+    "prebuild": "npm run extract-versions",
+    "prebuild:watch": "npm run extract-versions",
+    "prestart": "npm run extract-versions",
+    "prestart:watch": "npm run extract-versions",
+    "start": "ng serve --port 4300",
+    "build": "ng build",
+    "build:watch": "ng build --watch --configuration development"
+  },
+  "private": true,
+  "dependencies": {
+    "@angular/animations": "21.1.4",
+    "@angular/common": "21.1.4",
+    "@angular/compiler": "21.1.4",
+    "@angular/core": "21.1.4",
+    "@angular/elements": "21.1.4",
+    "@angular/forms": "21.1.4",
+    "@angular/localize": "21.1.4",
+    "@angular/platform-browser": "21.1.4",
+    "@angular/platform-browser-dynamic": "21.1.4",
+    "@angular/router": "21.1.4",
+    "@luigi-project/client": "2.27.0",
+    "@luigi-project/core": "2.27.0",
+    "@luigi-project/plugin-auth-oauth2": "2.27.0",
+    "@openmfp/portal-ui-lib": "0.192.1",
+    "rxjs": "7.8.2",
+    "tslib": "2.8.1"
+  },
+  "devDependencies": {
+    "@angular-devkit/build-angular": "21.1.4",
+    "@angular/build": "21.1.4",
+    "@angular/cli": "21.1.4",
+    "@angular/compiler-cli": "21.1.4",
+    "nodemon": "3.1.14",
+    "rimraf": "6.1.3",
+    "typescript": "5.9.3"
+  }
+}

package/src/scripts/frontend/templates/proxy.config.json

@@ -0,0 +1,8 @@
+{
+  "/rest/**": {
+    "target": "http://localhost:3000",
+    "changeOrigin": true,
+    "secure": false,
+    "logLevel": "debug"
+  }
+}

package/src/scripts/frontend/templates/src/app/app.routes.ts

@@ -0,0 +1,3 @@
+import { Routes } from '@angular/router';
+
+export const routes: Routes = [];

package/src/scripts/frontend/templates/src/environments/environment.prod.ts

@@ -0,0 +1,3 @@
+export const environment = {
+  production: true,
+};

package/src/scripts/frontend/templates/src/environments/environment.ts

@@ -0,0 +1,3 @@
+export const environment = {
+  production: false,
+};

package/src/scripts/frontend/templates/src/index.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>OpenMFP Portal</title>
+    <base href="/">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link rel="stylesheet" href="/luigi-core/luigi_horizon.css" />
+</head>
+    <body>
+        <noscript>You need to enable JavaScript to run this app.</noscript>
+        <script src="/luigi-core/luigi.js"></script>
+        <app-portal></app-portal>
+    </body>
+</html>

package/src/scripts/frontend/templates/src/main.ts

@@ -0,0 +1,9 @@
+import { provideZonelessChangeDetection } from "@angular/core";
+import { bootstrapApplication } from "@angular/platform-browser";
+import { PortalComponent, PortalOptions, providePortal } from "@openmfp/portal-ui-lib";
+
+const portalOptions: PortalOptions = {};
+
+bootstrapApplication(PortalComponent, {
+  providers: [provideZonelessChangeDetection(), providePortal(portalOptions)],
+}).catch((err) => console.error(err));

package/src/scripts/frontend/templates/src/styles.scss

@@ -0,0 +1 @@
+/* You can add global styles to this file, and also import other style files */

package/src/scripts/frontend/templates/tsconfig.app.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./out-tsc/app",
+    "types": []
+  },
+  "files": ["src/main.ts"],
+  "include": ["src/**/*.d.ts"]
+}

package/src/scripts/frontend/templates/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compileOnSave": false,
+  "compilerOptions": {
+    "outDir": "./dist/out-tsc",
+    "strict": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "sourceMap": true,
+    "declaration": false,
+    "experimentalDecorators": true,
+    "moduleResolution": "node",
+    "importHelpers": true,
+    "target": "ES2022",
+    "module": "ES2022",
+    "useDefineForClassFields": false,
+    "lib": ["ES2022", "dom"],
+    "resolveJsonModule": true
+  },
+  "angularCompilerOptions": {
+    "enableI18nLegacyMessageIdFormat": false,
+    "strictInjectionParameters": true,
+    "strictInputAccessModifiers": true,
+    "strictTemplates": true
+  }
+}

package/src/scripts/root/root-generator.js

@@ -0,0 +1,26 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export function generateRootFiles(projectDir, projectName, writeFile) {
+  const templatesDir = path.join(__dirname, "templates");
+
+  const rootPackageJson = fs
+    .readFileSync(path.join(templatesDir, "package.json"), "utf-8")
+    .replace(/{{projectName}}/g, projectName);
+
+  writeFile(path.join(projectDir, "package.json"), rootPackageJson);
+
+  const readme = fs
+    .readFileSync(path.join(templatesDir, "README.md"), "utf-8")
+    .replace(/{{projectName}}/g, projectName);
+
+  writeFile(path.join(projectDir, "README.md"), readme);
+
+  const gitignore = fs.readFileSync(path.join(templatesDir, ".gitignore"), "utf-8");
+
+  writeFile(path.join(projectDir, ".gitignore"), gitignore);
+}

package/src/scripts/root/templates/README.md

@@ -0,0 +1,49 @@
+# {{projectName}}
+
+OpenMFP Portal
+
+## Prerequisites
+
+- Node.js >= 24.0.0
+- npm >= 11.0.0
+
+## Installation
+
+```bash
+npm install
+```
+
+This will install dependencies for both frontend and backend.
+
+## Development
+
+Start both frontend and backend in development mode:
+
+```bash
+npm start
+```
+
+- Frontend will be available at: http://localhost:4300
+- Backend will be available at: http://localhost:3000
+
+## Build
+
+Build both frontend and backend:
+
+```bash
+npm run build
+```
+
+## Project Structure
+
+- `backend/` - NestJS backend application
+- `frontend/` - Angular frontend application
+
+## Available Scripts
+
+- `npm start` - Start both frontend and backend in development mode
+- `npm run build` - Build both applications
+- `npm run start:ui` - Start only frontend
+- `npm run start:server` - Start only backend
+- `npm run build:ui` - Build only frontend
+- `npm run build:server` - Build only backend

package/src/scripts/root/templates/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "{{projectName}}",
+  "version": "1.0.0",
+  "description": "OpenMFP Portal",
+  "engines": {
+    "node": "25.7.0",
+    "npm": "11.11.0"
+  },
+  "scripts": {
+    "npm:install:ui": "cd frontend && npm install",
+    "npm:install:server": "cd backend && npm install",
+    "build": "concurrently 'npm:build:ui' 'npm:build:server'",
+    "build:ui": "cd frontend && npm run build",
+    "build:server": "cd backend && npm run build",
+    "start": "concurrently 'npm:start:ui' 'npm:start:server'",
+    "start:ui": "cd frontend && npm run start",
+    "start:server": "cd backend && npm run start",
+    "build:ui:watch": "cd frontend && npm run build:watch",
+    "start:server:watch": "cd backend && npm run start:watch",
+    "start:watch": "concurrently 'npm:start:server:watch' 'npm:build:ui:watch'"
+  },
+  "devDependencies": {
+    "concurrently": "9.2.1"
+  },
+  "private": true
+}