Reference mobile App for TOTP & Push-Based Authentication

pnpm-workspace.yaml

@@ -6,6 +6,7 @@ packages:
   - 'samples/*'
   - '!samples/__legacy__/*'
   - '!samples/teamspace-nextjs'
+  - '!samples/authenticator-app'
 
 catalog:
   '@wso2/eslint-plugin': 'https://gitpkg.now.sh/brionmario/wso2-ui-configs/packages/eslint-plugin?a1fc6eb570653c999828aea9f5027cba06af4391'

samples/authenticator-app/.github/copilto-instructions.md

@@ -0,0 +1,5 @@
+# Copilot Instructions
+- Do not generate demo/example files.
+- Do not create README.md files or any instruction files.
+- Only suggest code fit to existing modules.
+- Follow existing coding style and structure.

samples/authenticator-app/.gitignore

@@ -0,0 +1,42 @@
+# Learn more https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files
+
+# dependencies
+node_modules/
+
+# Expo
+.expo/
+dist/
+web-build/
+expo-env.d.ts
+
+# Native
+.kotlin/
+*.orig.*
+*.jks
+*.p8
+*.p12
+*.key
+*.mobileprovision
+
+# Metro
+.metro-health-check*
+
+# debug
+npm-debug.*
+yarn-debug.*
+yarn-error.*
+
+# macOS
+.DS_Store
+*.pem
+
+# local env files
+.env*.local
+
+# typescript
+*.tsbuildinfo
+
+app-example
+
+android
+ios

samples/authenticator-app/.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+  "editor.codeActionsOnSave": {
+    "source.fixAll": "explicit",
+    "source.organizeImports": "explicit",
+    "source.sortMembers": "explicit"
+  }
+}

samples/authenticator-app/README.md

