create-avalanche-app 0.1.0

package/templates/nft-mint/components/demo.tsx

@@ -0,0 +1,176 @@
+"use client";
+
+import {
+  Button,
+  ConnectAvalanche,
+  shortenAddress,
+  useAvaAccount,
+  useAvaChain,
+  useAvaDeploy,
+  useContract,
+} from "@avakit/react";
+import { Moon, Sun } from "lucide-react";
+import { useTheme } from "next-themes";
+import { useCallback, useEffect, useState } from "react";
+import type { Address } from "viem";
+import { abi, bytecode } from "@/lib/nft-artifact";
+
+const ZERO = "0x0000000000000000000000000000000000000000" as const;
+
+function ThemeToggle() {
+  const { resolvedTheme, setTheme } = useTheme();
+  return (
+    <Button
+      variant="outline"
+      size="icon"
+      aria-label="Toggle theme"
+      onClick={() => setTheme(resolvedTheme === "dark" ? "light" : "dark")}
+    >
+      <Sun className="hidden size-4 dark:block" />
+      <Moon className="block size-4 dark:hidden" />
+    </Button>
+  );
+}
+
+export function Demo() {
+  const { address, isConnected } = useAvaAccount();
+  const { chain } = useAvaChain();
+  const { deploy, status: deployStatus } = useAvaDeploy();
+
+  const [contractAddress, setContractAddress] = useState<Address | null>(null);
+  const contract = useContract({ address: contractAddress ?? ZERO, abi });
+
+  const [minting, setMinting] = useState(false);
+  const [mintHash, setMintHash] = useState<string | null>(null);
+  const [supply, setSupply] = useState<bigint | null>(null);
+  const [owned, setOwned] = useState<bigint | null>(null);
+  const [error, setError] = useState<string | null>(null);
+
+  const refreshCounts = useCallback(async () => {
+    if (!contractAddress || !address) return;
+    try {
+      const [total, balance] = await Promise.all([
+        contract.read("totalSupply"),
+        contract.read("balanceOf", [address]),
+      ]);
+      setSupply(total as bigint);
+      setOwned(balance as bigint);
+    } catch {
+      // contract not ready yet
+    }
+  }, [contract, contractAddress, address]);
+
+  useEffect(() => {
+    void refreshCounts();
+  }, [refreshCounts]);
+
+  async function handleDeploy() {
+    setError(null);
+    try {
+      const result = await deploy({ abi, bytecode });
+      setContractAddress(result.address);
+    } catch (e) {
+      setError(e instanceof Error ? e.message : String(e));
+    }
+  }
+
+  async function handleMint() {
+    if (!contractAddress) return;
+    setMinting(true);
+    setError(null);
+    setMintHash(null);
+    try {
+      const hash = await contract.write("mint", []);
+      setMintHash(hash);
+      await refreshCounts();
+    } catch (e) {
+      setError(e instanceof Error ? e.message : String(e));
+    } finally {
+      setMinting(false);
+    }
+  }
+
+  return (
+    <div className="mx-auto flex min-h-dvh max-w-xl flex-col gap-8 px-6 py-16">
+      <header className="flex items-center justify-between">
+        <span className="font-mono text-sm font-semibold">__PROJECT_NAME__</span>
+        <div className="flex items-center gap-2">
+          <ConnectAvalanche />
+          <ThemeToggle />
+        </div>
+      </header>
+
+      <div className="flex flex-col gap-2">
+        <h1 className="text-3xl font-semibold tracking-tight">Mint an NFT on Avalanche</h1>
+        <p className="text-muted-foreground text-sm">
+          Deploy the NFT contract from your wallet, then mint — all on {chain.name}. The bytecode is
+          bundled, so no Foundry is needed to run this.
+        </p>
+      </div>
+
+      {!isConnected || !address ? (
+        <div className="text-muted-foreground rounded-xl border border-dashed p-10 text-center text-sm">
+          Connect a wallet to begin.
+        </div>
+      ) : !contractAddress ? (
+        <div className="flex flex-col gap-3 rounded-xl border p-6">
+          <p className="text-sm">Step 1 — deploy your NFT contract.</p>
+          <Button onClick={handleDeploy} disabled={deployStatus === "deploying"}>
+            {deployStatus === "deploying" ? "Deploying…" : "Deploy NFT contract"}
+          </Button>
+          {chain.faucetUrl ? (
+            <a
+              href={chain.faucetUrl}
+              target="_blank"
+              rel="noreferrer"
+              className="text-muted-foreground text-center text-xs underline underline-offset-4"
+            >
+              Need test AVAX? Open the faucet
+            </a>
+          ) : null}
+        </div>
+      ) : (
+        <div className="flex flex-col gap-4 rounded-xl border p-6">
+          <Row label="Contract" value={shortenAddress(contractAddress, 6)} mono />
+          <Row label="Total minted" value={supply === null ? "…" : supply.toString()} mono />
+          <Row label="You own" value={owned === null ? "…" : owned.toString()} mono />
+
+          <Button onClick={handleMint} disabled={minting}>
+            {minting ? "Minting…" : "Mint NFT"}
+          </Button>
+
+          <a
+            href={`${chain.explorerUrl}/address/${contractAddress}`}
+            target="_blank"
+            rel="noreferrer"
+            className="text-muted-foreground text-center text-xs underline underline-offset-4"
+          >
+            View contract on explorer
+          </a>
+
+          {mintHash ? (
+            <a
+              href={`${chain.explorerUrl}/tx/${mintHash}`}
+              target="_blank"
+              rel="noreferrer"
+              className="text-sm break-all underline underline-offset-4"
+            >
+              ✓ Minted: {mintHash}
+            </a>
+          ) : null}
+        </div>
+      )}
+
+      {error ? <p className="text-muted-foreground text-sm">{error}</p> : null}
+    </div>
+  );
+}
+
+function Row({ label, value, mono }: { label: string; value: string; mono?: boolean }) {
+  return (
+    <div className="flex items-center justify-between gap-4">
+      <span className="text-muted-foreground text-sm">{label}</span>
+      <span className={mono ? "font-mono text-sm" : "text-sm"}>{value}</span>
+    </div>
+  );
+}

