create-avalanche-app 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AvaKit contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# create-avalanche-app
+
+Scaffold a batteries-included [AvaKit](https://github.com/mericcintosun/AvaKit) Avalanche dapp: social-login onboarding, deploy-ready, and AI-native.
+
+## Usage
+
+```bash
+npm create avalanche-app@latest
+# or
+npm create avalanche-app@latest my-app -- --template nft-mint --yes
+```
+
+Then:
+
+```bash
+cd my-app
+pnpm install
+cp .env.example .env.local   # add a free Web3Auth client ID for social login
+pnpm dev                     # http://localhost:3000
+```
+
+## Templates
+
+| Template | What you get |
+| --- | --- |
+| `minimal` | Social-login wallet, balance, and a first transaction |
+| `nft-mint` | Deploy an NFT contract from the browser, then mint |
+| `token-gated-app` | Unlock content for holders of an access-pass NFT |
+
+Every generated app ships **shadcn/ui** (black & white with dark/light from day one), a social-login wallet via `@avakit/react`, and AI context files (`CLAUDE.md`, `llms.txt`, `.cursor/rules`) so Claude Code / Cursor understand the project out of the box.
+
+## Options
+
+```
+-t, --template <id>     minimal | nft-mint | token-gated-app
+-w, --wallet <id>       web3auth | injected      (default: web3auth)
+-c, --chain <id>        fuji | c-chain           (default: fuji)
+    --pm <manager>      pnpm | npm | yarn | bun
+-y, --yes               skip prompts (non-interactive)
+    --no-install        do not install dependencies
+```
+
+MIT © AvaKit contributors

package/dist/api.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Programmatic API for the scaffolder — used by the CLI (src/index.ts) and by
+ * @avakit/mcp's `scaffold_app` tool. Keeps template resolution and placeholder
+ * replacement in one place.
+ */
+declare const templatesDir: string;
+interface TemplateInfo {
+    id: string;
+    title: string;
+    description: string;
+    contracts: boolean;
+}
+declare function listTemplates(): TemplateInfo[];
+type WalletId = "web3auth" | "injected";
+type ChainId = "fuji" | "c-chain";
+interface ScaffoldAppOptions {
+    projectName: string;
+    /** Absolute target directory. */
+    targetDir: string;
+    template: string;
+    wallet?: WalletId;
+    chain?: ChainId;
+    /** Link @avakit/* via workspace instead of npm versions (repo dev only). */
+    local?: boolean;
+    /** @avakit version range used when not linking locally. */
+    avakitVersion?: string;
+}
+interface ScaffoldAppResult {
+    targetDir: string;
+    files: string[];
+}
+declare function scaffoldApp(opts: ScaffoldAppOptions): Promise<ScaffoldAppResult>;
+
+export { type ChainId, type ScaffoldAppOptions, type ScaffoldAppResult, type TemplateInfo, type WalletId, listTemplates, scaffoldApp, templatesDir };

package/dist/api.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import {
+  listTemplates,
+  scaffoldApp,
+  templatesDir
+} from "./chunk-3YGRLI4R.js";
+export {
+  listTemplates,
+  scaffoldApp,
+  templatesDir
+};
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-3YGRLI4R.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+
+// src/api.ts
+import { existsSync, readdirSync, readFileSync } from "fs";
+import path2 from "path";
+import { fileURLToPath } from "url";
+
+// src/scaffold.ts
+import { mkdir, readdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+var RENAME_SEGMENT = {
+  gitignore: ".gitignore",
+  "env.example": ".env.example",
+  cursor: ".cursor"
+};
+var TEMPLATE_ONLY = /* @__PURE__ */ new Set(["manifest.json"]);
+async function walk(dir) {
+  const entries = await readdir(dir, { withFileTypes: true });
+  const files = await Promise.all(
+    entries.map((entry) => {
+      const full = path.join(dir, entry.name);
+      return entry.isDirectory() ? walk(full) : Promise.resolve([full]);
+    })
+  );
+  return files.flat();
+}
+async function scaffold({
+  templateDir,
+  targetDir,
+  replacements
+}) {
+  const files = await walk(templateDir);
+  const written = [];
+  for (const abs of files) {
+    const rel = path.relative(templateDir, abs);
+    if (TEMPLATE_ONLY.has(rel)) {
+      continue;
+    }
+    const outRel = rel.split(path.sep).map((segment) => RENAME_SEGMENT[segment] ?? segment).join(path.sep);
+    const outPath = path.join(targetDir, outRel);
+    await mkdir(path.dirname(outPath), { recursive: true });
+    let content = await readFile(abs, "utf8");
+    for (const [token, value] of Object.entries(replacements)) {
+      content = content.split(token).join(value);
+    }
+    await writeFile(outPath, content);
+    written.push(outRel);
+  }
+  return written;
+}
+
+// src/api.ts
+var templatesDir = path2.join(
+  path2.dirname(fileURLToPath(import.meta.url)),
+  "..",
+  "templates"
+);
+function listTemplates() {
+  return readdirSync(templatesDir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => {
+    const manifestPath = path2.join(templatesDir, e.name, "manifest.json");
+    const manifest = existsSync(manifestPath) ? JSON.parse(readFileSync(manifestPath, "utf8")) : {};
+    return {
+      id: e.name,
+      title: manifest.title ?? e.name,
+      description: manifest.description ?? "",
+      contracts: manifest.contracts ?? false
+    };
+  });
+}
+async function scaffoldApp(opts) {
+  const templateDir = path2.join(templatesDir, opts.template);
+  if (!existsSync(templateDir)) {
+    throw new Error(
+      `Unknown template "${opts.template}". Available: ${listTemplates().map((t) => t.id).join(", ")}`
+    );
+  }
+  const replacements = {
+    __PROJECT_NAME__: opts.projectName,
+    __CHAIN_CONST__: opts.chain === "c-chain" ? "cChain" : "fuji",
+    __AVAKIT_DEP__: opts.local ? "workspace:*" : `^${opts.avakitVersion ?? "0.1.0"}`
+  };
+  const files = await scaffold({ templateDir, targetDir: opts.targetDir, replacements });
+  return { targetDir: opts.targetDir, files };
+}
+
+export {
+  templatesDir,
+  listTemplates,
+  scaffoldApp
+};
+//# sourceMappingURL=chunk-3YGRLI4R.js.map

package/dist/chunk-3YGRLI4R.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api.ts","../src/scaffold.ts"],"sourcesContent":["/**\n * Programmatic API for the scaffolder — used by the CLI (src/index.ts) and by\n * @avakit/mcp's `scaffold_app` tool. Keeps template resolution and placeholder\n * replacement in one place.\n */\n\nimport { existsSync, readdirSync, readFileSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { scaffold } from \"./scaffold.js\";\n\nexport const templatesDir = path.join(\n  path.dirname(fileURLToPath(import.meta.url)),\n  \"..\",\n  \"templates\",\n);\n\nexport interface TemplateInfo {\n  id: string;\n  title: string;\n  description: string;\n  contracts: boolean;\n}\n\nexport function listTemplates(): TemplateInfo[] {\n  return readdirSync(templatesDir, { withFileTypes: true })\n    .filter((e) => e.isDirectory())\n    .map((e) => {\n      const manifestPath = path.join(templatesDir, e.name, \"manifest.json\");\n      const manifest = existsSync(manifestPath)\n        ? (JSON.parse(readFileSync(manifestPath, \"utf8\")) as Partial<TemplateInfo>)\n        : {};\n      return {\n        id: e.name,\n        title: manifest.title ?? e.name,\n        description: manifest.description ?? \"\",\n        contracts: manifest.contracts ?? false,\n      };\n    });\n}\n\nexport type WalletId = \"web3auth\" | \"injected\";\nexport type ChainId = \"fuji\" | \"c-chain\";\n\nexport interface ScaffoldAppOptions {\n  projectName: string;\n  /** Absolute target directory. */\n  targetDir: string;\n  template: string;\n  wallet?: WalletId;\n  chain?: ChainId;\n  /** Link @avakit/* via workspace instead of npm versions (repo dev only). */\n  local?: boolean;\n  /** @avakit version range used when not linking locally. */\n  avakitVersion?: string;\n}\n\nexport interface ScaffoldAppResult {\n  targetDir: string;\n  files: string[];\n}\n\nexport async function scaffoldApp(opts: ScaffoldAppOptions): Promise<ScaffoldAppResult> {\n  const templateDir = path.join(templatesDir, opts.template);\n  if (!existsSync(templateDir)) {\n    throw new Error(\n      `Unknown template \"${opts.template}\". Available: ${listTemplates()\n        .map((t) => t.id)\n        .join(\", \")}`,\n    );\n  }\n\n  const replacements: Record<string, string> = {\n    __PROJECT_NAME__: opts.projectName,\n    __CHAIN_CONST__: opts.chain === \"c-chain\" ? \"cChain\" : \"fuji\",\n    __AVAKIT_DEP__: opts.local ? \"workspace:*\" : `^${opts.avakitVersion ?? \"0.1.0\"}`,\n  };\n\n  const files = await scaffold({ templateDir, targetDir: opts.targetDir, replacements });\n  return { targetDir: opts.targetDir, files };\n}\n","import { mkdir, readdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\n/**\n * Template files are stored with dot-prefixes stripped so they ship cleanly in\n * an npm package (npm refuses to publish a literal `.gitignore`, etc.). On\n * scaffold we restore the leading dot per path segment.\n */\nconst RENAME_SEGMENT: Record<string, string> = {\n  gitignore: \".gitignore\",\n  \"env.example\": \".env.example\",\n  cursor: \".cursor\",\n};\n\n/** Template-only files that must NOT be copied into the generated project. */\nconst TEMPLATE_ONLY = new Set([\"manifest.json\"]);\n\nexport interface ScaffoldOptions {\n  templateDir: string;\n  targetDir: string;\n  /** Literal placeholder → value, applied to every text file's contents. */\n  replacements: Record<string, string>;\n}\n\nasync function walk(dir: string): Promise<string[]> {\n  const entries = await readdir(dir, { withFileTypes: true });\n  const files = await Promise.all(\n    entries.map((entry) => {\n      const full = path.join(dir, entry.name);\n      return entry.isDirectory() ? walk(full) : Promise.resolve([full]);\n    }),\n  );\n  return files.flat();\n}\n\n/** Copy a template into targetDir, renaming dot-files and replacing placeholders. */\nexport async function scaffold({\n  templateDir,\n  targetDir,\n  replacements,\n}: ScaffoldOptions): Promise<string[]> {\n  const files = await walk(templateDir);\n  const written: string[] = [];\n\n  for (const abs of files) {\n    const rel = path.relative(templateDir, abs);\n    if (TEMPLATE_ONLY.has(rel)) {\n      continue;\n    }\n    const outRel = rel\n      .split(path.sep)\n      .map((segment) => RENAME_SEGMENT[segment] ?? segment)\n      .join(path.sep);\n    const outPath = path.join(targetDir, outRel);\n\n    await mkdir(path.dirname(outPath), { recursive: true });\n\n    let content = await readFile(abs, \"utf8\");\n    for (const [token, value] of Object.entries(replacements)) {\n      content = content.split(token).join(value);\n    }\n    await writeFile(outPath, content);\n    written.push(outRel);\n  }\n\n  return written;\n}\n"],"mappings":"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","names":["path","path"]}

package/dist/index.js

@@ -0,0 +1,213 @@
+#!/usr/bin/env node
+import {
+  listTemplates,
+  scaffoldApp
+} from "./chunk-3YGRLI4R.js";
+
+// src/index.ts
+import { spawnSync } from "child_process";
+import { existsSync, readdirSync } from "fs";
+import path from "path";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+var VERSION = "0.1.0";
+function parseArgs(argv) {
+  const opts = { yes: false, local: false, install: true };
+  const rest = argv.slice(2);
+  for (let i = 0; i < rest.length; i++) {
+    const arg = rest[i];
+    const next = () => rest[++i];
+    switch (arg) {
+      case "--yes":
+      case "-y":
+        opts.yes = true;
+        break;
+      case "--local":
+        opts.local = true;
+        break;
+      case "--no-install":
+        opts.install = false;
+        break;
+      case "--template":
+      case "-t":
+        opts.template = next();
+        break;
+      case "--wallet":
+      case "-w":
+        opts.wallet = next();
+        break;
+      case "--chain":
+      case "-c":
+        opts.chain = next();
+        break;
+      case "--pm":
+        opts.pm = next();
+        break;
+      case "--version":
+      case "-v":
+        process.stdout.write(`${VERSION}
+`);
+        process.exit(0);
+        break;
+      case "--help":
+      case "-h":
+        printHelp();
+        process.exit(0);
+        break;
+      default:
+        if (arg && !arg.startsWith("-") && !opts.projectName) {
+          opts.projectName = arg;
+        }
+    }
+  }
+  return opts;
+}
+function printHelp() {
+  process.stdout.write(
+    [
+      "create-avalanche-app \u2014 scaffold a batteries-included Avalanche dapp",
+      "",
+      "Usage:  npm create avalanche-app@latest [name] [options]",
+      "",
+      "Options:",
+      "  -t, --template <id>     minimal | nft-mint | token-gated-app | erc20-token",
+      "  -w, --wallet <id>       web3auth | injected   (default: web3auth)",
+      "  -c, --chain <id>        fuji | c-chain        (default: fuji)",
+      "      --pm <manager>      pnpm | npm | yarn | bun",
+      "  -y, --yes               skip prompts (non-interactive)",
+      "      --no-install        do not install dependencies",
+      "      --local             link @avakit/* via workspace (repo dev only)",
+      "  -v, --version           print version",
+      "  -h, --help              print this help",
+      ""
+    ].join("\n")
+  );
+}
+function isValidName(name) {
+  return /^[a-z0-9][a-z0-9._-]*$/.test(name);
+}
+async function resolveOptions(opts) {
+  const templates = listTemplates();
+  const templateIds = templates.map((t) => t.id);
+  if (opts.yes) {
+    const projectName2 = opts.projectName ?? "my-avax-app";
+    return {
+      projectName: projectName2,
+      template: opts.template && templateIds.includes(opts.template) ? opts.template : "minimal",
+      wallet: opts.wallet ?? "web3auth",
+      chain: opts.chain ?? "fuji",
+      pm: opts.pm ?? "pnpm"
+    };
+  }
+  p.intro(pc.bgCyan(pc.black(" create-avalanche-app ")));
+  const projectName = opts.projectName ?? await p.text({
+    message: "Project name?",
+    placeholder: "my-avax-app",
+    defaultValue: "my-avax-app",
+    validate: (v) => !v || isValidName(v) ? void 0 : "Use lowercase letters, digits, - . _"
+  });
+  if (p.isCancel(projectName)) cancel2();
+  const template = opts.template ?? await p.select({
+    message: "Template?",
+    options: templates.map((t) => ({ value: t.id, label: t.title, hint: t.description })),
+    initialValue: "minimal"
+  });
+  if (p.isCancel(template)) cancel2();
+  const wallet = opts.wallet ?? await p.select({
+    message: "Wallet provider?",
+    options: [
+      { value: "web3auth", label: "Social login (Web3Auth)", hint: "free, recommended" },
+      { value: "injected", label: "Browser wallet (Core / MetaMask)" }
+    ],
+    initialValue: "web3auth"
+  });
+  if (p.isCancel(wallet)) cancel2();
+  const chain = opts.chain ?? await p.select({
+    message: "Target chain?",
+    options: [
+      { value: "fuji", label: "Avalanche Fuji (testnet)", hint: "recommended" },
+      { value: "c-chain", label: "Avalanche C-Chain (mainnet)" }
+    ],
+    initialValue: "fuji"
+  });
+  if (p.isCancel(chain)) cancel2();
+  const pm = opts.pm ?? await p.select({
+    message: "Package manager?",
+    options: ["pnpm", "npm", "yarn", "bun"].map((m) => ({ value: m, label: m })),
+    initialValue: "pnpm"
+  });
+  if (p.isCancel(pm)) cancel2();
+  return {
+    projectName,
+    template,
+    wallet,
+    chain,
+    pm
+  };
+}
+function cancel2() {
+  p.cancel("Cancelled.");
+  process.exit(0);
+}
+async function main() {
+  const opts = parseArgs(process.argv);
+  const resolved = await resolveOptions(opts);
+  const targetDir = path.resolve(process.cwd(), resolved.projectName);
+  if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
+    process.stderr.write(
+      pc.red(`
+Directory "${resolved.projectName}" already exists and is not empty.
+`)
+    );
+    process.exit(1);
+  }
+  const spin = opts.yes ? null : p.spinner();
+  spin?.start("Scaffolding project");
+  const { files } = await scaffoldApp({
+    projectName: resolved.projectName,
+    targetDir,
+    template: resolved.template,
+    wallet: resolved.wallet,
+    chain: resolved.chain,
+    local: opts.local,
+    avakitVersion: VERSION
+  });
+  spin?.stop(`Created ${files.length} files`);
+  if (opts.install) {
+    const installSpin = opts.yes ? null : p.spinner();
+    installSpin?.start(`Installing dependencies with ${resolved.pm}`);
+    const result = spawnSync(resolved.pm, ["install"], {
+      cwd: targetDir,
+      stdio: opts.yes ? "inherit" : "ignore"
+    });
+    if (result.status === 0) {
+      installSpin?.stop("Dependencies installed");
+    } else {
+      installSpin?.stop(pc.yellow("Install skipped/failed \u2014 run it manually"));
+    }
+  }
+  const next = [
+    `cd ${resolved.projectName}`,
+    ...opts.install ? [] : [`${resolved.pm} install`],
+    ...resolved.wallet === "web3auth" ? ["cp .env.example .env.local   # add your Web3Auth client ID"] : [],
+    `${resolved.pm} run dev`
+  ];
+  if (opts.yes) {
+    process.stdout.write(`
+Done. Next steps:
+  ${next.join("\n  ")}
+`);
+  } else {
+    p.note(next.join("\n"), "Next steps");
+    p.outro(pc.green("Your Avalanche dapp is ready."));
+  }
+}
+main().catch((error) => {
+  process.stderr.write(
+    `
+${pc.red("Error:")} ${error instanceof Error ? error.message : String(error)}
+`
+  );
+  process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { existsSync, readdirSync } from \"node:fs\";\nimport path from \"node:path\";\nimport * as p from \"@clack/prompts\";\nimport pc from \"picocolors\";\nimport { type ChainId, listTemplates, scaffoldApp, type WalletId } from \"./api.js\";\n\nconst VERSION = \"0.1.0\";\n\ntype PackageManager = \"pnpm\" | \"npm\" | \"yarn\" | \"bun\";\n\ninterface Options {\n  projectName?: string;\n  template?: string;\n  wallet?: WalletId;\n  chain?: ChainId;\n  pm?: PackageManager;\n  yes: boolean;\n  local: boolean;\n  install: boolean;\n}\n\nfunction parseArgs(argv: string[]): Options {\n  const opts: Options = { yes: false, local: false, install: true };\n  const rest = argv.slice(2);\n  for (let i = 0; i < rest.length; i++) {\n    const arg = rest[i];\n    const next = () => rest[++i];\n    switch (arg) {\n      case \"--yes\":\n      case \"-y\":\n        opts.yes = true;\n        break;\n      case \"--local\":\n        opts.local = true;\n        break;\n      case \"--no-install\":\n        opts.install = false;\n        break;\n      case \"--template\":\n      case \"-t\":\n        opts.template = next();\n        break;\n      case \"--wallet\":\n      case \"-w\":\n        opts.wallet = next() as WalletId;\n        break;\n      case \"--chain\":\n      case \"-c\":\n        opts.chain = next() as ChainId;\n        break;\n      case \"--pm\":\n        opts.pm = next() as PackageManager;\n        break;\n      case \"--version\":\n      case \"-v\":\n        process.stdout.write(`${VERSION}\\n`);\n        process.exit(0);\n        break;\n      case \"--help\":\n      case \"-h\":\n        printHelp();\n        process.exit(0);\n        break;\n      default:\n        if (arg && !arg.startsWith(\"-\") && !opts.projectName) {\n          opts.projectName = arg;\n        }\n    }\n  }\n  return opts;\n}\n\nfunction printHelp(): void {\n  process.stdout.write(\n    [\n      \"create-avalanche-app — scaffold a batteries-included Avalanche dapp\",\n      \"\",\n      \"Usage:  npm create avalanche-app@latest [name] [options]\",\n      \"\",\n      \"Options:\",\n      \"  -t, --template <id>     minimal | nft-mint | token-gated-app | erc20-token\",\n      \"  -w, --wallet <id>       web3auth | injected   (default: web3auth)\",\n      \"  -c, --chain <id>        fuji | c-chain        (default: fuji)\",\n      \"      --pm <manager>      pnpm | npm | yarn | bun\",\n      \"  -y, --yes               skip prompts (non-interactive)\",\n      \"      --no-install        do not install dependencies\",\n      \"      --local             link @avakit/* via workspace (repo dev only)\",\n      \"  -v, --version           print version\",\n      \"  -h, --help              print this help\",\n      \"\",\n    ].join(\"\\n\"),\n  );\n}\n\nfunction isValidName(name: string): boolean {\n  return /^[a-z0-9][a-z0-9._-]*$/.test(name);\n}\n\nasync function resolveOptions(\n  opts: Options,\n): Promise<Required<Omit<Options, \"yes\" | \"local\" | \"install\">>> {\n  const templates = listTemplates();\n  const templateIds = templates.map((t) => t.id);\n\n  if (opts.yes) {\n    const projectName = opts.projectName ?? \"my-avax-app\";\n    return {\n      projectName,\n      template: opts.template && templateIds.includes(opts.template) ? opts.template : \"minimal\",\n      wallet: opts.wallet ?? \"web3auth\",\n      chain: opts.chain ?? \"fuji\",\n      pm: opts.pm ?? \"pnpm\",\n    };\n  }\n\n  p.intro(pc.bgCyan(pc.black(\" create-avalanche-app \")));\n\n  const projectName =\n    opts.projectName ??\n    (await p.text({\n      message: \"Project name?\",\n      placeholder: \"my-avax-app\",\n      defaultValue: \"my-avax-app\",\n      validate: (v) => (!v || isValidName(v) ? undefined : \"Use lowercase letters, digits, - . _\"),\n    }));\n  if (p.isCancel(projectName)) cancel();\n\n  const template =\n    opts.template ??\n    (await p.select({\n      message: \"Template?\",\n      options: templates.map((t) => ({ value: t.id, label: t.title, hint: t.description })),\n      initialValue: \"minimal\",\n    }));\n  if (p.isCancel(template)) cancel();\n\n  const wallet =\n    opts.wallet ??\n    (await p.select({\n      message: \"Wallet provider?\",\n      options: [\n        { value: \"web3auth\", label: \"Social login (Web3Auth)\", hint: \"free, recommended\" },\n        { value: \"injected\", label: \"Browser wallet (Core / MetaMask)\" },\n      ],\n      initialValue: \"web3auth\",\n    }));\n  if (p.isCancel(wallet)) cancel();\n\n  const chain =\n    opts.chain ??\n    (await p.select({\n      message: \"Target chain?\",\n      options: [\n        { value: \"fuji\", label: \"Avalanche Fuji (testnet)\", hint: \"recommended\" },\n        { value: \"c-chain\", label: \"Avalanche C-Chain (mainnet)\" },\n      ],\n      initialValue: \"fuji\",\n    }));\n  if (p.isCancel(chain)) cancel();\n\n  const pm =\n    opts.pm ??\n    (await p.select({\n      message: \"Package manager?\",\n      options: ([\"pnpm\", \"npm\", \"yarn\", \"bun\"] as const).map((m) => ({ value: m, label: m })),\n      initialValue: \"pnpm\",\n    }));\n  if (p.isCancel(pm)) cancel();\n\n  return {\n    projectName: projectName as string,\n    template: template as string,\n    wallet: wallet as WalletId,\n    chain: chain as ChainId,\n    pm: pm as PackageManager,\n  };\n}\n\nfunction cancel(): never {\n  p.cancel(\"Cancelled.\");\n  process.exit(0);\n}\n\nasync function main(): Promise<void> {\n  const opts = parseArgs(process.argv);\n  const resolved = await resolveOptions(opts);\n\n  const targetDir = path.resolve(process.cwd(), resolved.projectName);\n  if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {\n    process.stderr.write(\n      pc.red(`\\nDirectory \"${resolved.projectName}\" already exists and is not empty.\\n`),\n    );\n    process.exit(1);\n  }\n\n  const spin = opts.yes ? null : p.spinner();\n  spin?.start(\"Scaffolding project\");\n  const { files } = await scaffoldApp({\n    projectName: resolved.projectName,\n    targetDir,\n    template: resolved.template,\n    wallet: resolved.wallet,\n    chain: resolved.chain,\n    local: opts.local,\n    avakitVersion: VERSION,\n  });\n  spin?.stop(`Created ${files.length} files`);\n\n  if (opts.install) {\n    const installSpin = opts.yes ? null : p.spinner();\n    installSpin?.start(`Installing dependencies with ${resolved.pm}`);\n    const result = spawnSync(resolved.pm, [\"install\"], {\n      cwd: targetDir,\n      stdio: opts.yes ? \"inherit\" : \"ignore\",\n    });\n    if (result.status === 0) {\n      installSpin?.stop(\"Dependencies installed\");\n    } else {\n      installSpin?.stop(pc.yellow(\"Install skipped/failed — run it manually\"));\n    }\n  }\n\n  const next = [\n    `cd ${resolved.projectName}`,\n    ...(opts.install ? [] : [`${resolved.pm} install`]),\n    ...(resolved.wallet === \"web3auth\"\n      ? [\"cp .env.example .env.local   # add your Web3Auth client ID\"]\n      : []),\n    `${resolved.pm} run dev`,\n  ];\n\n  if (opts.yes) {\n    process.stdout.write(`\\nDone. Next steps:\\n  ${next.join(\"\\n  \")}\\n`);\n  } else {\n    p.note(next.join(\"\\n\"), \"Next steps\");\n    p.outro(pc.green(\"Your Avalanche dapp is ready.\"));\n  }\n}\n\nmain().catch((error: unknown) => {\n  process.stderr.write(\n    `\\n${pc.red(\"Error:\")} ${error instanceof Error ? error.message : String(error)}\\n`,\n  );\n  process.exit(1);\n});\n"],"mappings":"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","names":["projectName","cancel"]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "create-avalanche-app",
+  "version": "0.1.0",
+  "description": "Scaffold a batteries-included Avalanche dapp: social-login onboarding, deploy-ready, AI-native.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "create-avalanche-app": "./dist/index.js"
+  },
+  "exports": {
+    "./api": {
+      "types": "./dist/api.d.ts",
+      "import": "./dist/api.js"
+    }
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "1.6.0",
+    "picocolors": "1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "26.0.1",
+    "tsup": "8.5.1",
+    "typescript": "6.0.3",
+    "vitest": "4.1.9"
+  },
+  "keywords": [
+    "avalanche",
+    "avax",
+    "create-app",
+    "scaffold",
+    "starter",
+    "nextjs",
+    "web3",
+    "dapp",
+    "avakit"
+  ],
+  "author": "AvaKit contributors",
+  "homepage": "https://github.com/mericcintosun/AvaKit#readme",
+  "bugs": {
+    "url": "https://github.com/mericcintosun/AvaKit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mericcintosun/AvaKit.git",
+    "directory": "packages/create-avalanche-app"
+  },
+  "engines": {
+    "node": ">=20.11"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}

