@digitaldefiance/express-suite-starter 2.3.4 → 2.3.6

package/scaffolding/inituserdb/src/main.ts.mustache

@@ -0,0 +1,178 @@
+import {
+  BaseApplication,
+  DatabaseInitializationService,
+  Environment,
+  IServerInitResult,
+  getSchemaMap,
+} from '@digitaldefiance/node-express-suite';
+
+// Simple debugLog implementation
+function debugLog(debug: boolean, type: 'log' | 'warn' | 'error', ...args: any[]): void {
+  if (debug) {
+    console[type](...args);
+  }
+}
+import { Constants as AppConstants } from '{{namespace}}/api-lib';
+import { GlobalActiveContext, IActiveContext } from '@digitaldefiance/i18n-lib';
+import { IECIESConfig } from '@digitaldefiance/ecies-lib';
+import { ECIESService } from '@digitaldefiance/node-ecies-lib';
+import {
+  CoreLanguageCode,
+} from '@digitaldefiance/i18n-lib';
+import { getSuiteCoreI18nEngine, getSuiteCoreTranslation, IFailableResult, SuiteCoreStringKey } from '@digitaldefiance/suite-core-lib';
+import { randomBytes } from 'crypto';
+import { join } from 'path';
+
+async function main() {
+  const context = GlobalActiveContext.getInstance<CoreLanguageCode, IActiveContext<CoreLanguageCode>>();
+  context.languageContextSpace = 'admin';
+
+  const config: IECIESConfig = {
+    curveName: AppConstants.ECIES.CURVE_NAME,
+    primaryKeyDerivationPath: AppConstants.ECIES.PRIMARY_KEY_DERIVATION_PATH,
+    mnemonicStrength: AppConstants.ECIES.MNEMONIC_STRENGTH,
+    symmetricAlgorithm: AppConstants.ECIES.SYMMETRIC_ALGORITHM_CONFIGURATION,
+    symmetricKeyBits: AppConstants.ECIES.SYMMETRIC.KEY_BITS,
+    symmetricKeyMode: AppConstants.ECIES.SYMMETRIC.MODE,
+  };
+  const eciesService = new ECIESService(config);
+  if (process.argv.includes('--gen-system-user-mnemonic')) {
+    const mnemonic = eciesService.generateNewMnemonic();
+    process.env.ADMIN_MNEMONIC = mnemonic.value;
+    console.log(
+      `ADMIN_MNEMONIC="${mnemonic.value}"\n`,
+      getSuiteCoreTranslation(
+        SuiteCoreStringKey.Admin_MakeSureToSetItInEnv,
+      ),
+    );
+  }
+  if (process.argv.includes('--gen-member-user-mnemonic')) {
+    const mnemonic = eciesService.generateNewMnemonic();
+    process.env.MEMBER_MNEMONIC = mnemonic.value;
+    console.log(
+      `MEMBER_MNEMONIC="${mnemonic.value}"\n`,
+      getSuiteCoreTranslation(
+        SuiteCoreStringKey.Admin_MakeSureToSetItInEnv,
+      ),
+    );
+  }
+  if (process.argv.includes('--gen-mnemonic-hmac-secret')) {
+    const mnemonicHmacSecret = randomBytes(32).toString('hex');
+    process.env.MNEMONIC_HMAC_SECRET = mnemonicHmacSecret;
+    console.log(
+      `MNEMONIC_HMAC_SECRET="${mnemonicHmacSecret}"\n`,
+      getSuiteCoreTranslation(
+        SuiteCoreStringKey.Admin_MakeSureToSetItInEnv,
+      ),
+    );
+  }
+  if (process.argv.includes('--gen-mnemonic-encryption-key')) {
+    const mnemonicEncryptionKey = randomBytes(32).toString('hex');
+    process.env.MNEMONIC_ENCRYPTION_KEY = mnemonicEncryptionKey;
+    console.log(
+      `MNEMONIC_ENCRYPTION_KEY="${mnemonicEncryptionKey}"\n`,
+      getSuiteCoreTranslation(
+        SuiteCoreStringKey.Admin_MakeSureToSetItInEnv,
+      ),
+    );
+  }
+
+  const envDir = join(
+    BaseApplication.distDir,
+    '{{prefix}}-inituserdb',
+    '.env',
+  );
+  const env: Environment = new Environment(envDir, true);
+  const app = new BaseApplication(env, getSchemaMap, DatabaseInitializationService.initUserDb, DatabaseInitializationService.serverInitResultHash, AppConstants);
+  context.languageContextSpace = 'admin';
+  const shouldDropDatabase = process.argv.includes('--drop');
+  debugLog(
+    app.environment.detailedDebug,
+    'log',
+    getSuiteCoreTranslation(SuiteCoreStringKey.Admin_TransactionsEnabledDisabledTemplate, {
+      STATE: getSuiteCoreTranslation(
+        app.environment.mongo.useTransactions
+          ? SuiteCoreStringKey.Common_Enabled
+          : SuiteCoreStringKey.Common_Disabled,
+      ),
+    }),
+  );
+  let exitCode = 1;
+  await app.start();
+  if (shouldDropDatabase) {
+    const result = await DatabaseInitializationService.dropDatabase(
+      app.db.connection,
+    );
+    if (result) {
+      debugLog(
+        app.environment.detailedDebug,
+        'log',
+        getSuiteCoreTranslation(SuiteCoreStringKey.Admin_DatabaseDropped),
+      );
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+      debugLog(
+        app.environment.detailedDebug,
+        'log',
+        getSuiteCoreTranslation(SuiteCoreStringKey.Admin_ProceedingToDbInitialization),
+      );
+    } else {
+      debugLog(
+        app.environment.detailedDebug,
+        'error',
+        getSuiteCoreTranslation(SuiteCoreStringKey.Admin_Error_FailedToDropDatabase),
+      );
+      await app.stop();
+      process.exit(2);
+    }
+  }
+  debugLog(
+    app.environment.detailedDebug,
+    'log',
+    getSuiteCoreTranslation(SuiteCoreStringKey.Admin_StartingDbInitialization),
+  );
+  const result: IFailableResult<IServerInitResult> =
+    await DatabaseInitializationService.initUserDb(app);
+  if (result.success && result.data) {
+    debugLog(
+      app.environment.debug,
+      'log',
+      getSuiteCoreTranslation(
+        SuiteCoreStringKey.Admin_UserDatabaseInitialized,
+      ),
+    );
+    if (app.environment.detailedDebug) {
+      DatabaseInitializationService.printServerInitResults(result.data);
+      // DatabaseInitializationService.setEnvFromInitResults(result.data);
+      // app.reloadEnvironment(envDir, true);
+      const initHash = DatabaseInitializationService.serverInitResultHash(
+        result.data,
+      );
+      debugLog(
+        true,
+        'log',
+        `Database initialized with options hash: ${initHash}`,
+      );
+    }
+    exitCode = 0;
+  } else {
+    const engine = getSuiteCoreI18nEngine();
+    console.error(
+      engine.t(
+        '{{SuiteCoreStringKey.Admin_Error_FailedToInitializeUserDatabase}}:',
+      ),
+      result.error,
+    );
+    exitCode++;
+  }
+  await app.stop();
+  process.exit(exitCode);
+}
+
+main().catch((err) => {
+  const engine = getSuiteCoreI18nEngine();
+  console.error(
+    engine.t('{{SuiteCoreStringKey.Admin_Error_UnhandledErrorInMain}}:'),
+    err,
+  );
+  process.exit(1);
+});

