Devel new

.cursor/hooks.json

@@ -0,0 +1,13 @@
+{
+    "version": 1,
+    "hooks": {
+        "afterFileEdit": [
+            {
+                "command": "yarn eslint --fix ${file}",
+                "filter": {
+                    "include": ["**/*.{ts,tsx,js,jsx}"]
+                }
+            }
+        ]
+    }
+}

.cursor/mcp.json

@@ -0,0 +1,8 @@
+{
+    "mcpServers": {
+      "chakra-ui": {
+        "command": "npx",
+        "args": ["-y", "@chakra-ui/react-mcp"]
+      }
+    }
+  }

.cursor/rules/frontend.mdc

@@ -31,7 +31,7 @@ You are an expert senior software engineer specializing in modern web developmen
 
 ### UI and Styling
 - Utilize Chakra UI v3 components for consistent design
-- Be aware that some components are tailored for the project's specific requirements. They are all located in the "toolkit/chakra" directory. Always use these instead of the native Chakra components.
+- **Component Import Priority**: Always check if a component exists in `toolkit/chakra/**` before importing from Chakra UI. If a custom version exists in `toolkit/chakra/**`, import from there instead of the native Chakra component. Only use default Chakra components when no custom version is available in `toolkit/chakra/**`.
 
 
 

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -1,6 +1,7 @@
-name: Bug Report
+name: Bug report
 description: File a bug report
 labels: [ "bug", "triage" ]
+type: bug
 body:
   - type: markdown
     attributes:

.github/ISSUE_TEMPLATE/feature_spec.yml

@@ -0,0 +1,42 @@
+name: Feature spec (Blockscout team)
+description: A simple template to capture title, overview, todo, mockups and deployment info.
+type: feature
+labels: ['enhancement']
+assignees: []
+body:
+  - type: textarea
+    id: overview
+    attributes:
+      label: Overview
+      description: Brief summary of the feature and why it's needed
+      placeholder: "Describe the purpose and goals of this feature..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: todo
+    attributes:
+      label: To‑do / Implementation notes
+      description: High-level checklist or tasks to implement (use - [ ] items for checklists)
+      placeholder: "- [ ] Task 1\n- [ ] Task 2\n- [ ] Notes on approach..."
+
+  - type: textarea
+    id: mockups
+    attributes:
+      label: Mockups / Screenshots / Links
+      description: Paste links (Figma, image URLs) or describe the visual changes. Attach screenshots when possible.
+      placeholder: "https://www.figma.com/..., or link to image(s) / attach screenshots"
+
+  - type: textarea
+    id: deployment
+    attributes:
+      label: Deployment info
+      description: Deployment notes, feature flags, rollout plan, or special instructions
+      placeholder: "e.g. Requires DB migration X; enable feature-flag Y during rollout"
+
+  - type: textarea
+    id: acceptance_criteria
+    attributes:
+      label: Acceptance criteria
+      description: Conditions that must be met for this feature to be considered done
+      placeholder: "- Users can ...\n- API returns ...\n- No regressions in ..."

.github/workflows/cf-deploy.yml

