feat: AI integration baseline by gabitoesmiapodo · Pull Request #420 · BootNodeDev/dAppBooster

gabitoesmiapodo · 2026-03-23T21:18:33Z

Summary

This branch adds AI agent context files (CLAUDE.md / AGENTS.md) and serves as the destination branch for a complete web quality initiative: a test safety net (5 PRs) followed by a web audit fix chain (5 PRs), all stacked incrementally so tests catch any regressions introduced by fixes.

This branch

CLAUDE.md + AGENTS.md — project instructions for AI agents (Claude and others). Both files are kept in sync; AGENTS.md is a regular file copy of CLAUDE.md.
.claude/ — Claude Code settings and ignore rules

Stacked PR chain (merge in order)

Test safety net

#	Branch	Target	Scope
#415	`test/utils`	`feat/ai-integration`	Tier 1: Pure utility + env tests
#416	`test/enhance-existing`	`test/utils`	Tier 2: Enhanced BigNumberInput + HashInput tests
#417	`test/hooks`	`test/enhance-existing`	Tier 3: useWeb3Status, useTokenLists, useErc20Balance hook tests
#418	`test/components`	`test/hooks`	Tier 4: TransactionButton, SwitchNetwork, WalletStatusVerifier, suspenseWrapper tests
#419	`test/demo-smoke`	`test/components`	Tier 5: Demo page smoke tests

Web quality fixes (stacked on top of tests)

#	Branch	Target	Scope
#421	`fix/a11y`	`test/demo-smoke`	WCAG AA color contrast, skip link, focus rings, aria attributes
#422	`fix/performance`	`fix/a11y`	Lazy loading, dns-prefetch, vendor chunk splitting
#423	`fix/seo`	`fix/performance`	JSON-LD structured data, sitemap hostname env var
#424	`fix/security`	`fix/seo`	CSP report-only mode + security headers via vercel.json
#425	`fix/deps`	`fix/security`	Minor/patch dependency updates including security vulnerability fixes

What was fixed

Accessibility

Warning color #cc0 → #996600 (light) / #e6b800 (dark) — was 1.3:1 contrast, now ~6-7:1
Danger and OK tokens now have separate light/dark values to pass WCAG AA in both modes
Skip link added to root layout for keyboard navigation
aria-invalid added to BigNumberInput on validation error
_focusVisible focus rings restored on CopyButton and ExternalLink (previously outline: none)
aria-label added to all icon-only buttons (close buttons, explorer links)

Performance

loading="lazy" on TokenLogo and Avatar images
DNS prefetch hints for RPC endpoints in index.html
Vite manualChunks for React, wagmi/viem, TanStack, Chakra UI, and AppKit vendor bundles

SEO

JSON-LD structured data (Organization + WebApplication schemas) in index.html
Sitemap hostname now reads from PUBLIC_APP_URL env var with fallback

Security

Content-Security-Policy-Report-Only header in vercel.json (non-breaking, report-only mode)
X-Content-Type-Options: nosniff, X-Frame-Options: DENY, Referrer-Policy: strict-origin-when-cross-origin

Dependencies

Updated all minor/patch packages (react, viem, chakra-ui, tanstack, reown/appkit, etc.)
Fixes h3 path traversal vulnerability via @reown/appkit 1.8.19

Merge order

#415 → #416 → #417 → #418 → #419 → #421 → #422 → #423 → #424 → #425 → #420 (into main)

Test plan

All 10 stacked PRs merged in order
pnpm test:coverage confirms no regressions
pnpm build passes cleanly
Lighthouse audit run on preview — target 90+ in all categories
Keyboard navigation tested: all interactive elements reachable with visible focus

vercel · 2026-03-23T21:18:39Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
components.dappbooster	Ready	Preview, Comment	Mar 23, 2026 10:22pm
demo.dappbooster	Ready	Preview	Mar 23, 2026 10:22pm
docs.dappbooster	Ready	Preview, Comment	Mar 23, 2026 10:22pm

Copilot

Pull request overview

Adds baseline documentation and configuration files intended to support AI-assisted workflows (Claude Code) alongside the existing dAppBooster template, plus local-ignore rules for Claude-specific files.

Changes:

Add CLAUDE.md with repo setup, architecture, conventions, and testing guidance.
Add Claude Code configuration (.claude/settings.json) and ignore local Claude artifacts via .gitignore.
Add AGENTS.md pointing at CLAUDE.md (likely as a symlink-style pointer).

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated 2 comments.

File	Description
`CLAUDE.md`	Adds repo “operator’s manual” covering setup, structure, conventions, and patterns.
`AGENTS.md`	Adds an agent entry pointing to `CLAUDE.md` (potentially via symlink representation).
`.gitignore`	Ignores Claude Code local settings and local CLAUDE notes.
`.claude/settings.json`	Allows web fetch access to specific documentation domains.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-03-23T21:20:54Z