package/scaffolding/lib/src/index.ts.mustache

@@ -0,0 +1,6 @@
+export * from './lib/constants';
+export * from './lib/i18n-setup';
+export * from './lib/enumerations/{{workspaceName}}-string-key';
+export * from './lib/interfaces/constants';
+export * from './lib/strings-collection';
+export * from './lib/ecies-config';

package/scaffolding/lib/src/lib/constants.ts.mustache

@@ -0,0 +1,15 @@
+import { IConstants } from './interfaces/constants';
+import { Constants } from '@digitaldefiance/suite-core-lib';
+
+export const AppConstants: IConstants = {
+  ...Constants,
+  Site: '{{siteTitle}}' as const,
+  SiteTagline: '{{siteTagline}}' as const,
+  SiteDescription: '{{siteDescription}}' as const,
+  SiteHostname: '{{hostname}}' as const, 
+  PasswordRegex: /^(?=.*[A-Za-z])(?=.*\d)(?=.*[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?])[A-Za-z\d!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]{8,}$/,
+  UsernameMinLength: 3 as const,
+  UsernameMaxLength: 30 as const,
+  UsernameRegex: /^[A-Za-z0-9]{3,30}$/,
+  PasswordMinLength: 8 as const,
+};

package/scaffolding/lib/src/lib/ecies-config.ts

