Update deps and setup of giftcard-tutorial project

solutions/giftcard-tutorial/.env.example

@@ -0,0 +1,17 @@
+# ----- Commerce Layer ------
+
+# The client ID of your Commerce Layer application.
+# Must be a *sales channel* application: this value is exposed to the browser
+# (NEXT_PUBLIC_ prefix) and is used for the client_credentials flow.
+# Create one in the CL dashboard under Settings > Applications.
+NEXT_PUBLIC_CL_CLIENT_ID=your-sales-channel-client-id
+
+# Your Commerce Layer organization slug — the subdomain of your organization
+# (e.g. "acme" for acme.commercelayer.io). Also used to build the hosted
+# checkout URL: https://<slug>.commercelayer.app/checkout/<order-id>
+NEXT_PUBLIC_CL_ORG_SLUG=your-organization-slug
+
+# Optional — the code of the market to scope the access token to.
+# Defaults to "us" when unset. The app requests the "market:code:<code>" scope,
+# so set this to the code of a market that exists in your organization.
+# NEXT_PUBLIC_CL_MARKET_CODE=us

solutions/giftcard-tutorial/AGENTS.md

@@ -0,0 +1,9 @@
+<!-- BEGIN:nextjs-agent-rules -->
+
+# This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.
+
+This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.
+
+<!-- END:nextjs-agent-rules -->

solutions/giftcard-tutorial/CLAUDE.md

@@ -0,0 +1 @@
+@AGENTS.md

solutions/giftcard-tutorial/eslint.config.mjs

@@ -1,16 +1,13 @@
-import { dirname } from "path";
-import { fileURLToPath } from "url";
-import { FlatCompat } from "@eslint/eslintrc";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-const compat = new FlatCompat({
-  baseDirectory: __dirname,
-});
+import nextCoreWebVitals from "eslint-config-next/core-web-vitals";
+import nextTypeScript from "eslint-config-next/typescript";
 
+/** @type {import('eslint').Linter.Config[]} */
 const eslintConfig = [
-  ...compat.extends("next/core-web-vitals", "next/typescript"),
+  {
+    ignores: [".next/**", "node_modules/**", "out/**", "public/**"],
+  },
+  ...nextCoreWebVitals,
+  ...nextTypeScript,
 ];
 
 export default eslintConfig;

solutions/giftcard-tutorial/next-env.d.ts

@@ -1,5 +1,7 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
+import "./.next/types/routes.d.ts";
+import "./.next/types/root-params.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

solutions/giftcard-tutorial/next.config.ts

@@ -3,7 +3,7 @@ import type { NextConfig } from "next";
 const nextConfig: NextConfig = {
   /* config options here */
   images: {
-    domains: ["res.cloudinary.com"],
+    remotePatterns: [{ protocol: "https", hostname: "res.cloudinary.com" }],
   },
 };
 

solutions/giftcard-tutorial/package.json

@@ -6,24 +6,26 @@
     "dev": "next dev",
     "build": "next build",
     "start": "next start",
-    "lint": "next lint"
+    "lint": "eslint .",
+    "clean": "pnpx rimraf --glob **/node_modules **/pnpm-lock.yaml",
+    "dep:major": "pnpm dlx npm-check-updates --packageFile '**/package.json' -u",
+    "dep:semver": "pnpm dlx npm-check-updates -t semver --packageFile '**/package.json' -u"
   },
   "dependencies": {
     "@commercelayer/js-auth": "^6.7.2",
     "@commercelayer/react-components": "^4.29.7",
     "@commercelayer/sdk": "^6.58.0",
-    "next": "15.3.4",
-    "react": "^19.2.8",
-    "react-dom": "^19.2.8"
+    "next": "^16.3.4",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
   },
   "devDependencies": {
-    "@eslint/eslintrc": "^3",
     "@tailwindcss/postcss": "^4",
     "@types/node": "^20",
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "eslint": "^9",
-    "eslint-config-next": "15.3.4",
+    "eslint-config-next": "^16.3.4",
     "tailwindcss": "^4",
     "typescript": "^5"
   }