CLAUDE.md

@@ -0,0 +1,229 @@
+# dAppBooster
+
+A repository template / starter-kit for building decentralized applications (dApps). Built by BootNode based on 5+ years of dApp development. Docs: https://docs.dappbooster.dev/ | Components: https://components.dappbooster.dev/


Line uses a literal | between the docs and components URLs. In Markdown this can be confused with table syntax and also makes the sentence harder to read/copy. Consider replacing the pipe with plain punctuation (e.g., separate sentences or a semicolon) and/or formatting the two links as a bullet list.

Suggested change

A repository template / starter-kit for building decentralized applications (dApps). Built by BootNode based on 5+ years of dApp development. Docs: https://docs.dappbooster.dev/ | Components: https://components.dappbooster.dev/

A repository template / starter-kit for building decentralized applications (dApps). Built by BootNode based on 5+ years of dApp development. Docs: https://docs.dappbooster.dev/. Components: https://components.dappbooster.dev/

Fixed. Replaced the literal pipe with a space separator as suggested.

Copilot · 2026-03-23T21:20:55Z

AGENTS.md

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


AGENTS.md contains only CLAUDE.md, which is commonly how git represents a symlink target. If this is intended to be a symlink, note that symlinks can be problematic on Windows or in CI environments without symlink support enabled (checkout may fail or the file may not resolve). If broad platform support is required, consider making AGENTS.md a regular markdown file that links to CLAUDE.md instead of a symlink.

Fixed. Converted AGENTS.md from a symlink to a regular file copy of CLAUDE.md — mode change 120000 -> 100644. Works on all platforms without symlink support.

…r file Replace the literal pipe character between the two URLs in the header with a space separator to avoid Markdown table syntax confusion. Convert AGENTS.md from a symlink to a regular file copy of CLAUDE.md so it works reliably on Windows and in CI environments where symlinks may not be supported.

Copilot

Pull request overview

Copilot reviewed 3 out of 4 changed files in this pull request and generated no new comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

gabitoesmiapodo added 2 commits February 24, 2026 17:09

chore: add CLAUDE.md and basic claude settings

2fa5393

chore: add ignore

293edc7

Copilot AI review requested due to automatic review settings March 23, 2026 21:18

Copilot started reviewing on behalf of gabitoesmiapodo March 23, 2026 21:18 View session

Copilot AI reviewed Mar 23, 2026

View reviewed changes

gabitoesmiapodo self-assigned this Mar 23, 2026

vercel bot deployed to Preview – components.dappbooster March 23, 2026 22:16 View deployment

vercel bot deployed to Preview – docs.dappbooster March 23, 2026 22:16 View deployment

vercel bot deployed to Preview – demo.dappbooster March 23, 2026 22:17 View deployment

gabitoesmiapodo requested a review from Copilot March 23, 2026 22:18

Copilot started reviewing on behalf of gabitoesmiapodo March 23, 2026 22:19 View session

Copilot AI reviewed Mar 23, 2026

View reviewed changes

docs: add sync reminder between CLAUDE.md and AGENTS.md

2dd84b7

vercel bot deployed to Preview – docs.dappbooster March 23, 2026 22:22 View deployment

vercel bot deployed to Preview – components.dappbooster March 23, 2026 22:22 View deployment

vercel bot deployed to Preview – demo.dappbooster March 23, 2026 22:22 View deployment

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: AI integration baseline#420

feat: AI integration baseline#420
gabitoesmiapodo wants to merge 4 commits intomainfrom
feat/ai-integration

gabitoesmiapodo commented Mar 23, 2026 •

edited

Loading

Uh oh!

vercel bot commented Mar 23, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Mar 23, 2026

Uh oh!

gabitoesmiapodo Mar 23, 2026

Uh oh!

Copilot AI Mar 23, 2026

Uh oh!

gabitoesmiapodo Mar 23, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		@@ -0,0 +1,229 @@
		# dAppBooster

		A repository template / starter-kit for building decentralized applications (dApps). Built by BootNode based on 5+ years of dApp development. Docs: https://docs.dappbooster.dev/ \| Components: https://components.dappbooster.dev/

Conversation

gabitoesmiapodo commented Mar 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

This branch

Stacked PR chain (merge in order)

Test safety net

Web quality fixes (stacked on top of tests)

What was fixed

Accessibility

Performance

SEO

Security

Dependencies

Merge order

Test plan

Uh oh!

vercel bot commented Mar 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

gabitoesmiapodo Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

gabitoesmiapodo Mar 23, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

gabitoesmiapodo commented Mar 23, 2026 •

edited

Loading

vercel bot commented Mar 23, 2026 •

edited

Loading