@@ -0,0 +1,84 @@
+name: Deploy Blockscout to Cloudflare
+
+on:
+  push:
+    branches:
+      - devel
+    paths-ignore:
+      - '.github/ISSUE_TEMPLATE/**'
+      - '.husky/**'
+      - '.vscode/**'
+      - 'docs/**'
+      - 'jest/**'
+      - 'mocks/**'
+      - 'playwright/**'
+      - 'stubs/**'
+      - 'tools/**'
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    name: Deploy Blockscout
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v2
+        with:
+          version: 8
+
+      - uses: actions/setup-node@v3
+        with:
+          node-version: "22.11.0"
+          cache: "yarn"
+
+      - name: Install dependencies
+        run: yarn install
+        env:
+          CI: true
+          HUSKY: 0
+
+      - name: Build Blockscout
+        run: yarn run build:next
+        env:
+          # Local development ENVs
+          # NEXT_PUBLIC_APP_HOST: ${{ var.NEXT_PUBLIC_APP_HOST }}
+          # NEXT_PUBLIC_APP_PORT: ${{ var.NEXT_PUBLIC_APP_PORT }}
+          # NEXT_PUBLIC_APP_PROTOCOL: ${{ var.NEXT_PUBLIC_APP_PROTOCOL }}
+          # NEXT_PUBLIC_API_BASE_PATH=: ${{ var.NEXT_PUBLIC_API_BASE_PATH }}
+          # NEXT_PUBLIC_IS_TESTNET: ${{ var.NEXT_PUBLIC_IS_TESTNET }}
+          # NEXT_PUBLIC_APP_ENV: ${{ var.NEXT_PUBLIC_APP_ENV }}
+          # Blockscout specific
+          NEXT_PUBLIC_API_HOST: ${{ vars.NEXT_PUBLIC_API_HOST }}
+          NEXT_PUBLIC_STATS_API_HOST: ${{ vars.NEXT_PUBLIC_STATS_API_HOST }}
+          NEXT_PUBLIC_NETWORK_NAME: ${{ vars.NEXT_PUBLIC_NETWORK_NAME }}
+          NEXT_PUBLIC_NETWORK_SHORT_NAME: ${{ vars.NEXT_PUBLIC_NETWORK_SHORT_NAME }}
+          NEXT_PUBLIC_NETWORK_ID: ${{ vars.NEXT_PUBLIC_NETWORK_ID }}
+          NEXT_PUBLIC_NETWORK_CURRENCY_NAME: ${{ vars.NEXT_PUBLIC_NETWORK_CURRENCY_NAME }}
+          NEXT_PUBLIC_NETWORK_CURRENCY_SYMBOL: ${{ vars.NEXT_PUBLIC_NETWORK_CURRENCY_SYMBOL }}
+          NEXT_PUBLIC_NETWORK_CURRENCY_DECIMALS: ${{ vars.NEXT_PUBLIC_NETWORK_CURRENCY_DECIMALS }}
+          NEXT_PUBLIC_HOMEPAGE_CHARTS: ${{ vars.NEXT_PUBLIC_HOMEPAGE_CHARTS }}
+          NEXT_PUBLIC_VISUALIZE_API_HOST: ${{ vars.NEXT_PUBLIC_VISUALIZE_API_HOST }}
+          NEXT_PUBLIC_API_WEBSOCKET_PROTOCOL: ${{ vars.NEXT_PUBLIC_API_WEBSOCKET_PROTOCOL }}
+          NEXT_PUBLIC_API_SPEC_URL: ${{ vars.NEXT_PUBLIC_API_SPEC_URL }}
+          # Theme
+          NEXT_PUBLIC_COLOR_THEME_DEFAULT: ${{ vars.NEXT_PUBLIC_COLOR_THEME_DEFAULT }}
+          NEXT_PUBLIC_NAVIGATION_LAYOUT: ${{ vars.NEXT_PUBLIC_NAVIGATION_LAYOUT }}
+
+      - name: Prepare deployment
+        run: |
+          mkdir -p ./deploy
+          cp -r .next ./deploy/
+          cp -r public ./deploy/
+          cp package.json ./deploy/
+          cd ./deploy
+          yarn add wrangler@3 --dev
+        env:
+          HUSKY: 0
+
+      - name: Deploy to Cloudflare Pages
+        working-directory: ./deploy
+        run: yarn wrangler pages deploy . --project-name=blockscout-fluent --commit-dirty=true
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

.github/workflows/checks.yml

@@ -34,7 +34,7 @@ jobs:
       - name: Setup node
         uses: actions/setup-node@v4
         with:
-          node-version: 22.11.0
+          node-version: 22.14.0
           cache: 'yarn'
 
       - name: Cache node_modules
@@ -70,7 +70,7 @@ jobs:
       - name: Setup node
         uses: actions/setup-node@v4
         with:
-          node-version: 22.11.0
+          node-version: 22.14.0
           cache: 'yarn'
 
       - name: Cache node_modules
@@ -133,7 +133,7 @@ jobs:
       - name: Setup node
         uses: actions/setup-node@v4
         with:
-          node-version: 22.11.0
+          node-version: 22.14.0
           cache: 'yarn'
 
       - name: Cache node_modules
@@ -163,8 +163,8 @@ jobs:
           echo "exitcode=$exitcode" >> $GITHUB_OUTPUT
           exit "$exitcode"
 
-  jest_tests:
-    name: Jest tests
+  vitest_tests:
+    name: Unit tests
     needs: [ code_quality, envs_validation ]
     runs-on: ubuntu-latest
     steps:
@@ -176,7 +176,7 @@ jobs:
       - name: Setup node
         uses: actions/setup-node@v4
         with:
-          node-version: 22.11.0
+          node-version: 22.14.0
           cache: 'yarn'
 
       - name: Cache node_modules
