Merge branch 'dev' into dev

Author: wackerow

.all-contributorsrc

@@ -12660,7 +12660,7 @@
       "login": "mseidlx",
       "name": "Matthias Seidl",
       "avatar_url": "https://avatars.githubusercontent.com/u/32496674?v=4",
-      "profile": "https://growthepie.xyz",
+      "profile": "https://growthepie.com",
       "contributions": [
         "code"
       ]
@@ -12782,6 +12782,52 @@
       "contributions": [
         "eventOrganizing"
       ]
+    },
+    {
+      "login": "brossetti1",
+      "name": "Brian Rossetti",
+      "avatar_url": "https://avatars.githubusercontent.com/u/5998100?v=4",
+      "profile": "https://github.com/brossetti1",
+      "contributions": [
+        "maintenance",
+        "code"
+      ]
+    },
+    {
+      "login": "Antoine-Sparenberg",
+      "name": "Antoine-Sparenberg",
+      "avatar_url": "https://avatars.githubusercontent.com/u/128523213?v=4",
+      "profile": "https://github.com/Antoine-Sparenberg",
+      "contributions": [
+        "maintenance"
+      ]
+    },
+    {
+      "login": "kks-code",
+      "name": "Kendra Karol Sevilla",
+      "avatar_url": "https://avatars.githubusercontent.com/u/214244795?v=4",
+      "profile": "https://github.com/kks-code",
+      "contributions": [
+        "maintenance"
+      ]
+    },
+    {
+      "login": "otc-png",
+      "name": "otc group",
+      "avatar_url": "https://avatars.githubusercontent.com/u/214395681?v=4",
+      "profile": "https://github.com/otc-png",
+      "contributions": [
+        "maintenance"
+      ]
+    },
+    {
+      "login": "Savio-Sou",
+      "name": "Savio",
+      "avatar_url": "https://avatars.githubusercontent.com/u/72797635?v=4",
+      "profile": "https://github.com/Savio-Sou",
+      "contributions": [
+        "maintenance"
+      ]
     }
   ],
   "contributorsPerLine": 7,

.claude/commands/update-llms-txt.md

@@ -0,0 +1,87 @@
+# Update LLMS.txt Command
+
+This command helps maintain the `public/llms.txt` file by monitoring key navigation files:
+
+1. **Main Navigation**: `src/components/Nav/useNavigation.ts`
+2. **Developer Docs**: `src/data/developer-docs-links.yaml`
+3. **Footer Links**: `src/components/Footer.tsx`
+
+## How it works
+
+- Adds missing links to appropriate sections
+- Preserves existing descriptions and organization
+- Follows established llms.txt structure
+- **Prefers static markdown files URLs over html URLs** for better LLM comprehension
+
+## Implementation
+
+When this command is executed, I will:
+
+### Step 1: Parse Navigation Files
+
+**Main Navigation** (`src/components/Nav/useNavigation.ts`):
+
+```javascript
+// Extract linkSections object structure
+// Parse learn, use, build, participate sections
+// Get href, label, and description for each link
+```
+
+**Developer Docs** (`src/data/developer-docs-links.yaml`):
+
+```yaml
+# Parse foundational-topics, ethereum-stack, advanced, design-fundamentals
+# Extract href and id mappings
+# Build hierarchical structure
+```
+
+**Footer Links** (`src/components/Footer.tsx`):
+
+```javascript
+// Extract linkSections and dipperLinks arrays
+// Get all footer navigation items
+// Include external links (blog, ESP, Devcon)
+```
+
+### Step 2: Analyze Current llms.txt
+
+- Parse existing sections and their links
+- Extract current URLs and descriptions
+- Identify section organization and hierarchy
+
+### Step 3: URL to Markdown File Mapping
+
+**Priority: Static markdown files URLs over web html URLs**
+
+For each link, I will:
+
+1. Check if corresponding markdown file exists in `public/content/`. **Ignore translations**: Skip `public/content/translations/` directory (60+ language versions)
+2. Use a URL pointing to the markdown file for the page: `https://ethereum.org/content/[page]/index.md`
+3. Fall back to web URL only if no markdown file exists
+4. Example: `https://ethereum.org/learn/` → `https://ethereum.org/content/learn/index.md`
+5. Example2: `https://ethereum.org/guides/how-to-use-a-wallet/` → `https://ethereum.org/content/guides/how-to-use-a-wallet/index.md`
+
+### Step 4: Smart Link Categorization
+
+New links are categorized using these rules:
+
+1. **Learn Section**: `/learn/`, `/what-is-*`, `/guides/`, `/quizzes/`, `/glossary/`
+2. **Use Section**: `/get-eth`, `/wallets/`, `/dapps/`, `/staking/`, use cases
+3. **Build Section**: `/developers/`, `/enterprise/`, developer tools
+4. **Participate Section**: `/community/`, `/contributing/`, `/foundation/`
+5. **Research Section**: `/whitepaper`, `/roadmap/`, `/eips/`, `/governance/`
+
+### Step 5: Validation & Quality Checks
+
+- Verify all markdown files exist in `public/content/`
+- Check for duplicate links within sections
+- Validate section organization and hierarchy
+- Ensure descriptions are informative and concise
+
+### Step 6: Execute Action
+
+Update llms.txt file with improved structure and validated links
+
+---
+
+The command ensures the llms.txt file remains comprehensive and current with minimal manual maintenance.