@@ -0,0 +1,10 @@
+import { IECIESConfig, ECIES } from '@digitaldefiance/ecies-lib';
+
+export const EciesConfig: IECIESConfig = {
+  curveName: ECIES.CURVE_NAME,
+  primaryKeyDerivationPath: ECIES.PRIMARY_KEY_DERIVATION_PATH,
+  mnemonicStrength: ECIES.MNEMONIC_STRENGTH,
+  symmetricAlgorithm: ECIES.SYMMETRIC_ALGORITHM_CONFIGURATION,
+  symmetricKeyBits: ECIES.SYMMETRIC.KEY_BITS,
+  symmetricKeyMode: ECIES.SYMMETRIC.MODE,
+};

package/scaffolding/lib/src/lib/enumerations/{{workspaceName}}-string-key.ts.mustache

@@ -0,0 +1,5 @@
+export enum {{WorkspaceName}}StringKey {
+  SiteTitle = 'siteTitle',
+  SiteDescription = 'siteDescription',
+  SiteTagline = 'siteTagline',
+}

package/scaffolding/lib/src/lib/i18n-setup.ts.mustache

@@ -0,0 +1,99 @@
+import {
+  CoreLanguageCode,
+  LanguageCodes,
+  GlobalActiveContext,
+  IActiveContext,
+  LanguageContextSpace,
+  getCoreLanguageDefinitions,
+  I18nBuilder,
+  I18nEngine,
+} from '@digitaldefiance/i18n-lib';
+import { AppConstants } from './constants';
+import { {{WorkspaceName}}StringKey } from './enumerations/{{workspaceName}}-string-key';
+import { Strings } from './strings-collection';
+import { createSuiteCoreComponentConfig } from '@digitaldefiance/suite-core-lib';
+
+export const ComponentId = '{{WorkspaceName}}';
+
+const componentStrings = {
+  [LanguageCodes.EN_US]: Strings[LanguageCodes.EN_US],
+  [LanguageCodes.EN_GB]: Strings[LanguageCodes.EN_GB],
+  [LanguageCodes.FR]: Strings[LanguageCodes.FR],
+  [LanguageCodes.ES]: Strings[LanguageCodes.ES],
+  [LanguageCodes.DE]: Strings[LanguageCodes.DE],
+  [LanguageCodes.ZH_CN]: Strings[LanguageCodes.ZH_CN],
+  [LanguageCodes.JA]: Strings[LanguageCodes.JA],
+  [LanguageCodes.UK]: Strings[LanguageCodes.UK],
+};
+
+let i18nEngine: I18nEngine;
+if (I18nEngine.hasInstance('default')) {
+  i18nEngine = I18nEngine.getInstance('default');
+  i18nEngine.mergeConstants(AppConstants);
+} else {
+  i18nEngine = I18nBuilder.create()
+    .withLanguages(getCoreLanguageDefinitions())
+    .withDefaultLanguage(LanguageCodes.EN_US)
+    .withFallbackLanguage(LanguageCodes.EN_US)
+    .withValidation({
+      requireCompleteStrings: false,
+      allowPartialRegistration: true,
+    })
+    .withConstants(AppConstants)
+    .withInstanceKey('default')
+    .build();
+
+  i18nEngine.register(createSuiteCoreComponentConfig());
+}
+
+export { i18nEngine };
+
+const registrationResult = i18nEngine.registerIfNotExists({
+  id: ComponentId,
+  strings: componentStrings,
+  aliases: ['{{WorkspaceName}}StringKey'],
+});
+
+if (!registrationResult.isValid) {
+  console.warn('Component has missing translations:', registrationResult.errors);
+}
+
+const globalContext = GlobalActiveContext.getInstance<CoreLanguageCode, IActiveContext<CoreLanguageCode>>();
+globalContext.createContext(LanguageCodes.EN_US, LanguageCodes.EN_US, ComponentId);
+
+export const i18nContext: IActiveContext<CoreLanguageCode> = {
+  get language() {
+    return globalContext.getContext(ComponentId).language;
+  },
+  get adminLanguage() {
+    return globalContext.getContext(ComponentId).adminLanguage;
+  },
+  get currentContext() {
+    return globalContext.getContext(ComponentId).currentContext;
+  },
+  get currencyCode() {
+    return globalContext.getContext(ComponentId).currencyCode;
+  },
+  get timezone() {
+    return globalContext.getContext(ComponentId).timezone;
+  },
+  get adminTimezone() {
+    return globalContext.getContext(ComponentId).adminTimezone;
+  },
+};
+
+export const translate = (
+  name: {{WorkspaceName}}StringKey,
+  variables?: Record<string, string | number>,
+  language?: CoreLanguageCode,
+  context?: LanguageContextSpace,
+): string => {
+  const activeContext = context ?? globalContext.getContext(ComponentId).currentContext;
+  const lang =
+    language ??
+    (activeContext === 'admin'
+      ? globalContext.getContext(ComponentId).adminLanguage
+      : globalContext.getContext(ComponentId).language);
+
+  return i18nEngine.translate(ComponentId, name, variables, lang);
+};

