Prod Release Sprint 124

.cursorrules

@@ -21,6 +21,13 @@
 - **Performance is important** - cache where possible, make sure to not make unnecessary re-renders or data fetching.
 - **Flag breaking changes** - always flag if changes done in Frontend are breaking and require action on Backend (or viceversa)
 
+## 🚫 Import Rules (critical for build performance)
+
+- **No barrel imports** - never use `import * as X from '@/constants'` or create index.ts barrel files. always import from specific files (e.g. `import { PEANUT_API_URL } from '@/constants/general.consts'`). barrel imports slow down builds and cause bundling issues.
+- **No circular dependencies** - before adding imports, check if the target file imports from the current file. circular deps cause `Cannot access X before initialization` errors. move shared types to `interfaces.ts` if needed.
+- **No node.js packages in client components** - packages like `web-push`, `fs`, `crypto` (node) can't be used in `'use client'` files. use server actions or api routes instead.
+- **Check for legacy code** - before importing from a file, check if it has TODO comments marking it as legacy/deprecated. prefer newer implementations.
+
 ## 🧪 Testing
 
 - **Test new code** - where tests make sense, test new code. Especially with fast unit tests.
@@ -43,6 +50,7 @@
 - **Cache where possible** - avoid unnecessary re-renders and data fetching
 - **Fire simultaneous requests** - if you're doing multiple sequential awaits and they're not interdependent, fire them simultaneously
 - **Service Worker cache version** - only bump `NEXT_PUBLIC_API_VERSION` for breaking API changes (see JSDoc in `src/app/sw.ts`). Users auto-migrate.
+- **Gate heavy features in dev** - prefetching, precompiling, or eager loading of routes can add 5-10s to dev cold starts. wrap with `process.env.NODE_ENV !== 'development'` (e.g. `<link rel="prefetch" href="/qr-pay" />` in layout.tsx).
 
 ## 📝 Commits
 

.gitignore

@@ -69,4 +69,4 @@ certificates
 public/sw*
 public/swe-worker*
 
-.idea
+.idea

knip.json

@@ -1,6 +1,6 @@
 {
     "$schema": "https://unpkg.com/[email protected]/schema.json",
     "ignore": ["src/assets/**"],
-    "entry": ["src/**/*.{js,jsx,ts,tsx}", "postcss.config.js", "tailwind.config.js"],
+    "entry": ["src/**/*.{js,jsx,ts,tsx}"],
     "project": ["src/**/*.{js,jsx,ts,tsx}", "*.config.{js,ts}"]
 }

next.config.js

@@ -58,9 +58,6 @@ let nextConfig = {
         },
     },
 
-    // External packages that shouldn't be bundled (server-side only)
-    serverExternalPackages: [],
-
     // Disable source maps in production (already handled by Sentry)
     productionBrowserSourceMaps: false,
 
