@madgex/fert 7.2.1 → 7.4.0

package/bin/validators/required-assets.validator.js

@@ -0,0 +1,34 @@
+import path from 'node:path';
+import * as validation from '../utils/validation.js';
+import { exists } from '../utils/index.js';
+
+export const name = 'required-assets';
+export const description = 'Validates that required asset files exist in the service public directory';
+
+/**
+ * Main validation function.
+ * Checks for required assets like favicon.ico
+ * @property {object} options
+ * @property {FertConfig} options.fertConfig - Resolved config
+ * @returns {Promise<Array<ValidationResult>>} Array of validation results
+ */
+export async function validate({ fertConfig }) {
+  const resultsCollection = validation.createResultCollection();
+
+  const publicDir = path.resolve(fertConfig.workingDir, 'public');
+
+  // Check for favicon.ico (ERROR if missing)
+  const faviconPath = path.join(publicDir, 'images', 'favicon.ico');
+  if (!(await exists(faviconPath))) {
+    resultsCollection
+      .addResult('Missing required favicon.ico')
+      .err()
+      .filePath(faviconPath)
+      .detail('Every service must include a favicon.ico file at public/images/favicon.ico');
+  }
+
+  // TODO: Add font file validation (WARNING) if referenced in brand.json or CSS
+  // TODO: Add icon file validation (WARNING) if referenced in templates or CSS
+
+  return resultsCollection.results;
+}

package/bin/validators/service-config.validator.js

@@ -0,0 +1,121 @@
+import path from 'node:path';
+import * as validation from '../utils/validation.js';
+import { FERT_SERVICE_CONFIG_FILENAME } from '../../constants.js';
+import { exists, loadConfigFromFile } from '../utils/index.js';
+
+export const name = 'service-config';
+export const description = 'Validates fert.service.config.js structure and required fields';
+
+/**
+ * Main validation function.
+ * Validates the raw service config file (not the merged/resolved fertConfig).
+ * @property {object} options
+ * @property {FertConfig} options.fertConfig - Resolved config (used to locate the raw config file)
+ * @returns {Promise<Array<ValidationResult>>} Array of validation results
+ */
+export async function validate({ fertConfig }) {
+  const resultsCollection = validation.createResultCollection();
+
+  const configPath = path.resolve(fertConfig.workingDir, FERT_SERVICE_CONFIG_FILENAME);
+
+  // Load raw service config from file
+  if (!(await exists(configPath))) {
+    resultsCollection
+      .addResult(`Service config file not found: ${FERT_SERVICE_CONFIG_FILENAME}`)
+      .err()
+      .filePath(configPath)
+      .detail('Each service must have a fert.service.config.js file');
+    return resultsCollection.results;
+  }
+
+  let rawConfig;
+  try {
+    rawConfig = await loadConfigFromFile({
+      dir: fertConfig.workingDir,
+      filename: FERT_SERVICE_CONFIG_FILENAME,
+      silent: true,
+    });
+
+    if (!rawConfig) {
+      resultsCollection
+        .addResult(`Failed to load service config file`)
+        .err()
+        .filePath(configPath)
+        .detail('The config file could not be imported. Check for syntax errors.');
+      return resultsCollection.results;
+    }
+  } catch (err) {
+    resultsCollection
+      .addResult(`Failed to parse service config: ${err.message}`)
+      .err()
+      .filePath(configPath)
+      .detail('Ensure the file exports a valid configuration object');
+    return resultsCollection.results;
+  }
+
+  // Validate serviceName (required, ERROR)
+  if (!rawConfig.serviceName) {
+    resultsCollection
+      .addResult('Missing required field: serviceName')
+      .err()
+      .filePath(configPath)
+      .detail('serviceName must be specified as a string (e.g., "jobseekers-frontend")');
+  } else if (typeof rawConfig.serviceName !== 'string') {
+    resultsCollection
+      .addResult('Invalid serviceName type')
+      .err()
+      .filePath(configPath)
+      .detail(`serviceName must be a string, got ${typeof rawConfig.serviceName}`);
+  } else if (rawConfig.serviceName.trim() === '') {
+    resultsCollection
+      .addResult('serviceName cannot be empty')
+      .err()
+      .filePath(configPath)
+      .detail('serviceName must be a non-empty string (e.g., "jobseekers-frontend")');
+  }
+
+  // Validate entry (required, ERROR)
+  if (!rawConfig.entry) {
+    resultsCollection
+      .addResult('Missing required field: entry')
+      .err()
+      .filePath(configPath)
+      .detail('entry must be specified as a string path (e.g., "./src/index.js")');
+  } else if (typeof rawConfig.entry !== 'string') {
+    resultsCollection
+      .addResult('Invalid entry type')
+      .err()
+      .filePath(configPath)
+      .detail(`entry must be a string, got ${typeof rawConfig.entry}`);
+  }
+
+  // Validate externalAssets.links (optional, WARNING)
+  if (rawConfig.externalAssets?.links !== undefined) {
+    const { links } = rawConfig.externalAssets;
+    const isValidType =
+      typeof links === 'string' || (Array.isArray(links) && links.every((link) => typeof link === 'string'));
+
+    if (!isValidType) {
+      resultsCollection
+        .addResult('Invalid externalAssets.links type')
+        .filePath(configPath)
+        .detail('externalAssets.links must be a string or an array of strings');
+    }
+  }
+
+  // Validate externalAssets.scripts (optional, WARNING)
+  if (rawConfig.externalAssets?.scripts !== undefined) {
+    const { scripts } = rawConfig.externalAssets;
+    const isValidType =
+      typeof scripts === 'string' || (Array.isArray(scripts) && scripts.every((script) => typeof script === 'string'));
+
+    if (!isValidType) {
+      resultsCollection
+        .addResult('Invalid externalAssets.scripts type')
+        .filePath(configPath)
+        .detail('externalAssets.scripts must be a string or an array of strings');
+    }
+  }
+
+  return resultsCollection.results;
+}

