fix(nextjs): resolve Webpack "module not found" errors (#212)

examples/nextjs/next.config.mjs

@@ -1,8 +1,30 @@
 /** @type {import('next').NextConfig} */
 const nextConfig = {
-  /** @see https://github.com/WalletConnect/walletconnect-monorepo/issues/1908#issuecomment-1487801131 */
-  webpack: (config) => {
+  webpack: (config, { isServer }) => {
+    /** @see https://github.com/WalletConnect/walletconnect-monorepo/issues/1908#issuecomment-1487801131 */
     config.externals.push('pino-pretty', 'lokijs', 'encoding')
+
+    /**
+     * Provide fallbacks for optional wallet dependencies.
+     * This allows the app to build and run without these packages installed,
+     * enabling users to include only the wallet packages they need.
+     * Each package is set to 'false', which means Webpack will provide an empty module
+     * if the package is not found, preventing build errors for unused wallets.
+     */
+    if (!isServer) {
+      config.resolve.fallback = {
+        ...config.resolve.fallback,
+        '@agoralabs-sh/avm-web-provider': false,
+        '@blockshake/defly-connect': false,
+        '@magic-ext/algorand': false,
+        '@perawallet/connect': false,
+        '@perawallet/connect-beta': false,
+        '@walletconnect/modal': false,
+        '@walletconnect/sign-client': false,
+        'lute-connect': false,
+        'magic-sdk': false
+      }
+    }
     return config
   }
 }