.env.example

@@ -31,7 +31,7 @@ NEXT_PUBLIC_MATOMO_URL=
 NEXT_PUBLIC_MATOMO_SITE_ID=
 
 # Used to avoid loading Matomo in our preview deploys
-IS_PREVIEW_DEPLOY=false
+NEXT_PUBLIC_IS_PREVIEW_DEPLOY=false
 
 # Build pages only for the specified langs. Leave it empty to build all the langs
 # e.g. `en,fr` will only build English and French pages

.eslintrc.json

@@ -24,7 +24,7 @@
             "^(assert|buffer|child_process|cluster|console|constants|crypto|dgram|dns|domain|events|fs|http|https|module|net|os|path|punycode|querystring|readline|repl|stream|string_decoder|sys|timers|tls|tty|url|util|vm|zlib|freelist|v8|process|async_hooks|http2|perf_hooks)(/.*|$)"
           ],
           // Packages. `react` related packages come first.
-          // Also, put `react-icons` in sorting order not with `react`
+          // Also, put `react-*` in sorting order not with `react`
           ["^react(?!-.)$", "^\\w", "^@\\w"],
           // From the `types` directory.
           ["^@/lib/types", "^@/lib/interfaces"],
@@ -90,6 +90,7 @@
     "coverage/",
     "storybook-static/",
     "**/*.d.ts",
-    "src/intl/"
+    "src/intl/",
+    "public/code-examples/"
   ]
 }

.github/workflows/chromatic.yml

@@ -6,18 +6,8 @@ name: Chromatic Publish and Testing
 # Event for the workflow
 on:
   pull_request:
-    types:
-      - opened
-      - synchronize
-      - ready_for_review
-    paths:
-      # Only run on file changes in any of these paths
-      - "src/components/**/*"
-      - "src/pages/**/*"
-      - "src/layouts/**/*"
-      - ".storybook/**/*"
-      - "tailwind.config.ts"
-      - "src/styles/**/*"
+    branches: [master, staging, "test/**"]
+    types: [opened, synchronize, ready_for_review]
 
 # List of jobs
 jobs:
@@ -26,28 +16,35 @@ jobs:
     runs-on: ubuntu-latest
     # Job steps
     steps:
-      # 👇 Version 2 of the action
       - name: Checkout repo
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
-          fetch-depth: 0 # 👈 Required to retrieve git history
+          fetch-depth: 0
+          # Tells the checkout which commit hash to reference
+          ref: ${{ github.event.pull_request.head.ref }}
+        env:
+          CHROMATIC_BRANCH: ${{ github.event.pull_request.head.ref || github.ref_name }}
+          CHROMATIC_SHA: ${{ github.event.pull_request.head.sha || github.ref }}
+          CHROMATIC_SLUG: ${{ github.repository }}
+
       - name: Setup pnpm
         uses: pnpm/action-setup@v2
         with:
-          version: 8
+          version: 10
       - name: Setup Node.js
         uses: actions/setup-node@v3
         with:
           node-version: 20