package/constants.js

@@ -47,8 +47,6 @@ export const ASSET_STORE_INVALIDATION_PATH = `/{fertConfig.client.rootClientProp
 
 export const ASSET_STORE_USER_GUID = 'a386d4b6-f2df-4b80-ad1f-0349e23f530b';
 
-export const CONFIG_API =
-  'https://configuration-api.job.madgexhosting.net/configs/override/{cpid}/production/{configGroup}/{config}';
 export const CONFIG_DIR = 'config';
 
 /** we assume the remove version of a service hosts an api translations endpoint */

package/docs/FAQ.md

@@ -0,0 +1 @@
+-

package/docs/README.md

@@ -12,14 +12,28 @@ Check out [Branding Repository Overview](BRANDING_REPO_OVERVIEW.md) for the stru
 
 Find out your `Client Property ID` by visiting [Madgexverse](https://madgexverse.job.madgexhosting.net). If your CPID does not exist, you can not work on this Branding Repo right now.
 
-This will give you your repository `https://github.com/wiley/madgex-<CPID>` e.g. https://github.com/wiley/madgex-ff6102ff-0f4b-43d1-a2c7-83b835b8dee5. If this is a brand new client, the Branding Repo should be automatically created on `master` branch.
+This will give you your repository `https://github.com/wiley/madgex-<CPID>` e.g. https://github.com/wiley/madgex-ff6102ff-0f4b-43d1-a2c7-83b835b8dee5. If this is a brand new client, the Branding Repo will have no branches. See below for empty Branding Repo instructions.
 
 > **Ask Systems why, if this is not automatically created**
 
-### If you have an **empty** Branding Repo (e.g. a git repository has been set up but has no files)
+### If you have an **empty** Branding Repo (e.g. a git repository has been set up but has no branches or files)
+
+To begin with, lets make sure the `master` branch exists (even without commits yet!). Its important that a branch named `master` exists for our infrastructure to work (e.g. jenkins)
+
+- After you have checked out an empty Branding Repo, `cd` into your empty git repo folder
+
+  > Although this should not happen on new Branding Repos: if the current branch says `main` instead of `master`, we need to fix this.
+  >
+  > - Rename the `main` branch to `master` (I use vscode and right click on the branch and select `rename branch`) or cli `git branch -m main master`
+
+- Now we have an empty branch called `master` on our local machine, we can make an empty commit to this branch, then push it to github remote.
+- `git commit --allow-empty -m "init"`
+- `git push -u origin master`
+
+Now `master` branch is properly created _and_ exists on github remote (although we have not committed to it yet!), lets do our first bit of work in a new branch. `master` should only be merged into from other branches via PRs in github.
 
 - Switch into a new branch
