# AvaKit 🔺

> The open-source, AI-native developer toolkit for Avalanche.

[![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)
[![@avakit/core](https://img.shields.io/npm/v/@avakit/core?label=%40avakit%2Fcore&color=black)](https://www.npmjs.com/package/@avakit/core)
[![@avakit/react](https://img.shields.io/npm/v/@avakit/react?label=%40avakit%2Freact&color=black)](https://www.npmjs.com/package/@avakit/react)
[![license](https://img.shields.io/npm/l/@avakit/core?color=black)](./LICENSE)
[![live on Fuji](https://img.shields.io/badge/live_on-Avalanche_Fuji-black)](https://testnet.snowtrace.io/tx/0x9a1f139577964587ac03123d719f25c0b68024a4c8eab0dc258ad9c925a8e090)
[![watch the demo](https://img.shields.io/badge/▶_watch-90s_demo-e11d48)](https://youtu.be/GeSpcrmIpnc)

Scaffold a social-login dapp, deploy-ready, with agent context baked in. One core, four surfaces. **No seed phrases, no boilerplate.**

**[avakit.dev](https://avakit.dev)** · **[Documentation](https://avakit.dev/docs)** · **[Templates](https://avakit.dev/templates)**

> **▶ [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.

```bash
npm create avalanche-app@latest
```

That's it. Connect with a social login, read your balance, and send your first transaction on Avalanche in minutes.

![Scaffolding an Avalanche dapp with create-avalanche-app](docs/media/scaffold-demo.gif)

**Then deploy an NFT contract and mint it, straight from the browser, on Fuji:**

![Connecting a wallet, deploying an NFT contract, and minting on Avalanche Fuji](docs/media/browser-demo.gif)

> **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.

---

## Why AvaKit

Avalanche'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.

- **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).)
- **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.
- **shadcn/ui, themed**: a clean design system with dark/light from day one. Copy-in components, no vendor lock-in.
- **Deploy-ready**: contracts compile to bundled bytecode, so you can deploy straight from the browser. Fuji testnet by default.
- **Safe defaults**: testnet-first, mainnet is explicit opt-in, secrets stay in env.
- **Wrap, don't rewrite**: built on viem, Web3Auth, and Foundry, packaged for a great DX.

## Packages

| Package | What it is |
| --- | --- |
| [`@avakit/core`](https://www.npmjs.com/package/@avakit/core) | Framework-agnostic kernel: viem clients, wallet adapters, deploy helpers, chain data |
| [`@avakit/react`](https://www.npmjs.com/package/@avakit/react) | `<ConnectAvalanche>` social-login widget, `<TransactionButton>`, and hooks, built on shadcn/ui |
| [`create-avalanche-app`](https://www.npmjs.com/package/create-avalanche-app) | Batteries-included scaffolder (8 templates) |
| [`@avakit/mcp`](https://www.npmjs.com/package/@avakit/mcp) | MCP server: scaffold, deploy, and read Avalanche from Claude Code / Cursor |
| [`@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 |

## Templates

```bash
npm create avalanche-app@latest my-app -- --template nft-mint
```

| Template | What you get |
| --- | --- |
| `minimal` | Social-login wallet, balance, and a first transaction |
| `nft-mint` | Deploy an ERC-721 from the browser, then mint |
| `token-gated-app` | Unlock content for holders of an access-pass NFT |
| `erc20-token` | Deploy an ERC-20, mint supply, and transfer |
| `icm-messenger` | Send a message between two Avalanche L1s over Interchain Messaging, on a one-command local devnet |
| `eerc-token` | Register, mint, and privately transfer tokens with hidden balances (Encrypted ERC) |
| `l1-launch` | Launch your own Avalanche L1 with one command, then explore it in a built-in dashboard |
| `token-bridge` | Bridge an ERC-20 between two Avalanche L1s with Interchain Token Transfer (ICTT) |

Every template ships with a social-login wallet, shadcn/ui (black & white, dark/light), and AI context files.

## Use it in an existing app

```bash
npm install @avakit/react @avakit/core viem
```

```tsx
"use client";
import { injectedAdapter } from "@avakit/core";
import { fuji } from "@avakit/core/chains";
import { AvaKitProvider, ConnectAvalanche } from "@avakit/react";

export function App() {
  return (
    <AvaKitProvider chains={[fuji]} adapters={[injectedAdapter()]}>
      <ConnectAvalanche />
    </AvaKitProvider>
  );
}
```

Add social login by installing `@web3auth/modal` and passing `web3authAdapter({ clientId })` (from `@avakit/core/web3auth`).

> `@avakit/core` and `@avakit/react` are **ESM-only** (use `import`, not `require`; Node ≥ 20.11).

## Build with an AI agent

Add the MCP server to Claude Code, Cursor, or Claude Desktop:

```json
{
  "mcpServers": {
    "avakit": { "command": "npx", "args": ["-y", "@avakit/mcp"] }
  }
}
```

Then just ask: *"Scaffold an nft-mint dapp and deploy it to Fuji."*

## Repository layout

```
packages/
  core/                 @avakit/core
  react/                @avakit/react
  mcp/                  @avakit/mcp
  studio/               @avakit/studio (local dashboard + MCP)
  create-avalanche-app/ scaffolder + 8 templates
apps/web/               the avakit.dev site (EN + TR)
examples/               live demo dapps (hello-avax, web3auth-demo)
docs/                   planning, PRD, architecture, ADRs, specs, security review
```

## Contributing

```bash
pnpm install
pnpm build       # all packages (Turborepo)
pnpm test        # Vitest
pnpm lint        # Biome
pnpm typecheck   # TypeScript
```

Requirements: 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.

## License

[MIT](./LICENSE) © AvaKit contributors

---

<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>