package/templates/nft-mint/contracts/foundry.toml

@@ -0,0 +1,9 @@
+[profile.default]
+src = "src"
+out = "out"
+libs = ["lib"]
+optimizer = true
+optimizer_runs = 200
+
+[rpc_endpoints]
+fuji = "https://api.avax-test.network/ext/bc/C/rpc"

package/templates/nft-mint/contracts/src/AvaKitNFT.sol

@@ -0,0 +1,57 @@
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.20;
+
+/// @title AvaKitNFT
+/// @notice A minimal, self-contained ERC-721 mint demo (no external deps so it
+///         compiles out of the box with `forge build`). Public mint, on-chain
+///         metadata. Not a full ERC-721 (no transfer/approve) — it's a starting
+///         point you can extend.
+contract AvaKitNFT {
+    string public constant name = "AvaKit NFT";
+    string public constant symbol = "AVAKIT";
+
+    uint256 public totalSupply;
+    mapping(uint256 => address) public ownerOf;
+    mapping(address => uint256) public balanceOf;
+
+    event Transfer(address indexed from, address indexed to, uint256 indexed tokenId);
+
+    /// @notice Mint the next token to the caller.
+    function mint() external returns (uint256 tokenId) {
+        tokenId = ++totalSupply;
+        ownerOf[tokenId] = msg.sender;
+        unchecked {
+            balanceOf[msg.sender] += 1;
+        }
+        emit Transfer(address(0), msg.sender, tokenId);
+    }
+
+    /// @notice Minimal on-chain metadata.
+    function tokenURI(uint256 tokenId) external pure returns (string memory) {
+        return string.concat(
+            'data:application/json;utf8,{"name":"AvaKit #', _toString(tokenId), '"}'
+        );
+    }
+
+    /// @notice ERC-165: advertises ERC-721 + ERC-165 interface ids.
+    function supportsInterface(bytes4 interfaceId) external pure returns (bool) {
+        return interfaceId == 0x80ac58cd || interfaceId == 0x01ffc9a7;
+    }
+
+    function _toString(uint256 value) internal pure returns (string memory) {
+        if (value == 0) return "0";
+        uint256 temp = value;
+        uint256 digits;
+        while (temp != 0) {
+            digits++;
+            temp /= 10;
+        }
+        bytes memory buffer = new bytes(digits);
+        while (value != 0) {
+            digits -= 1;
+            buffer[digits] = bytes1(uint8(48 + uint256(value % 10)));
+            value /= 10;
+        }
+        return string(buffer);
+    }
+}