-- `cd` into your cloned empty git repo. Use `npx @madgex/fert init .` and follow the prompts, this will populate your directory, including at least one `service` where the majority of the work will be done.
+- Use `npx @madgex/fert init .` and follow the prompts, this will populate your directory, including at least one `service` where the majority of the work will be done.
 - `npm i` install packages.
 
 ### If you have an existing Branding Repo
@@ -63,15 +77,20 @@ Themes work better on V5 than Custom templates. If you must create Custom templa
 
 ### Custom template
 
-> Coming soon? Custom template starter-from-theme?
+If the client has pushed us to design a Custom design, then we can create a good starting point by cloning an existing Theme into a branding repo service.
+Then you will have your own copy of the Theme files to modify to match the design.
+
+Run the FERT command `init-template` like so `npx @madgex/fert init-template`, in the root of an existing branding repo, and follow the prompts to select the Theme you would like to clone, and which service it will be for.
+
+### Available global Nunjucks context
 
-Available global Nunjucks context:
+Variables and functions available in the Nunjucks templates.
 
-- `templatePath: string`: Required prefix for importing additional Nunjucks files e.g. `{%- include templatePath + './include/my-other-file.njk' -%}`
-- `path: string`: current page relative URL
-- `normaliseUrl: Filter`: removes trailing slash from a URL, e.g. `{{path === myNavLink | normaliseUrl }}`
-- `getServiceRoute(serviceRouterId,routeId,paramsObj,queryObj):Function` : [ usage](https://github.com/wiley/madgex-hapi-reverse-router/blob/master/packages/@madgex.hapi-reverse-router/README.md#usage-example)
-- `getAbsoluteServiceRoute(serviceRouterId,routeId,paramsObj,queryObj):Function` : [ usage](https://github.com/wiley/madgex-hapi-reverse-router/blob/master/packages/@madgex.hapi-reverse-router/README.md#usage-example)
+- `templatePath: string`: **Required** prefix for `import`/`include` additional Nunjucks files e.g. `{%- from './include/my-other-file.njk' import myOtherFileMacro with context -%} {%- include templatePath + './include/my-other-file.njk' -%}`
+- `path: string`: current page relative URL, (does not have trailing slash!) - use in navigation for current page check
+- `normaliseUrl: Filter`: removes trailing slash from a URL, good for comparison with `path`, e.g. `{{path === myNavLink | normaliseUrl }}`
+- `getServiceRoute(serviceRouterId,routeId,paramsObj,queryObj):Function` : recommended to generate _relative_ URLs from V5 source of truth, instead of hand-written [usage](https://github.com/wiley/madgex-hapi-reverse-router/blob/master/packages/@madgex.hapi-reverse-router/README.md#usage-example)
+- `getAbsoluteServiceRoute(serviceRouterId,routeId,paramsObj,queryObj):Function` : recommended to generate _absolute_ URLs from V5 source of truth, instead of hand-written [usage](https://github.com/wiley/madgex-hapi-reverse-router/blob/master/packages/@madgex.hapi-reverse-router/README.md#usage-example)
   - routeId reference for [`"jobseekersite"`](https://jobseekers-frontend.job.madgexhosting.net/api/routing-table/ff6102ff-0f4b-43d1-a2c7-83b835b8dee5)
   - routeId reference for [`"recruitersite"`](https://recruiterservices-frontend.job.madgexhosting.net/api/routing-table/ff6102ff-0f4b-43d1-a2c7-83b835b8dee5)
   - e.g. `{{getServiceRoute('jobseekersite', 'account.login', {}, {Pipline: path})}}`
@@ -79,7 +98,7 @@ Available global Nunjucks context:
 
 ## 🔠 Service V6 translations
 
-Each `service` in a branding repo may have **optional** translation overrides.
+Each `service` in a branding repo may have **optional** translation overrides. These are consumed by the V6 service (so not consumed by the header/footer)
 
 These live at `<root>/services/<SERVICE_NAME>/public/translation.json`, e.g. https://github.com/wiley/madgex-ff6102ff-0f4b-43d1-a2c7-83b835b8dee5/blob/901e5b2295892747015bd1c9bab7ac307b4e2112/services/jobseekers-frontend/public/translation.json .
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madgex/fert",
-  "version": "7.2.1",
+  "version": "7.4.0",
   "description": "Tool to help build the V6 branding",
   "bin": {
     "fert": "./bin/cli.js"
@@ -48,7 +48,7 @@
     "prompts": "2.4.2",
     "rimraf": "6.1.3",
     "sass": "1.98.0",
-    "simple-git": "3.33.0",
+    "simple-git": "3.36.0",
     "simple-update-notifier": "2.0.0",
     "uuid-validate": "0.0.3",
     "vite": "7.3.2",

package/repo-template/services/jobseekers-frontend/templates/footer.njk

@@ -1,20 +1,19 @@
-{%- from templatePath + 'translations/en.njk' import translations -%}
+{# Populate this entry file with a Theme generated from https://header-footer-podlet.job.madgexhosting.net/storybook/
+{{ FooterThemeColumns( <-- macro name which is globally accessible without doing an import, see Storybook for Theme's macro name
+  {
+    "macroName": "FooterThemeColumns",
+    "serviceName": "jobseekers-frontend", <-- ensure serviceName is correct for this service
+    "locale": "en",
+    "cssVarColorText": "#000",
+    ...more args generated from Header Footer Podlet's Storybook
+  }
+)}}
+ #}
 
-<div  data-block="footer-main" class="position-static" scoped-v6="">
-  <footer role="contentinfo" class="contentinfo">
-    <div class="back-to-top">
-      <div class="wrapper cf">
-        <p class="right-text no-margin">
-          <a href="#top-bar" class="js-smooth-scrollto block-level">{{ translations.footer["back-to-top"] }}</a>
-        </p>
-      </div>
-    </div>
-    <div class="wrapper content">
-      {% include templatePath + './includes/footer-nav.njk' %}
-      
-      <p class="copyright no-margin">
-        © 2008 - {{ dayjs().format('YYYY') }} bigworkbag.com, all rights reserved. Powered by Madgex Job Board Software
-      </p>
-    </div>
-  </footer>
-</div>
+{# 
+Alternatively, if this client has pushed for a Custom non-Theme design, you can run `npx @madgex/fert init-template` from the root of this branding repo and follow the prompts.
+This will clone a custom version of one of the Themes from header-footer-podlet which you can modify completely.
+
+🚨🚨🚨 Remember Custom non-Theme designs are discourage and should only happen if the client really pushed for it.
+If there are only minor differences from a Theme and the design, then pushed back and get back into a standard Theme 🚨🚨🚨
+ #}

package/repo-template/services/jobseekers-frontend/templates/header.njk

@@ -1,74 +1,19 @@
-<!-- HEADER-FOOTER-PODLET VERSION: {{ version }} -->
-
-{%- from templatePath + './translations/en.njk' import translations -%}
-
-<div data-block="header-main" class="position-static" scoped-v6="">
-
-  <div id="ad-leaderboard" class="ad ad--leaderboard ad--leaderboard--empty"></div>
-
-  <header role="banner" class="banner">
-    <div id="top-bar" class="top-bar">
-      <div class="wrapper cf">
-
-        <ul class="nav-toggles cf js-togglable-nav-triggers">
-          <li class="nav-toggles__item nav-toggles__item--primary">
-            <mdgx-togglable-nav aria-controls="primary-nav">
-              <a href="#primary-nav" title="Main menu" class="js-togglable-nav-trigger">
-                <i class="burger" aria-hidden="true"></i>
-                <span class="hidden">{{ translations.header["skip-to-main-menu"] }}</span>
-              </a>
-            </mdgx-togglable-nav>
-          </li>
-
-          <li class="nav-toggles__item nav-toggles__item--secondary">
-            <mdgx-togglable-nav aria-controls="secondary-nav">
-              <a href="#secondary-nav" title="User menu" class="js-togglable-nav-trigger">
-                <i class="icon-after" data-icon="☺" aria-hidden="true"></i>
-                <span class="hidden">{{ translations.header["skip-to-user-menu"] }}</span>
-              </a>
-            </mdgx-togglable-nav>
-          </li>
-        </ul>
-
-        <nav aria-label="{{ translations.header["user"] }}" id="secondary-nav" class="secondary-nav togglable-nav cf js-togglable-nav">
-          <ul class="secondary-nav__items togglable-nav__items cf">
-            <li class="togglable-nav__item secondary-nav__item secondary-nav--jobseekers jobseekers jobseekers-nav">
-              {# User Nav #}
-              {%- ifAsync auth.isAuthenticated %}
-                {% include templatePath + './includes/user-nav/authenticated.njk' %}
-              {%- else %}
-                {% include templatePath + './includes/user-nav/unauthenticated.njk' %}
-              {% endif -%}
-            </li>
-            <li class="togglable-nav__item secondary-nav__item secondary-nav--recruiters recruiters recruiters-nav">
-              <ul class="recruiters__items cf">
-                <li class="togglable-nav__item recruiters__item recruiters__item--button">
-                  <a
-                    href="https://bigworkbag-rs.madgexjb.com/" {# Add recruiter site link var #}
-                    data-icon="▶"
-                    class="button button--brand icon-after icon-white js-recruiter-link recruiters__item--link">{{ translations.header["recruiters"] }}
-                  </a>
-                </li>
-              </ul>
-            </li>
-          </ul>
-        </nav>
-
-      </div>
-    </div>
-    <div id="ad-mobileleaderboard" class="ad--mobileleaderboard ad--mobileleaderboard--empty"></div>
-
-    <div class="wrapper cf">
-      <div class="primary-logo">
-        <a href="/">
-          <img src="/public/images/logo.png" alt="Bigworkbag Home"/>
-        </a>
-      </div>
-    </div>
-
-    {% include templatePath + './includes/main-nav.njk' %}
-
-  </header>
-</div>
-
-<!-- END HEADER FRAGMENT -->
+{# Populate this entry file with a Theme generated from https://header-footer-podlet.job.madgexhosting.net/storybook/
+{{ HeaderThemeInlineUserNav( <-- macro name which is globally accessible without doing an import, see Storybook for Theme's macro name
+  {
+    "macroName": "HeaderThemeInlineUserNav",
+    "serviceName": "jobseekers-frontend", <-- ensure serviceName is correct for this service
+    "locale": "en",
+    "cssVarColorText": "#000",
+    ...more args generated from Header Footer Podlet's Storybook
+  }
+)}}
+ #}
+
+{# 
+Alternatively, if this client has pushed for a Custom non-Theme design, you can run `npx @madgex/fert init-template` from the root of this branding repo and follow the prompts.
+This will clone a custom version of one of the Themes from header-footer-podlet which you can modify completely.
+
+🚨🚨🚨 Remember Custom non-Theme designs are discourage and should only happen if the client really pushed for it.
+If there are only minor differences from a Theme and the design, then pushed back and get back into a standard Theme 🚨🚨🚨
+ #}

package/repo-template/services/recruiterservices-frontend/templates/footer.njk

@@ -1,18 +1,19 @@
-{%- from templatePath + 'translations/en.njk' import translations -%}
-{%- from templatePath + 'includes/footer/footer-nav.njk' import footerNav with context -%}
-
-{%- from templatePath + 'context/links.njk' import footerNavigationColumns as footerNavigation -%}
-{# {%- from templatePath + 'context/links.njk' import footerNavigationHorizontal as footerNavigation -%} #}
-
-<footer data-block="footer-main" scoped-v6="">
-  <div class="site-width-wrapper">
-    {{ footerNav(footerNavigation) }}
-
-    {% include templatePath + 'includes/footer/social-links.njk' %}
-
-    <p class="copyright">
-      © 2011 - {{ dayjs().format('YYYY') }} {{ translations["site-name"] }}. All rights reserved.
-      Powered by <a href="https://www.wiley.com/en-gb/business/workforce/madgex/solutions">Madgex Job Board Software</a>
-    </p>
-  </div>
-</footer>
+{# Populate this entry file with a Theme generated from https://header-footer-podlet.job.madgexhosting.net/storybook/
+{{ FooterThemeColumns( <-- macro name which is globally accessible without doing an import, see Storybook for Theme's macro name
+  {
+    "macroName": "FooterThemeColumns",
+    "serviceName": "recruiterservices-frontend", <-- ensure serviceName is correct for this service
+    "locale": "en",
+    "cssVarColorText": "#000",
+    ...more args generated from Header Footer Podlet's Storybook
+  }
+)}}
+ #}
+
+{# 
+Alternatively, if this client has pushed for a Custom non-Theme design, you can run `npx @madgex/fert init-template` from the root of this branding repo and follow the prompts.
+This will clone a custom version of one of the Themes from header-footer-podlet which you can modify completely.
+
+🚨🚨🚨 Remember Custom non-Theme designs are discourage and should only happen if the client really pushed for it.
+If there are only minor differences from a Theme and the design, then pushed back and get back into a standard Theme 🚨🚨🚨
+ #}

package/repo-template/services/recruiterservices-frontend/templates/header.njk

@@ -1,82 +1,19 @@
-{%- from templatePath + 'translations/en.njk' import translations -%}
-{%- from templatePath + 'includes/user-nav/user-nav.njk' import UserNavigation with context -%}
-
-{%- ifAsync auth.isAuthenticated -%}
-  {% set primaryRecruiter = auth.artifacts.recruiters | selectattr("isPrimary") | first %}
-  {% set isAuthenticated = true %}
-{%- endif -%}
-
-<!-- HEADER-FOOTER-PODLET VERSION: {{ version }} -->
-<div data-block="header-main" scoped-v6="">
-  <header role="banner" id="top-bar">
-
-    {# Mobile Navigation #}
-    <div class="mobile-navbar">
-
-      {# Main Navigation #}
-      <mds-dropdown-nav target="primary-nav_mobile" aria-label="{{ translations["primary-nav-button"] }}" class="toggle-nav_button toggle-nav--primary-nav">
-        <svg aria-hidden="true" focusable="false" class="icon" alt="">
-          <use href="/public/icons/icons.svg#icon-menu"></use>
-        </svg>
-      </mds-dropdown-nav>
-      <div id="primary-nav_mobile" class="toggle-nav_content">
-        {% include templatePath + 'includes/primary-nav.njk' %}
-      </div>
-
-      {# Basket Navigation #}
-      {%- if isAuthenticated -%}
-        <mds-dropdown-nav target="basket-nav_mobile" aria-label="{{ translations["basket-nav-button"] }}" class="toggle-nav_button toggle-nav--basket-nav">
-          <svg aria-hidden="true" focusable="false" class="icon" alt="">
-            <use href="/public/icons/icons.svg#icon-cart"></use>
-          </svg>
-        </mds-dropdown-nav>
-        <div id="basket-nav_mobile" class="toggle-nav_content">
-          {% include templatePath + 'includes/basket-nav.njk' %}
-        </div>
-      {%- endif -%}
-
-      {# User Navigation #}
-      <mds-dropdown-nav target="user-nav_mobile" aria-label="{{ translations["user-nav-button"] }}" class="toggle-nav_button toggle-nav--user-nav">
-        <svg aria-hidden="true" focusable="false" class="icon" alt="">
-          <use href="/public/icons/icons.svg#icon-user"></use>
-        </svg>
-      </mds-dropdown-nav>
-      <div id="user-nav_mobile" class="toggle-nav_content">
-        {{ UserNavigation({ switchCompanyForm: false, isAuthenticated: isAuthenticated, primaryRecruiter: primaryRecruiter }) }}
-      </div>
-    </div>
-
-    {# Main Banner #}
-    <div>
-      <div class="site-width-wrapper main-banner">
-
-        {# Primary Logo #}
-        <div class="primary-logo">
-          <a href="/">
-            <img src="/public/images/logo.png" alt="{{ translations["logo-alt"] }}"/>
-          </a>
-        </div>
-
-        <div class="secondary-navs">
-
-          {# User Navigation #}
-          {{ UserNavigation({ switchCompanyForm: true, isAuthenticated: isAuthenticated, primaryRecruiter: primaryRecruiter }) }}
-
-          {# Basket #}
-          {%- if isAuthenticated -%}
-            {% include templatePath + 'includes/basket-nav.njk' %}
-          {%- endif -%}
-        </div>
-      </div>
-
-      {# Primary Navigation #}
-      <div>
-        <div class="site-width-wrapper main-nav">
-          {% include templatePath + 'includes/primary-nav.njk' %}
-        </div>
-      </div>
-    </div>
-  </header>
-</div>
-
-<!-- END HEADER FRAGMENT -->
+{# Populate this entry file with a Theme generated from https://header-footer-podlet.job.madgexhosting.net/storybook/
+{{ HeaderThemeInlineUserNav( <-- macro name which is globally accessible without doing an import, see Storybook for Theme's macro name
+  {
+    "macroName": "HeaderThemeInlineUserNav",
+    "serviceName": "recruiterservices-frontend", <-- ensure serviceName is correct for this service
+    "locale": "en",
+    "cssVarColorText": "#000",
+    ...more args generated from Header Footer Podlet's Storybook
+  }
+)}}
+ #}
+
+{# 
+Alternatively, if this client has pushed for a Custom non-Theme design, you can run `npx @madgex/fert init-template` from the root of this branding repo and follow the prompts.
+This will clone a custom version of one of the Themes from header-footer-podlet which you can modify completely.
+
+🚨🚨🚨 Remember Custom non-Theme designs are discourage and should only happen if the client really pushed for it.
+If there are only minor differences from a Theme and the design, then pushed back and get back into a standard Theme 🚨🚨🚨
+ #}

package/types.d.ts

@@ -38,6 +38,7 @@ interface FertServiceConfigFile {
   };
 }
 type Client = {
+  name: string;
   brandName: string;
   parentCpid: string;
   rootClientPropertyId: string;

package/repo-template/services/jobseekers-frontend/templates/context/footer-nav.njk

@@ -1,27 +0,0 @@
-{% set footerNavigation = [
-    {
-        "href": "/about-us",
-        "label": "About us",
-        "openInNewWindow": false
-    },
-    {
-        "href": "/contact-us",
-        "label": "Contact us",
-        "openInNewWindow": false
-    },
-    {
-        "href": "/terms-and-conditions/",
-        "label": "Terms & conditions",
-        "openInNewWindow": false
-    },
-    {
-        "href": "/privacy-policy",
-        "label": "Privacy Policy",
-        "openInNewWindow": false
-    },
-    {
-        "href": "https://bigworkbag-rs.madgexjb.com/",
-        "label": "Advertise with us",
-        "openInNewWindow": false
-    }
-] %}

package/repo-template/services/jobseekers-frontend/templates/context/main-nav.njk

@@ -1,41 +0,0 @@
-{% set mainNavigation = [
-    {
-        "href": "/",
-        "label": "Home",
-        "openInNewWindow": false
-    },
-    {
-        "href": "/jobs",
-        "label": "Find a job",
-        "openInNewWindow": false
-    },
-    {
-        "href": "/newalert",
-        "label": "Job alerts",
-        "openInNewWindow": false
-    },
-    {
-        "href": "/employers",
-        "label": "Search recruiters",
-        "openInNewWindow": false
-    },
-    {
-        "href": "/careers",
-        "label": "Career advice",
-        "openInNewWindow": false
-    },
-    {
-        "href": "/careerfairs",
-        "label": "Career fairs",
-        "openInNewWindow": false
-    },    {
-        "href": "/cp/role-explorer",
-        "label": "Role Insights",
-        "openInNewWindow": false
-    },
-    {
-        "href": "/forum",
-        "label": "Forum",
-        "openInNewWindow": false
-    }
-] %}

package/repo-template/services/jobseekers-frontend/templates/context/user-nav.njk

@@ -1,17 +0,0 @@
-{% set userNavigation = [
-    {
-        "href": "/your-jobs",
-        "label": "Your jobs",
-        "openInNewWindow": false
-    },
-    {
-        "href": "/profile",
-        "label": "Your profile",
-        "openInNewWindow": false
-    },
-    {
-        "href": "/account",
-        "label": "Your account",
-        "openInNewWindow": false
-    }
-] %}