{
  "markdown": "# AvaKit 🔺\n\n> The open-source, AI-native developer toolkit for Avalanche.\n\n[![create-avalanche-app](https://img.shields.io/npm/v/create-avalanche-app?label=create-avalanche-app&color=black)](https://www.npmjs.com/package/create-avalanche-app)\n[![@avakit/core](https://img.shields.io/npm/v/@avakit/core?label=%40avakit%2Fcore&color=black)](https://www.npmjs.com/package/@avakit/core)\n[![@avakit/react](https://img.shields.io/npm/v/@avakit/react?label=%40avakit%2Freact&color=black)](https://www.npmjs.com/package/@avakit/react)\n[![license](https://img.shields.io/npm/l/@avakit/core?color=black)](./LICENSE)\n[![live on Fuji](https://img.shields.io/badge/live_on-Avalanche_Fuji-black)](https://testnet.snowtrace.io/tx/0x9a1f139577964587ac03123d719f25c0b68024a4c8eab0dc258ad9c925a8e090)\n[![watch the demo](https://img.shields.io/badge/▶_watch-90s_demo-e11d48)](https://youtu.be/GeSpcrmIpnc)\n\nScaffold a social-login dapp, deploy-ready, with agent context baked in. One core, four surfaces. **No seed phrases, no boilerplate.**\n\n**[avakit.dev](https://avakit.dev)** · **[Documentation](https://avakit.dev/docs)** · **[Templates](https://avakit.dev/templates)**\n\n> **▶ [Watch the 90-second demo](https://youtu.be/GeSpcrmIpnc)** — one command to a live, social-login Avalanche dapp: sign in with Google, deploy an NFT from the browser, and mint it on Fuji.\n\n```bash\nnpm create avalanche-app@latest\n```\n\nThat's it. Connect with a social login, read your balance, and send your first transaction on Avalanche in minutes.\n\n![Scaffolding an Avalanche dapp with create-avalanche-app](docs/media/scaffold-demo.gif)\n\n**Then deploy an NFT contract and mint it, straight from the browser, on Fuji:**\n\n![Connecting a wallet, deploying an NFT contract, and minting on Avalanche Fuji](docs/media/browser-demo.gif)\n\n> **Proven live on Fuji.** The mint in that clip is a real on-chain transaction; [view it on Snowtrace](https://testnet.snowtrace.io/tx/0x9a1f139577964587ac03123d719f25c0b68024a4c8eab0dc258ad9c925a8e090) (contract [`0x7612…7786`](https://testnet.snowtrace.io/address/0x7612e031216250384ebdb151553a0c5b89b87786)). No Foundry, no backend: the bytecode is bundled and deployed from the user's wallet.\n\n---\n\n## Why AvaKit\n\nAvalanche's C-Chain is EVM-compatible and end-user onboarding is already solved (Core wallet's seedless social login). The remaining friction is on the **developer** side: spinning up a modern dapp with onboarding wired up still takes hours. AvaKit removes that.\n\n- **Zero-setup onboarding**: a temporary in-browser wallet appears so a newcomer can try a real Fuji transaction with nothing installed, and social login (Google, no seed phrase) or Core/MetaMask is the upgrade — for those, keys stay in the provider's HSM and AvaKit never touches them. (The burner is the exception, and holds its key in `localStorage` — see [SECURITY.md](SECURITY.md).)\n- **AI-native by default**: every generated app ships `CLAUDE.md`, `llms.txt`, and `.cursor/rules`, and `@avakit/mcp` lets Claude Code / Cursor scaffold, deploy, and read chain state for you.\n- **shadcn/ui, themed**: a clean design system with dark/light from day one. Copy-in components, no vendor lock-in.\n- **Deploy-ready**: contracts compile to bundled bytecode, so you can deploy straight from the browser. Fuji testnet by default.\n- **Safe defaults**: testnet-first, mainnet is explicit opt-in, secrets stay in env.\n- **Wrap, don't rewrite**: built on viem, Web3Auth, and Foundry, packaged for a great DX.\n\n## Packages\n\n| Package | What it is |\n| --- | --- |\n| [`@avakit/core`](https://www.npmjs.com/package/@avakit/core) | Framework-agnostic kernel: viem clients, wallet adapters, deploy helpers, chain data |\n| [`@avakit/react`](https://www.npmjs.com/package/@avakit/react) | `<ConnectAvalanche>` social-login widget, `<TransactionButton>`, and hooks, built on shadcn/ui |\n| [`create-avalanche-app`](https://www.npmjs.com/package/create-avalanche-app) | Batteries-included scaffolder (8 templates) |\n| [`@avakit/mcp`](https://www.npmjs.com/package/@avakit/mcp) | MCP server: scaffold, deploy, and read Avalanche from Claude Code / Cursor |\n| [`@avakit/studio`](https://www.npmjs.com/package/@avakit/studio) | Local dev dashboard: spin up devnets, send Interchain messages, inspect data (`npx @avakit/studio`); also an MCP server |\n\n## Templates\n\n```bash\nnpm create avalanche-app@latest my-app -- --template nft-mint\n```\n\n| Template | What you get |\n| --- | --- |\n| `minimal` | Social-login wallet, balance, and a first transaction |\n| `nft-mint` | Deploy an ERC-721 from the browser, then mint |\n| `token-gated-app` | Unlock content for holders of an access-pass NFT |\n| `erc20-token` | Deploy an ERC-20, mint supply, and transfer |\n| `icm-messenger` | Send a message between two Avalanche L1s over Interchain Messaging, on a one-command local devnet |\n| `eerc-token` | Register, mint, and privately transfer tokens with hidden balances (Encrypted ERC) |\n| `l1-launch` | Launch your own Avalanche L1 with one command, then explore it in a built-in dashboard |\n| `token-bridge` | Bridge an ERC-20 between two Avalanche L1s with Interchain Token Transfer (ICTT) |\n\nEvery template ships with a social-login wallet, shadcn/ui (black & white, dark/light), and AI context files.\n\n## Use it in an existing app\n\n```bash\nnpm install @avakit/react @avakit/core viem\n```\n\n```tsx\n\"use client\";\nimport { injectedAdapter } from \"@avakit/core\";\nimport { fuji } from \"@avakit/core/chains\";\nimport { AvaKitProvider, ConnectAvalanche } from \"@avakit/react\";\n\nexport function App() {\n  return (\n    <AvaKitProvider chains={[fuji]} adapters={[injectedAdapter()]}>\n      <ConnectAvalanche />\n    </AvaKitProvider>\n  );\n}\n```\n\nAdd social login by installing `@web3auth/modal` and passing `web3authAdapter({ clientId })` (from `@avakit/core/web3auth`).\n\n> `@avakit/core` and `@avakit/react` are **ESM-only** (use `import`, not `require`; Node ≥ 20.11).\n\n## Build with an AI agent\n\nAdd the MCP server to Claude Code, Cursor, or Claude Desktop:\n\n```json\n{\n  \"mcpServers\": {\n    \"avakit\": { \"command\": \"npx\", \"args\": [\"-y\", \"@avakit/mcp\"] }\n  }\n}\n```\n\nThen just ask: *\"Scaffold an nft-mint dapp and deploy it to Fuji.\"*\n\n## Repository layout\n\n```\npackages/\n  core/                 @avakit/core\n  react/                @avakit/react\n  mcp/                  @avakit/mcp\n  studio/               @avakit/studio (local dashboard + MCP)\n  create-avalanche-app/ scaffolder + 8 templates\napps/web/               the avakit.dev site (EN + TR)\nexamples/               live demo dapps (hello-avax, web3auth-demo)\ndocs/                   planning, PRD, architecture, ADRs, specs, security review\n```\n\n## Contributing\n\n```bash\npnpm install\npnpm build       # all packages (Turborepo)\npnpm test        # Vitest\npnpm lint        # Biome\npnpm typecheck   # TypeScript\n```\n\nRequirements: Node ≥ 20.11, pnpm ≥ 10. See [`CONTRIBUTING.md`](./CONTRIBUTING.md) and the design docs in [`docs/`](./docs). Conventions: English everywhere, shadcn/ui only, Framer Motion / GSAP for animation, latest stable versions.\n\n## License\n\n[MIT](./LICENSE) © AvaKit contributors\n\n---\n\n<sub>Built on [viem](https://viem.sh), [Web3Auth](https://web3auth.io), [Foundry](https://getfoundry.sh), and [shadcn/ui](https://ui.shadcn.com). Testnet-first (Fuji); mainnet is opt-in.</sub>\n",
  "bytes": 7291,
  "sha": "60d310cce62f76532ba145e12da4895b13d1815e6cdd31f46adebe3f00301cd0",
  "repo_slug": "mericcintosun/avakit",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_dev_avakit_avalanche_4204b69c/readme"
}