package/templates/nft-mint/cursor/rules/avakit.mdc

@@ -0,0 +1,32 @@
+---
+description: AvaKit + Avalanche NFT conventions for this project
+globs: ["**/*.ts", "**/*.tsx", "**/*.sol", "**/*.css"]
+alwaysApply: true
+---
+
+# AvaKit NFT project rules
+
+This is an Avalanche NFT dapp built with AvaKit. It deploys an ERC-721 from the browser, then mints.
+
+## Flow
+
+- Deploy: `useAvaDeploy().deploy({ abi, bytecode })` (artifact in `lib/nft-artifact.ts`).
+- Mint: `useContract({ address, abi }).write("mint", [])`.
+- Read: `.read("totalSupply")`, `.read("balanceOf", [address])`.
+
+## Contract
+
+- Source: `contracts/src/AvaKitNFT.sol` (minimal, self-contained ERC-721 — no external deps).
+- After editing, recompile: `cd contracts && forge build`, then update `lib/nft-artifact.ts` with the new abi + bytecode.object.
+
+## UI
+
+- shadcn/ui only; `@avakit/react` components are shadcn-styled.
+- Black & white only for now; dark/light via next-themes; both must work.
+- Animations: Framer Motion or GSAP only.
+
+## Safety
+
+- Deploying and minting cost gas — fund the wallet on Fuji first.
+- Default chain is Fuji testnet; mainnet requires explicit opt-in.
+- Never hardcode secrets; keys stay in the wallet provider.

package/templates/nft-mint/env.example

@@ -0,0 +1,4 @@
+# Web3Auth (MetaMask Embedded Wallets) — free client ID for social login.
+# Get one at https://dashboard.web3auth.io (Sapphire Devnet, EVM).
+# Public value, safe to expose. Leave empty to use only the browser wallet.
+NEXT_PUBLIC_WEB3AUTH_CLIENT_ID=

package/templates/nft-mint/gitignore

@@ -0,0 +1,15 @@
+node_modules/
+.next/
+out/
+*.tsbuildinfo
+next-env.d.ts
+.env
+.env.*
+!.env.example
+.DS_Store
+*.log
+
+# Foundry
+contracts/out/
+contracts/cache/
+contracts/broadcast/

package/templates/nft-mint/lib/nft-artifact.ts