-          cache: 'pnpm'
+          cache: "pnpm"
+
       - name: Install deps
-        # 👇 Install dependencies with the same package manager used in the project (replace it as needed), e.g. yarn, npm, pnpm
         run: pnpm install
+
       - name: Publish to Chromatic
-        # 👇 Adds Chromatic as a step in the workflow
         uses: chromaui/action@v1
-        # Options required for Chromatic's GitHub Action
         with:
           projectToken: fee8e66c9916
           # 👇 Only fail if Storybook contains stories that error
           exitZeroOnChanges: true
+          onlyChanged: true # enables TurboSnap
+          zip: true

.github/workflows/claude.yml

@@ -0,0 +1,52 @@
+name: Claude PR Assistant
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude-code-action:
+    if: |
+      (
+        github.event_name == 'issue_comment' &&
+        contains(github.event.comment.body, '@claude') &&
+        contains('minimalsm,pettinarip,wackerow,corwintines,nloureiro,konopkja', github.event.comment.user.login)
+      ) ||
+      (
+        github.event_name == 'pull_request_review_comment' &&
+        contains(github.event.comment.body, '@claude') &&
+        contains('minimalsm,pettinarip,wackerow,corwintines,nloureiro,konopkja', github.event.comment.user.login)
+      ) ||
+      (
+        github.event_name == 'pull_request_review' &&
+        contains(github.event.review.body, '@claude') &&
+        contains('minimalsm,pettinarip,wackerow,corwintines,nloureiro,konopkja', github.event.review.user.login)
+      ) ||
+      (
+        github.event_name == 'issues' &&
+        contains(github.event.issue.body, '@claude') &&
+        contains('minimalsm,pettinarip,wackerow,corwintines,nloureiro,konopkja', github.event.issue.user.login)
+      )
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude PR Action
+        uses: anthropics/claude-code-action@beta
+        with:
+          anthropic_api_key: ${{ secrets.ANTHROPIC_API_KEY }}
+          timeout_minutes: "60"

.github/workflows/crowdin-ci.yml

@@ -18,16 +18,22 @@ jobs:
       - name: Check out code
         uses: actions/checkout@v3
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 10
+
       - name: Set up Node.js
         uses: actions/setup-node@v3
         with:
-          node-version: 18
+          node-version: 20
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: yarn install
+        run: pnpm install
 
       - name: Install ts-node
-        run: yarn global add ts-node
+        run: pnpm add -g ts-node
 
       - name: Set up git
         run: |

.github/workflows/generate-review-report.yml

@@ -10,16 +10,22 @@ jobs:
       - name: Check out code
         uses: actions/checkout@v3
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 10
+
       - name: Set up Node.js
         uses: actions/setup-node@v3
         with:
-          node-version: 18
+          node-version: 20
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: yarn install
+        run: pnpm install
 
       - name: Install ts-node
-        run: yarn global add ts-node
+        run: pnpm add -g ts-node
 
       - name: Run script
         run: npx ts-node -O '{"module":"commonjs"}' ./src/scripts/crowdin/reports/generateReviewReport.ts

.github/workflows/get-crowdin-contributors.yml

@@ -12,16 +12,22 @@ jobs:
       - name: Check out code
         uses: actions/checkout@v3
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 10
+
       - name: Set up Node.js
         uses: actions/setup-node@v3
         with:
-          node-version: 18
+          node-version: 20
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: yarn install
+        run: pnpm install
 
       - name: Install ts-node
-        run: yarn global add ts-node
+        run: pnpm add -g ts-node
 
       - name: Set up git
         run: |

.github/workflows/get-leaderboard-reports.yml

@@ -12,16 +12,22 @@ jobs:
       - name: Check out code
         uses: actions/checkout@v3
 
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v2
+        with:
+          version: 10
+
       - name: Set up Node.js
         uses: actions/setup-node@v3
         with:
-          node-version: 18
+          node-version: 20
+          cache: 'pnpm'
 
       - name: Install dependencies
-        run: yarn install
+        run: pnpm install
 
       - name: Install ts-node
-        run: yarn global add ts-node
+        run: pnpm add -g ts-node
 
       - name: Set up git
         run: |