package/scaffolding/lib/src/lib/interfaces/constants.ts

@@ -0,0 +1,13 @@
+import { IConstants as ISuiteCoreConstants } from '@digitaldefiance/suite-core-lib';
+
+export interface IConstants extends ISuiteCoreConstants {
+  readonly Site: string;
+  readonly SiteTagline: string;
+  readonly SiteDescription: string;
+  readonly SiteHostname: string;
+  readonly PasswordRegex: RegExp;
+  readonly UsernameMinLength: number;
+  readonly UsernameMaxLength: number;
+  readonly UsernameRegex: RegExp;
+  readonly PasswordMinLength: number;
+}

package/scaffolding/lib/src/lib/strings-collection.ts.mustache

@@ -0,0 +1,45 @@
+import { LanguageCodes } from '@digitaldefiance/i18n-lib';
+import { {{WorkspaceName}}StringKey } from './enumerations/{{workspaceName}}-string-key';
+
+export const Strings = {
+  [LanguageCodes.EN_US]: {
+    [{{WorkspaceName}}StringKey.SiteTitle]: '{{#isEnUs}}{{siteTitle}}{{/isEnUs}}{{^isEnUs}}Your Site Title{{/isEnUs}}',
+    [{{WorkspaceName}}StringKey.SiteDescription]: '{{#isEnUs}}{{siteDescription}}{{/isEnUs}}{{^isEnUs}}Your description here{{/isEnUs}}',
+    [{{WorkspaceName}}StringKey.SiteTagline]: '{{#isEnUs}}{{siteTagline}}{{/isEnUs}}{{^isEnUs}}Your tagline here{{/isEnUs}}',
+  },
+  [LanguageCodes.EN_GB]: {
+    [{{WorkspaceName}}StringKey.SiteTitle]: '{{#isEnGb}}{{siteTitle}}{{/isEnGb}}{{^isEnGb}}Your Site Title{{/isEnGb}}',
+    [{{WorkspaceName}}StringKey.SiteDescription]: '{{#isEnGb}}{{siteDescription}}{{/isEnGb}}{{^isEnGb}}Your description here{{/isEnGb}}',
+    [{{WorkspaceName}}StringKey.SiteTagline]: '{{#isEnGb}}{{siteTagline}}{{/isEnGb}}{{^isEnGb}}Your tagline here{{/isEnGb}}',
+  },
+  [LanguageCodes.FR]: {
+    [{{WorkspaceName}}StringKey.SiteTitle]: '{{#isFr}}{{siteTitle}}{{/isFr}}{{^isFr}}Titre de votre site{{/isFr}}',
+    [{{WorkspaceName}}StringKey.SiteDescription]: '{{#isFr}}{{siteDescription}}{{/isFr}}{{^isFr}}Votre description ici{{/isFr}}',
+    [{{WorkspaceName}}StringKey.SiteTagline]: '{{#isFr}}{{siteTagline}}{{/isFr}}{{^isFr}}Votre slogan ici{{/isFr}}',
+  },
+  [LanguageCodes.ES]: {
+    [{{WorkspaceName}}StringKey.SiteTitle]: '{{#isEs}}{{siteTitle}}{{/isEs}}{{^isEs}}Título de su sitio{{/isEs}}',
+    [{{WorkspaceName}}StringKey.SiteDescription]: '{{#isEs}}{{siteDescription}}{{/isEs}}{{^isEs}}Su descripción aquí{{/isEs}}',
+    [{{WorkspaceName}}StringKey.SiteTagline]: '{{#isEs}}{{siteTagline}}{{/isEs}}{{^isEs}}Su eslogan aquí{{/isEs}}',
+  },
+  [LanguageCodes.DE]: {
+    [{{WorkspaceName}}StringKey.SiteTitle]: '{{#isDe}}{{siteTitle}}{{/isDe}}{{^isDe}}Ihr Seitentitel{{/isDe}}',
+    [{{WorkspaceName}}StringKey.SiteDescription]: '{{#isDe}}{{siteDescription}}{{/isDe}}{{^isDe}}Ihre Beschreibung hier{{/isDe}}',
+    [{{WorkspaceName}}StringKey.SiteTagline]: '{{#isDe}}{{siteTagline}}{{/isDe}}{{^isDe}}Ihr Slogan hier{{/isDe}}',
+  },
+  [LanguageCodes.ZH_CN]: {
+    [{{WorkspaceName}}StringKey.SiteTitle]: '{{#isZhCn}}{{siteTitle}}{{/isZhCn}}{{^isZhCn}}您的网站标题{{/isZhCn}}',
+    [{{WorkspaceName}}StringKey.SiteDescription]: '{{#isZhCn}}{{siteDescription}}{{/isZhCn}}{{^isZhCn}}您的描述在这里{{/isZhCn}}',
+    [{{WorkspaceName}}StringKey.SiteTagline]: '{{#isZhCn}}{{siteTagline}}{{/isZhCn}}{{^isZhCn}}您的标语在这里{{/isZhCn}}',
+  },
+  [LanguageCodes.JA]: {
+    [{{WorkspaceName}}StringKey.SiteTitle]: '{{#isJa}}{{siteTitle}}{{/isJa}}{{^isJa}}サイトのタイトル{{/isJa}}',
+    [{{WorkspaceName}}StringKey.SiteDescription]: '{{#isJa}}{{siteDescription}}{{/isJa}}{{^isJa}}ここに説明を入力{{/isJa}}',
+    [{{WorkspaceName}}StringKey.SiteTagline]: '{{#isJa}}{{siteTagline}}{{/isJa}}{{^isJa}}ここにキャッチフレーズを入力{{/isJa}}',
+  },
+  [LanguageCodes.UK]: {
+    [{{WorkspaceName}}StringKey.SiteTitle]: '{{#isUk}}{{siteTitle}}{{/isUk}}{{^isUk}}Назва вашого сайту{{/isUk}}',
+    [{{WorkspaceName}}StringKey.SiteDescription]: '{{#isUk}}{{siteDescription}}{{/isUk}}{{^isUk}}Ваш опис тут{{/isUk}}',
+    [{{WorkspaceName}}StringKey.SiteTagline]: '{{#isUk}}{{siteTagline}}{{/isUk}}{{^isUk}}Ваш слоган тут{{/isUk}}',
+  },
+};