@@ -0,0 +1,164 @@
+// Auto-generated from contracts/src/AvaKitNFT.sol via `forge build`.
+// Re-generate after editing the contract: cd contracts && forge build, then
+// copy abi + bytecode.object here. Lets the app deploy from the browser with
+// no Foundry required at runtime.
+
+import type { Abi, Hex } from "viem";
+
+export const abi = [
+  {
+    "type": "function",
+    "name": "balanceOf",
+    "inputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "mint",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "tokenId",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "nonpayable"
+  },
+  {
+    "type": "function",
+    "name": "name",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "string",
+        "internalType": "string"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "ownerOf",
+    "inputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "address",
+        "internalType": "address"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "supportsInterface",
+    "inputs": [
+      {
+        "name": "interfaceId",
+        "type": "bytes4",
+        "internalType": "bytes4"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "bool",
+        "internalType": "bool"
+      }
+    ],
+    "stateMutability": "pure"
+  },
+  {
+    "type": "function",
+    "name": "symbol",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "string",
+        "internalType": "string"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "function",
+    "name": "tokenURI",
+    "inputs": [
+      {
+        "name": "tokenId",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "outputs": [
+      {
+        "name": "",
+        "type": "string",
+        "internalType": "string"
+      }
+    ],
+    "stateMutability": "pure"
+  },
+  {
+    "type": "function",
+    "name": "totalSupply",
+    "inputs": [],
+    "outputs": [
+      {
+        "name": "",
+        "type": "uint256",
+        "internalType": "uint256"
+      }
+    ],
+    "stateMutability": "view"
+  },
+  {
+    "type": "event",
+    "name": "Transfer",
+    "inputs": [
+      {
+        "name": "from",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "to",
+        "type": "address",
+        "indexed": true,
+        "internalType": "address"
+      },
+      {
+        "name": "tokenId",
+        "type": "uint256",
+        "indexed": true,
+        "internalType": "uint256"
+      }
+    ],
+    "anonymous": false
+  }
+] as const satisfies Abi;
+
+export const bytecode = "0x6080604052348015600e575f5ffd5b5061056b8061001c5f395ff3fe608060405234801561000f575f5ffd5b5060043610610085575f3560e01c80636352211e116100585780636352211e1461010557806370a082311461014557806395d89b4114610164578063c87b56dd14610189575f5ffd5b806301ffc9a71461008957806306fdde03146100b15780631249c58b146100e757806318160ddd146100fd575b5f5ffd5b61009c610097366004610383565b61019c565b60405190151581526020015b60405180910390f35b6100da6040518060400160405280600a815260200169105d9852da5d0813919560b21b81525081565b6040516100a891906103b1565b6100ef6101d2565b6040519081526020016100a8565b6100ef5f5481565b61012d6101133660046103e6565b60016020525f90815260409020546001600160a01b031681565b6040516001600160a01b0390911681526020016100a8565b6100ef6101533660046103fd565b60026020525f908152604090205481565b6100da6040518060400160405280600681526020016510559052d25560d21b81525081565b6100da6101973660046103e6565b61024d565b5f6380ac58cd60e01b6001600160e01b0319831614806101cc57506301ffc9a760e01b6001600160e01b03198316145b92915050565b5f5f5f81546101e090610437565b91829055505f81815260016020818152604080842080546001600160a01b0319163390811790915580855260029092528084208054909301909255905192935083929091907fddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef908290a490565b60606102588261027e565b604051602001610268919061044f565b6040516020818303038152906040529050919050565b6060815f036102a45750506040805180820190915260018152600360fc1b602082015290565b815f5b81156102cd57806102b781610437565b91506102c69050600a836104c1565b91506102a7565b5f8167ffffffffffffffff8111156102e7576102e76104d4565b6040519080825280601f01601f191660200182016040528015610311576020820181803683370190505b5090505b841561037b576103266001836104e8565b9150610333600a866104fb565b61033e90603061050e565b60f81b81838151811061035357610353610521565b60200101906001600160f81b03191690815f1a905350610374600a866104c1565b9450610315565b949350505050565b5f60208284031215610393575f5ffd5b81356001600160e01b0319811681146103aa575f5ffd5b9392505050565b602081525f82518060208401528060208501604085015e5f604082850101526040601f19601f83011684010191505092915050565b5f602082840312156103f6575f5ffd5b5035919050565b5f6020828403121561040d575f5ffd5b81356001600160a01b03811681146103aa575f5ffd5b634e487b7160e01b5f52601160045260245ffd5b5f6001820161044857610448610423565b5060010190565b7f646174613a6170706c69636174696f6e2f6a736f6e3b757466382c7b226e616d81526b65223a224176614b6974202360a01b60208201525f82518060208501602c85015e61227d60f01b602c939091019283015250602e01919050565b634e487b7160e01b5f52601260045260245ffd5b5f826104cf576104cf6104ad565b500490565b634e487b7160e01b5f52604160045260245ffd5b818103818111156101cc576101cc610423565b5f82610509576105096104ad565b500690565b808201808211156101cc576101cc610423565b634e487b7160e01b5f52603260045260245ffdfea2646970667358221220636aeafda61f36794e1b5b3ea1a8dfe71613339168fec5fb9f9f3cb22f2abc9464736f6c634300081c0033" as Hex;

package/templates/nft-mint/llms.txt

@@ -0,0 +1,31 @@
+# __PROJECT_NAME__
+
+> An Avalanche NFT dapp scaffolded with AvaKit. Deploy an ERC-721 from the browser, then mint. Next.js + @avakit/react + shadcn/ui + Foundry.
+
+## Project map
+
+- [contracts/src/AvaKitNFT.sol](contracts/src/AvaKitNFT.sol): minimal self-contained ERC-721 mint contract.
+- [lib/nft-artifact.ts](lib/nft-artifact.ts): compiled ABI + bytecode (browser deploy, no Foundry at runtime).
+- [components/demo.tsx](components/demo.tsx): deploy + mint flow.
+- [app/providers.tsx](app/providers.tsx): AvaKitProvider (chains + wallet adapters) + theme.
+- [CLAUDE.md](CLAUDE.md): agent guide (AvaKit API, contract workflow, rules).
+
+## Key APIs
+
+- Deploy: `useAvaDeploy().deploy({ abi, bytecode })`
+- Contract: `useContract({ address, abi }).write("mint", [])` / `.read("totalSupply")`
+- Wallet: `<ConnectAvalanche />`, `useAvaAccount()`, `useAvaChain()`
+- Core: `deployContract`, `getWalletClient`, `ensureChain` from `@avakit/core`
+
+## Recompile the contract
+
+```
+cd contracts && forge build
+```
+Then copy abi + bytecode.object from `out/AvaKitNFT.sol/AvaKitNFT.json` into `lib/nft-artifact.ts`.
+
+## External docs
+
+- Avalanche Builder Hub: https://build.avax.network/llms.txt
+- Foundry book: https://book.getfoundry.sh
+- Fuji faucet: https://core.app/tools/testnet-faucet

package/templates/nft-mint/manifest.json

@@ -0,0 +1,6 @@
+{
+  "id": "nft-mint",
+  "title": "NFT mint",
+  "description": "Deploy an NFT contract from the browser, then mint",
+  "contracts": true
+}

package/templates/nft-mint/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  reactStrictMode: true,
+};
+
+export default nextConfig;

package/templates/nft-mint/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "__PROJECT_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@avakit/core": "__AVAKIT_DEP__",
+    "@avakit/react": "__AVAKIT_DEP__",
+    "lucide-react": "1.22.0",
+    "next": "16.2.9",
+    "next-themes": "0.4.6",
+    "react": "19.2.7",
+    "react-dom": "19.2.7",
+    "viem": "2.54.1"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "4.3.2",
+    "@types/node": "26.0.1",
+    "@types/react": "19.2.17",
+    "@types/react-dom": "19.2.3",
+    "postcss": "8.5.16",
+    "tailwindcss": "4.3.2",
+    "tw-animate-css": "1.4.0",
+    "typescript": "6.0.3"
+  }
+}