@@ -69,9 +66,24 @@ let nextConfig = {
 
     // Experimental features for optimization
     experimental: {
-        // Optimize package imports for tree-shaking
-        optimizePackageImports: ['@chakra-ui/react', 'framer-motion', '@headlessui/react'],
-        // Speed up webpack builds (fallback mode when not using --turbo)
+        // Note: turbopackFileSystemCacheForDev is enabled by default in Next.js 16+
+        // optimize package imports for tree-shaking (barrel file optimization)
+        // lodash and date-fns are used by transitive dependencies (e.g. chakra, framer-motion)
+        optimizePackageImports: [
+            '@chakra-ui/react',
+            'framer-motion',
+            '@headlessui/react',
+            '@radix-ui/react-accordion',
+            '@radix-ui/react-select',
+            '@radix-ui/react-slider',
+            '@reduxjs/toolkit',
+            'react-redux',
+            'lodash',
+            'date-fns',
+            'react-hook-form',
+            '@mui/icons-material',
+        ],
+        // Speed up webpack builds (used for production builds with --webpack flag)
         webpackBuildWorker: true,
     },
 

package.json

@@ -7,6 +7,7 @@
     },
     "scripts": {
         "dev": "NODE_OPTIONS=\"--max-old-space-size=8192\" next dev --turbo",
+        "dev:clean": "rm -rf .next && NODE_OPTIONS=\"--max-old-space-size=8192\" next dev --turbo",
         "dev:fallback": "next dev",
         "build": "next build --webpack",
         "start": "next start",
@@ -20,23 +21,20 @@
         "script": "NODE_OPTIONS=\"--experimental-json-modules\" tsx"
     },
     "dependencies": {
-        "@calcom/embed-react": "^1.5.1",
-        "@chakra-ui/color-mode": "^2.2.0",
-        "@chakra-ui/icon": "^3.2.0",
-        "@chakra-ui/react": "^2.10.4",
-        "@chakra-ui/react-context": "^2.1.0",
-        "@chakra-ui/shared-utils": "^2.0.4",
         "@daimo/pay": "^1.16.5",
         "@dicebear/collection": "^9.2.2",
         "@dicebear/core": "^9.2.2",
+        "@emotion/react": "^11.14.0",
         "@headlessui/react": "^2.2.9",
         "@headlessui/tailwindcss": "^0.2.1",
-        "@hookform/resolvers": "3.9.1",
         "@justaname.id/react": "0.3.180",
         "@justaname.id/sdk": "0.2.177",
+        "@mui/icons-material": "^7.3.6",
+        "@mui/material": "^7.3.6",
         "@radix-ui/react-accordion": "^1.2.12",
         "@radix-ui/react-select": "^2.2.6",
         "@radix-ui/react-slider": "^1.3.5",
+        "@radix-ui/react-tabs": "^1.1.13",
         "@reduxjs/toolkit": "^2.5.0",
         "@reown/appkit": "1.6.9",
         "@reown/appkit-adapter-wagmi": "1.6.9",
@@ -51,10 +49,8 @@
         "@wagmi/core": "2.19.0",
         "@zerodev/passkey-validator": "^5.6.0",
         "@zerodev/sdk": "5.5.0",
-        "auto-text-size": "^0.2.3",
         "autoprefixer": "^10.4.20",
         "canvas-confetti": "^1.9.3",
-        "chakra-ui-steps": "^2.1.0",
         "classnames": "^2.5.1",
         "d3-force": "^3.0.0",
         "embla-carousel-react": "^8.6.0",
@@ -64,16 +60,12 @@
         "iban-to-bic": "^1.4.0",
         "js-cookie": "^3.0.5",
         "jsqr": "^1.4.0",
-        "lottie-react": "^2.4.0",
-        "multicoin-address-validator": "^0.5.22",
         "next": "16.0.10",
         "pulltorefreshjs": "^0.1.22",
         "react": "^19.2.1",
-        "react-csv": "^2.2.2",
         "react-dom": "^19.2.1",
         "react-fast-marquee": "^1.6.5",
         "react-force-graph-2d": "^1.25.10",
-        "react-ga4": "^2.1.0",
         "react-hook-form": "^7.53.2",
         "react-onesignal": "^3.2.3",
         "react-qr-code": "^2.0.15",
@@ -84,39 +76,29 @@
         "tailwind-merge": "^1.14.0",
         "tailwind-scrollbar": "^3.1.0",
         "use-haptic": "^1.1.11",
-        "uuid": "^10.0.0",
         "validator": "^13.12.0",
         "vaul": "^1.1.2",
         "viem": "^2.22.0",
-        "wagmi": "2.16.3",
-        "web-push": "^3.6.7",
-        "yup": "^1.4.0"
+        "wagmi": "2.16.3"
     },
     "devDependencies": {
-        "@next/bundle-analyzer": "^16.0.0",
+        "@next/bundle-analyzer": "^16.1.1",
         "@serwist/build": "^9.0.10",
         "@size-limit/preset-app": "^11.2.0",
         "@testing-library/jest-dom": "^6.4.2",
         "@testing-library/react": "^16.1.0",
-        "@testing-library/user-event": "^14.5.2",
         "@types/canvas-confetti": "^1.9.0",
-        "@types/chroma-js": "^2.4.4",
         "@types/jest": "^29.5.12",
         "@types/js-cookie": "^3.0.6",
-        "@types/multicoin-address-validator": "^0.5.3",
         "@types/node": "20.4.2",
         "@types/pulltorefreshjs": "^0.1.7",
         "@types/react": "^18.3.12",
-        "@types/react-csv": "^1.1.10",
         "@types/react-dom": "^18.3.1",
-        "@types/uuid": "^9.0.8",
         "@types/validator": "^13.12.2",
-        "@types/web-push": "^3.6.4",
         "jest": "^29.7.0",
         "jest-environment-jsdom": "^29.7.0",
         "jest-transform-stub": "^2.0.0",
         "knip": "^5.37.1",
-        "ngrok": "^4.0.0",
         "postcss": "^8.4.49",
         "postcss-import": "^16.1.0",
         "prettier": "^3.3.3",
@@ -125,7 +107,6 @@
         "size-limit": "^11.2.0",
         "tailwindcss": "^3.4.15",
         "ts-jest": "^29.1.2",
-        "tslib": "^2.7.0",
         "tsx": "^4.19.3",
         "typescript": "^5.6.3"
     },
@@ -151,7 +132,6 @@
             "^@squirrel-labs/peanut-sdk$": "<rootDir>/src/utils/__mocks__/peanut-sdk.ts",
             "^@reown/appkit/react$": "<rootDir>/src/utils/__mocks__/reown-appkit.ts",
             "^@justaname\\.id/react$": "<rootDir>/src/utils/__mocks__/justaname.ts",
-            "^web-push$": "<rootDir>/src/utils/__mocks__/web-push.ts",
             "^next/cache$": "<rootDir>/src/utils/__mocks__/next-cache.ts",
             "^@zerodev/sdk(.*)$": "<rootDir>/src/utils/__mocks__/zerodev-sdk.ts",
             "^@simplewebauthn/browser$": "<rootDir>/src/utils/__mocks__/simplewebauthn-browser.ts",