package/scaffolding/react/src/app/app.tsx.mustache

@@ -0,0 +1,170 @@
+import { Box, CssBaseline } from '@mui/material';
+import { LocalizationProvider } from '@mui/x-date-pickers';
+import { AdapterDateFns } from '@mui/x-date-pickers/AdapterDateFns';
+import { FC, useCallback } from 'react';
+import { Route, Routes, useNavigate } from 'react-router-dom';
+import '../styles.scss';
+import SplashPage from './pages/SplashPage';
+import { createAppTheme } from './theme.tsx';
+import { AppThemeProvider, DashboardPage, MenuProvider, I18nProvider as TranslationProvider, AuthProvider, SuiteConfigProvider, ApiAccess, ChangePasswordFormWrapper, VerifyEmailPageWrapper, RegisterFormWrapper, UserSettingsFormWrapper, LogoutPageWrapper, LoginFormWrapper, PrivateRoute, UnAuthRoute, TopMenu, TranslatedTitle, BackupCodeLoginWrapper, BackupCodesWrapper } from '@digitaldefiance/express-suite-react-components';
+import { environment } from '../environments/environment';
+import { {{WorkspaceName}}StringKey, ComponentId, i18nEngine } from '{{namespace}}/lib';
+import AlbatrossLogo from '../assets/albatross.svg';
+import { AppConstants, EciesConfig } from '{{namespace}}/lib';
+import { appMenuConfigs } from './menus';
+import { LanguageRegistry } from '@digitaldefiance/i18n-lib';
+import { SuiteCoreComponentId, SuiteCoreStringKey } from '@digitaldefiance/suite-core-lib';
+
+const getApiBaseUrl = () => {
+  if (
+    typeof window !== 'undefined' &&
+    (window as any).APP_CONFIG &&
+    (window as any).APP_CONFIG.apiUrl
+  ) {
+    return (window as any).APP_CONFIG.apiUrl;
+  }
+  return environment.apiUrl;
+};
+
+const API_BASE_URL = getApiBaseUrl();
+
+const AuthProviderWithNavigation: FC<{ children: React.ReactNode }> = ({
+  children,
+}) => {
+  const navigate = useNavigate();
+
+  const handleLogout = useCallback(() => {
+    navigate('/');
+  }, [navigate]);
+
+  return (
+    <SuiteConfigProvider
+      baseUrl={API_BASE_URL}
+      routes={ {
+        dashboard: '/dashboard',
+        login: '/login',
+        register: '/register',
+        verifyEmail: '/verify-email',
+        settings: '/user-settings',
+      } }
+      languages={LanguageRegistry.getCodeLabelMap()}
+    >
+      <AuthProvider
+        baseUrl={API_BASE_URL}
+        constants={AppConstants}
+        eciesConfig={EciesConfig}
+        onLogout={handleLogout}
+      >
+        {children}
+      </AuthProvider>
+    </SuiteConfigProvider>
+  );
+};
+
+const App: FC = () => {
+  return (
+    <LocalizationProvider dateAdapter={AdapterDateFns}>
+      <TranslationProvider i18nEngine={i18nEngine}>
+        <TranslatedTitle<SuiteCoreStringKey>
+          componentId={SuiteCoreComponentId}
+          stringKey={SuiteCoreStringKey.Common_SiteTemplate} />
+        <AppThemeProvider customTheme={createAppTheme}>
+          <CssBaseline />
+          <AuthProviderWithNavigation>
+            <InnerApp />
+          </AuthProviderWithNavigation>
+        </AppThemeProvider>
+      </TranslationProvider>
+    </LocalizationProvider>
+  );
+};
+
+const LogoComponent = () => <img src={AlbatrossLogo} alt="Logo" />;
+
+const InnerApp: FC = () => {
+  return (
+    <MenuProvider menuConfigs={appMenuConfigs}>
+      <Box className="app-container" sx={ { paddingTop: '64px' } }>
+        <TopMenu Logo={<LogoComponent />} />
+        <Routes>
+          <Route path="/" element={<SplashPage />} />
+          <Route
+            path="/api-access"
+            element={
+              <PrivateRoute>
+                <ApiAccess />
+              </PrivateRoute>
+            }
+          />
+          <Route path="/backup-code" element={<BackupCodeLoginWrapper />} />
+          <Route
+            path="/backup-codes"
+            element={
+              <PrivateRoute>
+                <BackupCodesWrapper />
+              </PrivateRoute>
+            }
+          />
+          <Route
+            path="/login"
+            element={
+              <UnAuthRoute>
+                <LoginFormWrapper />
+              </UnAuthRoute>
+            }
+          />
+          <Route
+            path="/logout"
+            element={
+              <PrivateRoute>
+                <LogoutPageWrapper />
+              </PrivateRoute>
+            }
+          />
+          <Route
+            path="/register"
+            element={
+              <UnAuthRoute>
+                <RegisterFormWrapper />
+              </UnAuthRoute>
+            }
+          />
+          <Route
+            path="/dashboard"
+            element={
+              <PrivateRoute>
+                <DashboardPage />
+              </PrivateRoute>
+            }
+          />
+          <Route
+            path="/change-password"
+            element={
+              <PrivateRoute>
+                <ChangePasswordFormWrapper />
+              </PrivateRoute>
+            }
+          />
+          <Route
+            path="/verify-email"
+            element={
+              <UnAuthRoute>
+                <VerifyEmailPageWrapper />
+              </UnAuthRoute>
+            }
+          />
+          <Route
+            path="/user-settings"
+            element={
+              <PrivateRoute>
+                <UserSettingsFormWrapper />
+              </PrivateRoute>
+            }
+          />
+        </Routes>
+      </Box>
+    </MenuProvider>
+  );
+};
+
+export default App;