package/templates/nft-mint/postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

package/templates/nft-mint/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/templates/token-gated-app/CLAUDE.md

@@ -0,0 +1,45 @@
+# __PROJECT_NAME__ — Token-gated Avalanche dapp (scaffolded with AvaKit)
+
+Operational guide for AI agents (Claude Code / Cursor).
+
+## Stack
+
+Next.js 16 (App Router) · React 19 · `@avakit/react` · `@avakit/core` · viem · shadcn/ui · next-themes · Foundry (access-pass contract)
+
+## Idea
+
+Content is gated behind ownership of an **access-pass NFT**. If `balanceOf(address) > 0`, the gated section renders; otherwise it stays locked with a mint button.
+
+## Architecture
+
+- `contracts/src/AvaKitNFT.sol` — the access-pass ERC-721 (minimal, self-contained).
+- `lib/nft-artifact.ts` — compiled ABI + bytecode (browser deploy, no Foundry at runtime).
+- `components/demo.tsx` — deploy pass → mint → gate logic.
+- `app/providers.tsx` — `<AvaKitProvider>` + `ThemeProvider`.
+
+## The gate
+
+```ts
+const contract = useContract({ address, abi });
+const balance = (await contract.read("balanceOf", [address])) as bigint;
+const hasAccess = balance > 0n; // render gated content only when true
+```
+
+- Deploy: `useAvaDeploy().deploy({ abi, bytecode })`
+- Mint a pass: `contract.write("mint", [])`
+
+To gate on a different token (e.g. an existing ERC-20 or NFT), point `useContract` at that address/ABI and adjust the `hasAccess` check (e.g. balance ≥ threshold).
+
+## Rules
+
+- shadcn/ui only; `@avakit/react` components are shadcn-styled.
+- Black & white only for now; dark/light via next-themes; both must work.
+- Animations: Framer Motion or GSAP only.
+- Deploying/minting costs gas — fund the wallet on Fuji first.
+- Never gate sensitive data purely client-side: the gated content here is illustrative. For real secrets, verify ownership server-side (e.g. sign-in-with-Ethereum + an API check).
+- Social login needs `NEXT_PUBLIC_WEB3AUTH_CLIENT_ID` in `.env.local`.
+
+## Commands
+
+- `pnpm dev` — dev server
+- `cd contracts && forge build` — recompile the access-pass contract