@@ -0,0 +1,50 @@
+# Welcome to your Expo app 👋
+
+This is an [Expo](https://expo.dev) project created with [`create-expo-app`](https://www.npmjs.com/package/create-expo-app).
+
+## Get started
+
+1. Install dependencies
+
+   ```bash
+   npm install
+   ```
+
+2. Start the app
+
+   ```bash
+   npx expo start
+   ```
+
+In the output, you'll find options to open the app in a
+
+- [development build](https://docs.expo.dev/develop/development-builds/introduction/)
+- [Android emulator](https://docs.expo.dev/workflow/android-studio-emulator/)
+- [iOS simulator](https://docs.expo.dev/workflow/ios-simulator/)
+- [Expo Go](https://expo.dev/go), a limited sandbox for trying out app development with Expo
+
+You can start developing by editing the files inside the **app** directory. This project uses [file-based routing](https://docs.expo.dev/router/introduction).
+
+## Get a fresh project
+
+When you're ready, run:
+
+```bash
+npm run reset-project
+```
+
+This command will move the starter code to the **app-example** directory and create a blank **app** directory where you can start developing.
+
+## Learn more
+
+To learn more about developing your project with Expo, look at the following resources:
+
+- [Expo documentation](https://docs.expo.dev/): Learn fundamentals, or go into advanced topics with our [guides](https://docs.expo.dev/guides).
+- [Learn Expo tutorial](https://docs.expo.dev/tutorial/introduction/): Follow a step-by-step tutorial where you'll create a project that runs on Android, iOS, and the web.
+
+## Join the community
+
+Join our community of developers creating universal apps.
+
+- [Expo on GitHub](https://github.com/expo/expo): View our open source platform and contribute.
+- [Discord community](https://chat.expo.dev): Chat with Expo users and ask questions.

samples/authenticator-app/app.json

@@ -0,0 +1,91 @@
+{
+  "expo": {
+    "name": "Asgardeo",
+    "slug": "Asgardeo",
+    "version": "1.0.0",
+    "orientation": "portrait",
+    "icon": "./assets/images/logo-icon.png",
+    "scheme": "authenticatorapp",
+    "userInterfaceStyle": "automatic",
+    "newArchEnabled": true,
+    "ios": {
+      "config": {
+        "usesNonExemptEncryption": false
+      },
+      "supportsTablet": true,
+      "infoPlist": {
+        "NSCameraUsageDescription": "This app needs access to the camera to scan QR codes.",
+        "UIBackgroundModes": [
+          "remote-notification"
+        ]
+      },
+      "bundleIdentifier": "io.asgardeo.dev.push.totp.authenticator",
+      "googleServicesFile": "./config/GoogleService-Info.plist",
+      "entitlements": {
+        "aps-environment": "production"
+      }
+    },
+    "android": {
+      "adaptiveIcon": {
+        "foregroundImage": "./assets/images/logo-icon.png",
+        "backgroundColor": "#ffffff"
+      },
+      "edgeToEdgeEnabled": true,
+      "package": "io.asgardeo.dev.push.totp.authenticator",
+      "permissions": [
+        "CAMERA",
+        "android.permission.CAMERA",
+        "android.permission.RECORD_AUDIO"
+      ],
+      "googleServicesFile": "./config/google-services.json"
+    },
+    "web": {
+      "bundler": "metro",
+      "output": "static",
+      "favicon": "./assets/images/logo-icon.png"
+    },
+    "plugins": [
+      "expo-router",
+      "@react-native-firebase/app",
+      "@react-native-firebase/messaging",
+      [
+        "expo-camera",
+        {
+          "cameraPermission": "Allow this app to access your camera to scan QR codes."
+        }
+      ],
+      [
+        "expo-splash-screen",
+        {
+          "image": "./assets/images/logo-icon.png",
+          "imageWidth": 200,
+          "resizeMode": "contain",
+          "backgroundColor": "#ffffff"
+        }
+      ],
+      [
+        "expo-secure-store",
+        {
+          "configureAndroidBackup": true
+        }
+      ],
+      [
+        "expo-build-properties",
+        {
+          "ios": {
+            "useFrameworks": "static"
+          }
+        }
+      ],
+      [
+        "expo-local-authentication",
+        {
+          "faceIDPermission": "Allow $(PRODUCT_NAME) to use Face ID."
+        }
+      ]
+    ],
+    "experiments": {
+      "typedRoutes": true
+    }
+  }
+}

samples/authenticator-app/app/_layout.tsx

@@ -0,0 +1,98 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you 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.
+ */
+
+import AccountHeaderRight from "../src/components/account/account-header-right";
+import { Stack } from "expo-router";
+import { ReactElement, useEffect, useState } from "react";
+import HeaderTitle from "../src/components/common/header-title";
+import ThemeProvider from "../src/contexts/theme/ThemeProvider";
+import { ThemeConfigs } from "../src/models/ui";
+import { getThemeConfigs } from "../src/utils/ui-utils";
+import AsgardeoProvider from "../src/contexts/asgardeo/asgardeo-provider";
+import AppPaths from "../src/constants/paths";
+
+const theme: ThemeConfigs = getThemeConfigs();
+
+/**
+ * Root Layout component.
+ *
+ * @returns Root Layout component.
+ */
+const RootLayout = (): ReactElement => {
+  const [mounted, setMounted] = useState(false);
+
+  /**
+   * Sets the mounted state to true when the component is mounted.
+   */
+  useEffect(() => {
+    setMounted(true);
+  }, []);
+
+  return (
+    <AsgardeoProvider isAppInitialized={mounted}>
+      <ThemeProvider>
+        <Stack>
+          <Stack.Screen
+            name={AppPaths.ROOT}
+            options={{
+              headerShown: false
+            }}
+          />
+          <Stack.Screen
+            name={AppPaths.HOME}
+            options={{
+              headerStyle: { backgroundColor: theme.colors.header.background },
+              headerTitle: HeaderTitle
+            }}
+          />
+          <Stack.Screen
+            name={AppPaths.QR_SCANNER}
+            options={{
+              headerShown: false,
+              presentation: "modal"
+            }}
+          />
+          <Stack.Screen
+            name={AppPaths.PUSH_AUTH}
+            options={{
+              headerShown: false
+            }}
+          />
+          <Stack.Screen
+            name={AppPaths.ACCOUNT}
+            options={({ route }) => ({
+              headerStyle: { backgroundColor: theme.colors.header.background },
+              headerTitle: HeaderTitle,
+              headerRight: (): ReactElement => <AccountHeaderRight params={route.params as Record<string, string>} />
+            })}
+          />
+          <Stack.Screen
+            name={AppPaths.PUSH_AUTH_HISTORY}
+            options={({ route }) => ({
+              headerStyle: { backgroundColor: theme.colors.header.background },
+              headerTitle: HeaderTitle,
+              headerRight: (): ReactElement => <AccountHeaderRight params={route.params as Record<string, string>} />
+            })}
+          />
+        </Stack>
+      </ThemeProvider>
+    </AsgardeoProvider>
+  );
+}
+
+export default RootLayout;

samples/authenticator-app/app/account.tsx

@@ -0,0 +1,36 @@
+/**
+ * Copyright (c) 2025, WSO2 LLC. (https://www.wso2.com).
+ *
+ * WSO2 LLC. licenses this file to you 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.
+ */
+
+import { useLocalSearchParams } from "expo-router";
+import { FunctionComponent, ReactElement } from "react";
+import TOTPCode from "../src/components/account/totp";
+
+/**
+ * Account Screen component.
+ *
+ * @returns Account screen component.
+ */
+const AccountScreen: FunctionComponent = (): ReactElement | null => {
+  const { id } = useLocalSearchParams<{ id: string }>();
+
+  return (
+    <TOTPCode id={id} />
+  );
+}
+
+export default AccountScreen;