package/scaffolding/react/src/app/menus/extraMenu.tsx

@@ -0,0 +1,20 @@
+import { createMenuType, IMenuConfig } from '@digitaldefiance/express-suite-react-components';
+import { Dashboard } from '@mui/icons-material';
+
+const ExtraMenu = createMenuType('ExtraMenu');
+
+export const extraMenuConfig: IMenuConfig = {
+  menuType: ExtraMenu,
+  menuIcon: <Dashboard />,
+  priority: 1,
+  options: [
+    {
+      id: 'extra-option-1',
+      label: 'Extra Option 1',
+      link: '/extra-1',
+      requiresAuth: true,
+      includeOnMenus: [ExtraMenu],
+      index: 0,
+    },
+  ],
+};

package/scaffolding/react/src/app/menus/index.ts

@@ -0,0 +1,5 @@
+import { extraMenuConfig } from './extraMenu';
+
+export { extraMenuConfig } from './extraMenu';
+
+export const appMenuConfigs = [extraMenuConfig];

package/scaffolding/react/src/app/pages/SplashPage.tsx

@@ -0,0 +1,60 @@
+import { Box, Button, Container, Typography } from '@mui/material';
+import { useNavigate } from 'react-router-dom';
+import { useAuth } from '@digitaldefiance/express-suite-react-components';
+
+const SplashPage = () => {
+  const navigate = useNavigate();
+  const { isAuthenticated } = useAuth();
+
+  return (
+    <Container maxWidth="md">
+      <Box
+        sx={{
+          display: 'flex',
+          flexDirection: 'column',
+          alignItems: 'center',
+          justifyContent: 'center',
+          minHeight: '80vh',
+          textAlign: 'center',
+        }}
+      >
+        <Typography variant="h2" component="h1" gutterBottom>
+          Welcome to @WORKSPACENAME@
+        </Typography>
+        <Typography variant="h5" color="text.secondary" paragraph>
+          A modern MERN stack application built with Express Suite
+        </Typography>
+        <Box sx={{ mt: 4, display: 'flex', gap: 2 }}>
+          {isAuthenticated ? (
+            <Button
+              variant="contained"
+              size="large"
+              onClick={() => navigate('/dashboard')}
+            >
+              Go to Dashboard
+            </Button>
+          ) : (
+            <>
+              <Button
+                variant="contained"
+                size="large"
+                onClick={() => navigate('/login')}
+              >
+                Login
+              </Button>
+              <Button
+                variant="outlined"
+                size="large"
+                onClick={() => navigate('/register')}
+              >
+                Register
+              </Button>
+            </>
+          )}
+        </Box>
+      </Box>
+    </Container>
+  );
+};
+
+export default SplashPage;