package/templates/token-gated-app/README.md

@@ -0,0 +1,38 @@
+# __PROJECT_NAME__
+
+A **token-gated** Avalanche dapp scaffolded with [AvaKit](https://github.com/mericcintosun/AvaKit). Content unlocks for holders of an access-pass NFT — no Foundry required to run it.
+
+## Getting started
+
+```bash
+# 1. (social login, optional) add a free Web3Auth client ID
+cp .env.example .env.local
+#    → https://dashboard.web3auth.io (Sapphire Devnet, EVM)
+
+# 2. run it
+pnpm dev    # http://localhost:3000
+```
+
+Then: connect a wallet → **Deploy access-pass contract** → **Mint access pass** → the gated content unlocks. Deploying and minting cost gas, so fund your wallet on Fuji first (in-app faucet link).
+
+## How the gate works
+
+The gated section renders only when `balanceOf(address) > 0`:
+
+```ts
+const balance = (await useContract({ address, abi }).read("balanceOf", [address])) as bigint;
+const hasAccess = balance > 0n;
+```
+
+- `contracts/src/AvaKitNFT.sol` — the access-pass ERC-721 (self-contained).
+- `lib/nft-artifact.ts` — compiled ABI + bytecode, bundled for browser deploy.
+
+> **Security:** client-side gating is illustrative. For real protected content, verify ownership server-side (e.g. Sign-In with Ethereum + an API check).
+
+## Stack
+
+Next.js 16 · `@avakit/react` · `@avakit/core` · viem · shadcn/ui · Foundry
+
+## AI-native
+
+Ships with `CLAUDE.md`, `llms.txt`, and `.cursor/rules` so Claude Code / Cursor understand the gate pattern and project conventions.