Imported from willb335/c-m-h-w (AGENTS.md). Install upstream with npx skills add willb335/c-m-h-w. Copyright stays with the author.

AGENTS.md

Quick Reference

Always run pnpm lint after making changes.

Project Overview

Cardano dApp scaffold using React 18 + TypeScript + Vite. Integrates with the Cardano blockchain via @cardano-sdk/core and @cardano-sdk/crypto.

• Package manager: pnpm
• Module system: ESM ("type": "module")
• TypeScript target: ES2020, strict mode, noUnusedLocals, noUnusedParameters
• JSX: react-jsx transform (no React import needed)

Source Layout

src/
  main.tsx   # Entry point — mounts <App /> into #root
  App.tsx    # Root component

Static assets served from public/. Build output goes to dist/.

Code Conventions

• No comments unless explicitly requested
• React functional components with named function declarations (function App())
• Strict TypeScript — no any, no unused locals/parameters
• ESLint config: @eslint/js recommended + typescript-eslint recommended + react-hooks + react-refresh
• Follow existing patterns in the file you are editing
• Never assume a library is available — check package.json first

Skills

Specialized capabilities loaded from .agents/skills/. Use the appropriate skill when a task matches its trigger condition.

Cardano Integration Notes

• Current dependencies: @cardano-sdk/core (^0.46.12), @cardano-sdk/crypto (^0.4.5)
• Cardano SDK uses Yarn workspaces internally; this project consumes published packages via pnpm
• When adding Cardano functionality, consult the cardano-js-sdk skill for package selection and API guidance
• For wallet connection flows, consult mesh-wallet skill
• For transaction building, consult mesh-transaction skill
• Environment variables (e.g., network URLs, API keys) go in .env.local (git-ignored)

Validation Checklist

Before considering any task complete:

1. pnpm lint passes with no errors
2. pnpm build succeeds (type-check + bundle)
3. No secrets or .env files committed