Migrate app from Webpack SPA to Next.js pages router

.github/workflows/ci.yml

@@ -20,7 +20,15 @@ jobs:
           cache: "npm"
 
       - name: Install dependencies
-        run: npm ci
+        run: npm ci --include=dev
+
+      - name: Verify core framework dependencies
+        run: |
+          node -e "const pkgs=['next','react','react-dom']; for (const pkg of pkgs){const path=require.resolve(pkg + '/package.json'); const version=require(path).version; console.log(pkg + '@' + version)}"
+          test -f node_modules/next/dist/bin/next
+
+      - name: Lockfile reproducibility check
+        run: git diff --exit-code package-lock.json
 
       - name: Typecheck
         run: npm run typecheck

README.md

@@ -178,6 +178,8 @@ npm ci
 ### Notes
 
 - `dist/` is generated output and should not be committed.
+- `package-lock.json` must be generated by npm commands (`npm install` / `npm ci`) and never hand-edited.
+- CI validates lockfile reproducibility after install; any unintended lockfile changes should fail the build.
 - CI runs `npm ci`, `npm run typecheck`, and `npm run build` on every PR/push.
 - Git hooks are managed by Husky and installed automatically on `npm ci`.
 

next-env.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/pages/api-reference/config/typescript for more information.