package/templates/erc20-token/CLAUDE.md

@@ -0,0 +1,45 @@
+# __PROJECT_NAME__ — Avalanche ERC-20 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 (token contract)
+
+## Architecture
+
+- `contracts/src/AvaKitToken.sol` — a minimal, self-contained ERC-20 (name AKT, 18 decimals) with a public `mint()` demo faucet.
+- `lib/token-artifact.ts` — the compiled ABI + bytecode (browser deploy, no Foundry at runtime).
+- `components/demo.tsx` — deploy → mint → transfer.
+- `app/providers.tsx` — `<AvaKitProvider>` + `ThemeProvider`.
+
+## The flow
+
+1. Connect a wallet (`<ConnectAvalanche />`).
+2. Deploy: `useAvaDeploy().deploy({ abi, bytecode })`.
+3. Mint: `useContract({ address, abi }).write("mint", [])` (mints 100 AKT).
+4. Transfer: `.write("transfer", [to, parseUnits("10", 18)])`.
+5. Read: `.read("balanceOf", [address])`, `.read("totalSupply")` — format with `formatUnits(v, 18)`.
+
+## Editing the contract
+
+After changing `contracts/src/AvaKitToken.sol`:
+
+```bash
+cd contracts && forge build
+# copy out/AvaKitToken.sol/AvaKitToken.json's abi + bytecode.object into lib/token-artifact.ts
+```
+
+## 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.
+- Amounts are in wei — always convert with `parseUnits` / `formatUnits` (18 decimals).
+- Deploying, minting, and transferring cost gas — fund the wallet on Fuji first.
+- Social login needs `NEXT_PUBLIC_WEB3AUTH_CLIENT_ID` in `.env.local`.
+
+## Commands
+
+- `pnpm dev` — dev server
+- `cd contracts && forge build` — recompile the token

package/templates/erc20-token/README.md

@@ -0,0 +1,35 @@
+# __PROJECT_NAME__
+
+An Avalanche **ERC-20 token** dapp scaffolded with [AvaKit](https://github.com/mericcintosun/AvaKit). Deploy a token from your browser, mint, and transfer — 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 token contract** → **Mint 100 AKT** → **Burn 10 AKT**. These cost gas, so fund your wallet on Fuji first (in-app faucet link).
+
+## How the token works
+
+- `contracts/src/AvaKitToken.sol` — a minimal, self-contained ERC-20 (AKT, 18 decimals) with a public `mint()` demo faucet.
+- `lib/token-artifact.ts` — the compiled ABI + bytecode, bundled for browser deploy via `useAvaDeploy()`.
+
+Amounts are in wei — convert with `parseUnits` / `formatUnits` (18 decimals).
+
+```bash
+cd contracts && forge build   # recompile after editing the contract
+```
+
+## 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 token flow and conventions.