@@ -195,8 +195,8 @@ jobs:
         if: steps.cache-node-modules.outputs.cache-hit == 'true'
         run: yarn chakra:typegen
 
-      - name: Run Jest
-        run: yarn test:jest ${{ github.event_name == 'pull_request' && '--changedSince=origin/main' || '' }} --passWithNoTests
+      - name: Run Vitest
+        run: yarn test:vitest ${{ github.event_name == 'pull_request' && '--changed=origin/main' || '' }} --passWithNoTests
 
   pw_affected_tests:
     name: Resolve affected Playwright tests
@@ -212,7 +212,7 @@ jobs:
       - name: Setup node
         uses: actions/setup-node@v4
         with:
-          node-version: 22.11.0
+          node-version: 22.14.0
           cache: 'yarn'
 
       - name: Cache node_modules
@@ -254,7 +254,7 @@ jobs:
       (needs.pw_affected_tests.result == 'success' || needs.pw_affected_tests.result == 'skipped') 
     runs-on: ubuntu-latest
     container:
-      image: mcr.microsoft.com/playwright:v1.49.0-noble
+      image: mcr.microsoft.com/playwright:v1.57.0-noble
 
     strategy:
       fail-fast: false
@@ -273,7 +273,7 @@ jobs:
       - name: Setup node
         uses: actions/setup-node@v4
         with:
-          node-version: 22.11.0
+          node-version: 22.14.0
           cache: 'yarn'
 
       - name: Cache node_modules

.github/workflows/pre-release.yml

@@ -31,6 +31,8 @@ jobs:
     version:
         name: Pre-release version info
         runs-on: ubuntu-latest
+        permissions:
+          contents: read
         outputs:
             is_initial: ${{ steps.is_initial.outputs.result }}
         steps:

.github/workflows/publish-image.yml

@@ -68,12 +68,7 @@ jobs:
                 id: meta
                 uses: docker/metadata-action@v5
                 with:
-                    images: ${{ steps.image-name.outputs.image-name }}
-                    flavor: |
-                        latest=false
-                    tags: |
-                        type=ref,event=tag
-                        ${{ inputs.tags }}
+                    images: ghcr.io/fluentlabs-xyz/blockscout-frontend
 
             -   name: Add SHORT_SHA env property with commit short sha
                 run: echo "SHORT_SHA=`echo ${GITHUB_SHA} | cut -c1-8`" >> $GITHUB_ENV

.github/workflows/toolkit-npm-publisher.yml

@@ -30,7 +30,7 @@ jobs:
       - name: Setup node
         uses: actions/setup-node@v4
         with:
-          node-version: '22.11.0'
+          node-version: '22.14.0'
           registry-url: 'https://registry.npmjs.org'
 
       # Ensure npm 11.5.1 is installed

.gitignore

@@ -44,6 +44,7 @@ yarn-error.log*
 
 # local env files
 .env*.local
+.env
 /configs/envs/.env.secrets
 /configs/envs/.samples
 

.husky/pre-commit

@@ -7,11 +7,11 @@ npx lint-staged
 
 # format svg
 echo 🧿 Running svg formatter...
-for file in `git diff --diff-filter=ACMRT --cached --name-only | grep ".svg\$"`
-    do 
-        echo "Formatting $file" 
-        ./node_modules/.bin/svgo -q $file --config svgo.config.format.js
-        git add $file
-    done
+git diff --diff-filter=ACMRT --cached --name-only -z | grep -z -E "\.svg$" | while IFS= read -r -d '' file
+do
+    echo "Formatting $file"
+    ./node_modules/.bin/svgo -q "$file" --config svgo.config.format.js
+    git add "$file"
+done
 
 echo ✅ All pre-commit jobs are done

.nvmrc

@@ -1 +1 @@
-22.11.0
+>=22.14.0

.vscode/launch.json

@@ -3,23 +3,5 @@
     // Hover to view descriptions of existing attributes.
     // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
     "version": "0.2.0",
-    "configurations": [
-        {
-            "type": "node",
-            "request": "launch",
-            "name": "Jest: watch current file",
-            "program": "${workspaceFolder}/node_modules/jest/bin/jest",
-            "args": [
-                "${fileBasename}",
-                "--runInBand",
-                "--verbose",
-                "-i",
-                "--no-cache",
-                "--watchAll",
-                "--testTimeout=1000000000",
-            ],
-            "console": "integratedTerminal",
-            "internalConsoleOptions": "neverOpen"
-        }
-    ]
+    "configurations": [ ]
 }