create-avalanche-app 0.1.4 → 0.1.5

package/dist/index.js

@@ -10,7 +10,7 @@ import { existsSync, readdirSync } from "fs";
 import path from "path";
 import * as p from "@clack/prompts";
 import pc from "picocolors";
-var VERSION = "0.1.4";
+var VERSION = "0.1.5";
 var AVAKIT_DEP_VERSION = "0.1.2";
 function parseArgs(argv) {
   const opts = { yes: false, local: false, install: true };
@@ -72,7 +72,7 @@ function printHelp() {
       "",
       "Options:",
       "  -t, --template <id>     minimal | nft-mint | token-gated-app | erc20-token |",
-      "                          icm-messenger | eerc-token",
+      "                          icm-messenger | eerc-token | l1-launch",
       "  -w, --wallet <id>       web3auth | injected   (default: web3auth)",
       "  -c, --chain <id>        fuji | c-chain        (default: fuji)",
       "      --pm <manager>      pnpm | npm | yarn | bun",

package/dist/index.js.map

@@ -1 +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.4\";\n\n// The @avakit/* dependency version stamped into scaffolded apps' package.json\n// (as `^AVAKIT_DEP_VERSION`). Kept separate from the CLI's own VERSION: it must\n// resolve every published @avakit package, so it tracks the LOWEST current\n// @avakit version (core 0.1.2 · react 0.1.3 → ^0.1.2 satisfies both). Bump only\n// when the minimum @avakit version a fresh app needs goes up.\nconst AVAKIT_DEP_VERSION = \"0.1.2\";\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      \"                          icm-messenger | eerc-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: AVAKIT_DEP_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"]}
+{"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.5\";\n\n// The @avakit/* dependency version stamped into scaffolded apps' package.json\n// (as `^AVAKIT_DEP_VERSION`). Kept separate from the CLI's own VERSION: it must\n// resolve every published @avakit package, so it tracks the LOWEST current\n// @avakit version (core 0.1.2 · react 0.1.3 → ^0.1.2 satisfies both). Bump only\n// when the minimum @avakit version a fresh app needs goes up.\nconst AVAKIT_DEP_VERSION = \"0.1.2\";\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      \"                          icm-messenger | eerc-token | l1-launch\",\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: AVAKIT_DEP_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":";;;;;;;AAAA,SAAS,iBAAiB;AAC1B,SAAS,YAAY,mBAAmB;AACxC,OAAO,UAAU;AACjB,YAAY,OAAO;AACnB,OAAO,QAAQ;AAGf,IAAM,UAAU;AAOhB,IAAM,qBAAqB;AAe3B,SAAS,UAAU,MAAyB;AAC1C,QAAM,OAAgB,EAAE,KAAK,OAAO,OAAO,OAAO,SAAS,KAAK;AAChE,QAAM,OAAO,KAAK,MAAM,CAAC;AACzB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAClB,UAAM,OAAO,MAAM,KAAK,EAAE,CAAC;AAC3B,YAAQ,KAAK;AAAA,MACX,KAAK;AAAA,MACL,KAAK;AACH,aAAK,MAAM;AACX;AAAA,MACF,KAAK;AACH,aAAK,QAAQ;AACb;AAAA,MACF,KAAK;AACH,aAAK,UAAU;AACf;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,aAAK,WAAW,KAAK;AACrB;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,aAAK,SAAS,KAAK;AACnB;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,aAAK,QAAQ,KAAK;AAClB;AAAA,MACF,KAAK;AACH,aAAK,KAAK,KAAK;AACf;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,gBAAQ,OAAO,MAAM,GAAG,OAAO;AAAA,CAAI;AACnC,gBAAQ,KAAK,CAAC;AACd;AAAA,MACF,KAAK;AAAA,MACL,KAAK;AACH,kBAAU;AACV,gBAAQ,KAAK,CAAC;AACd;AAAA,MACF;AACE,YAAI,OAAO,CAAC,IAAI,WAAW,GAAG,KAAK,CAAC,KAAK,aAAa;AACpD,eAAK,cAAc;AAAA,QACrB;AAAA,IACJ;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,YAAkB;AACzB,UAAQ,OAAO;AAAA,IACb;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF,EAAE,KAAK,IAAI;AAAA,EACb;AACF;AAEA,SAAS,YAAY,MAAuB;AAC1C,SAAO,yBAAyB,KAAK,IAAI;AAC3C;AAEA,eAAe,eACb,MAC+D;AAC/D,QAAM,YAAY,cAAc;AAChC,QAAM,cAAc,UAAU,IAAI,CAAC,MAAM,EAAE,EAAE;AAE7C,MAAI,KAAK,KAAK;AACZ,UAAMA,eAAc,KAAK,eAAe;AACxC,WAAO;AAAA,MACL,aAAAA;AAAA,MACA,UAAU,KAAK,YAAY,YAAY,SAAS,KAAK,QAAQ,IAAI,KAAK,WAAW;AAAA,MACjF,QAAQ,KAAK,UAAU;AAAA,MACvB,OAAO,KAAK,SAAS;AAAA,MACrB,IAAI,KAAK,MAAM;AAAA,IACjB;AAAA,EACF;AAEA,EAAE,QAAM,GAAG,OAAO,GAAG,MAAM,wBAAwB,CAAC,CAAC;AAErD,QAAM,cACJ,KAAK,eACJ,MAAQ,OAAK;AAAA,IACZ,SAAS;AAAA,IACT,aAAa;AAAA,IACb,cAAc;AAAA,IACd,UAAU,CAAC,MAAO,CAAC,KAAK,YAAY,CAAC,IAAI,SAAY;AAAA,EACvD,CAAC;AACH,MAAM,WAAS,WAAW,EAAG,CAAAC,QAAO;AAEpC,QAAM,WACJ,KAAK,YACJ,MAAQ,SAAO;AAAA,IACd,SAAS;AAAA,IACT,SAAS,UAAU,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,OAAO,EAAE,OAAO,MAAM,EAAE,YAAY,EAAE;AAAA,IACpF,cAAc;AAAA,EAChB,CAAC;AACH,MAAM,WAAS,QAAQ,EAAG,CAAAA,QAAO;AAEjC,QAAM,SACJ,KAAK,UACJ,MAAQ,SAAO;AAAA,IACd,SAAS;AAAA,IACT,SAAS;AAAA,MACP,EAAE,OAAO,YAAY,OAAO,2BAA2B,MAAM,oBAAoB;AAAA,MACjF,EAAE,OAAO,YAAY,OAAO,mCAAmC;AAAA,IACjE;AAAA,IACA,cAAc;AAAA,EAChB,CAAC;AACH,MAAM,WAAS,MAAM,EAAG,CAAAA,QAAO;AAE/B,QAAM,QACJ,KAAK,SACJ,MAAQ,SAAO;AAAA,IACd,SAAS;AAAA,IACT,SAAS;AAAA,MACP,EAAE,OAAO,QAAQ,OAAO,4BAA4B,MAAM,cAAc;AAAA,MACxE,EAAE,OAAO,WAAW,OAAO,8BAA8B;AAAA,IAC3D;AAAA,IACA,cAAc;AAAA,EAChB,CAAC;AACH,MAAM,WAAS,KAAK,EAAG,CAAAA,QAAO;AAE9B,QAAM,KACJ,KAAK,MACJ,MAAQ,SAAO;AAAA,IACd,SAAS;AAAA,IACT,SAAU,CAAC,QAAQ,OAAO,QAAQ,KAAK,EAAY,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,EAAE;AAAA,IACtF,cAAc;AAAA,EAChB,CAAC;AACH,MAAM,WAAS,EAAE,EAAG,CAAAA,QAAO;AAE3B,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAASA,UAAgB;AACvB,EAAE,SAAO,YAAY;AACrB,UAAQ,KAAK,CAAC;AAChB;AAEA,eAAe,OAAsB;AACnC,QAAM,OAAO,UAAU,QAAQ,IAAI;AACnC,QAAM,WAAW,MAAM,eAAe,IAAI;AAE1C,QAAM,YAAY,KAAK,QAAQ,QAAQ,IAAI,GAAG,SAAS,WAAW;AAClE,MAAI,WAAW,SAAS,KAAK,YAAY,SAAS,EAAE,SAAS,GAAG;AAC9D,YAAQ,OAAO;AAAA,MACb,GAAG,IAAI;AAAA,aAAgB,SAAS,WAAW;AAAA,CAAsC;AAAA,IACnF;AACA,YAAQ,KAAK,CAAC;AAAA,EAChB;AAEA,QAAM,OAAO,KAAK,MAAM,OAAS,UAAQ;AACzC,QAAM,MAAM,qBAAqB;AACjC,QAAM,EAAE,MAAM,IAAI,MAAM,YAAY;AAAA,IAClC,aAAa,SAAS;AAAA,IACtB;AAAA,IACA,UAAU,SAAS;AAAA,IACnB,QAAQ,SAAS;AAAA,IACjB,OAAO,SAAS;AAAA,IAChB,OAAO,KAAK;AAAA,IACZ,eAAe;AAAA,EACjB,CAAC;AACD,QAAM,KAAK,WAAW,MAAM,MAAM,QAAQ;AAE1C,MAAI,KAAK,SAAS;AAChB,UAAM,cAAc,KAAK,MAAM,OAAS,UAAQ;AAChD,iBAAa,MAAM,gCAAgC,SAAS,EAAE,EAAE;AAChE,UAAM,SAAS,UAAU,SAAS,IAAI,CAAC,SAAS,GAAG;AAAA,MACjD,KAAK;AAAA,MACL,OAAO,KAAK,MAAM,YAAY;AAAA,IAChC,CAAC;AACD,QAAI,OAAO,WAAW,GAAG;AACvB,mBAAa,KAAK,wBAAwB;AAAA,IAC5C,OAAO;AACL,mBAAa,KAAK,GAAG,OAAO,+CAA0C,CAAC;AAAA,IACzE;AAAA,EACF;AAEA,QAAM,OAAO;AAAA,IACX,MAAM,SAAS,WAAW;AAAA,IAC1B,GAAI,KAAK,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,EAAE,UAAU;AAAA,IACjD,GAAI,SAAS,WAAW,aACpB,CAAC,4DAA4D,IAC7D,CAAC;AAAA,IACL,GAAG,SAAS,EAAE;AAAA,EAChB;AAEA,MAAI,KAAK,KAAK;AACZ,YAAQ,OAAO,MAAM;AAAA;AAAA,IAA0B,KAAK,KAAK,MAAM,CAAC;AAAA,CAAI;AAAA,EACtE,OAAO;AACL,IAAE,OAAK,KAAK,KAAK,IAAI,GAAG,YAAY;AACpC,IAAE,QAAM,GAAG,MAAM,+BAA+B,CAAC;AAAA,EACnD;AACF;AAEA,KAAK,EAAE,MAAM,CAAC,UAAmB;AAC/B,UAAQ,OAAO;AAAA,IACb;AAAA,EAAK,GAAG,IAAI,QAAQ,CAAC,IAAI,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AAAA;AAAA,EACjF;AACA,UAAQ,KAAK,CAAC;AAChB,CAAC;","names":["projectName","cancel"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-avalanche-app",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Scaffold a batteries-included Avalanche dapp: social-login onboarding, deploy-ready, AI-native.",
   "license": "MIT",
   "type": "module",

package/templates/l1-launch/CLAUDE.md

@@ -0,0 +1,91 @@
+# __PROJECT_NAME__ — Launch your own Avalanche L1 (scaffolded with AvaKit)
+
+Operational guide for AI agents (Claude Code / Cursor) working in this project.
+
+## What this is
+
+A one-command flow that spins up **your own Avalanche L1** (a Subnet-EVM blockchain) on a local
+Avalanche network, then hands you a **built-in block explorer + dashboard**: live blocks and
+transactions, your balance, and a "deploy a contract" button — all reading straight from your
+chain's RPC, no third-party explorer or Docker required. `pnpm l1:fuji` graduates the same chain to
+the public Fuji testnet (advanced).
+
+## Stack
+
+Next.js 16 (App Router) · React 19 · `@avakit/react` · `@avakit/core` · viem · shadcn/ui · next-themes · Foundry (demo contract) · avalanche-cli (the L1)
+
+## Architecture
+
+- `scripts/l1.sh` (`pnpm l1`) — creates + deploys a local Subnet-EVM L1 and writes `l1.config.json`.
+- `scripts/l1-fuji.sh` (`pnpm l1:fuji`) — the advanced path: deploy the L1 to Fuji.
+- `l1.config.json` — your chain: `name`, `token`, `evmChainId`, `rpcUrl`, `blockchainIdHex`, and (local only) the pre-funded `faucetAccount`. Written by the scripts.
+- `lib/l1.ts` — turns that config into an AvaKit chain (`defineChain`) + `isConfigured`.
+- `components/demo.tsx` — the dashboard/explorer: polls the RPC for height, gas, the latest blocks and their transactions; deploys the demo ERC-20; mints.
+- `contracts/src/AvaKitToken.sol` + `lib/token-artifact.ts` — a minimal self-contained ERC-20 (browser deploy, no Foundry at runtime).
+- `app/providers.tsx` — `<AvaKitProvider chains={[chain]}>` with the injected wallet.
+
+## The flow
+
+1. `pnpm l1` — creates the L1, deploys it locally, writes `l1.config.json`.
+2. Import the printed EWOQ dev key into your wallet (pre-funded on your chain — public, local only).
+3. `pnpm dev` → the page becomes your chain dashboard.
+4. Deploy the demo token → mint → watch the transactions land in the built-in explorer live.
+
+## The config decisions (explain these to the user when asked)
+
+`pnpm l1` runs `avalanche blockchain create` with these choices — each is a real design decision:
+
+- **VM = Subnet-EVM** (`--evm --latest`): an EVM chain, so Solidity/viem/MetaMask all work. The
+  alternative is a custom VM (`--custom`) — only needed for non-EVM execution.
+- **Chain ID** (`--evm-chain-id`, default `9999`): the EVM chain id wallets use. Pick something that
+  won't collide with a chain your users already have (see chainlist.org). It's baked into the
+  genesis — changing it later means a new chain.
+- **Native token** (`--evm-token`, default `MYL1`): the gas/native currency symbol. Purely cosmetic
+  on a dev chain; on a real L1 it's your chain's economic unit.
+- **Consensus / sovereignty**: this template uses `--sovereign=false` (a non-sovereign subnet) for
+  the **local** chain because it's fully non-interactive and instant. A true **sovereign L1**
+  (post-Etna, the modern default) has its validator set managed by a **Validator Manager** contract
+  and picks a validator-management model:
+  - **PoA** (`--proof-of-authority`): you (an owner address) add/remove validators. Simplest; good
+    for a consortium or a chain you run.
+  - **PoS native** (`--proof-of-stake-native`): validators stake the native token.
+  - **PoS ERC-20** (`--proof-of-stake-erc20`): validators stake a specified ERC-20.
+  The Fuji path (`pnpm l1:fuji`) uses a sovereign PoA L1.
+- **`--test-defaults`**: dev-friendly genesis — the **EWOQ** key is pre-funded, fees are low, finality
+  is fast. Its opposite is `--production-defaults`. Never ship `--test-defaults` economics to mainnet.
+
+## EWOQ warning
+
+`0x56289e…8027` (address `0x8db97C…52FC`) is avalanche-cli's **public** local dev key, pre-funded on
+every local chain. It is **local-only** — never use it, or its balance, on Fuji or mainnet, and never
+commit a real private key. On Fuji you bring your own funded wallet.
+
+## Graduating to Fuji (advanced)
+
+`pnpm l1:fuji` deploys the L1 to the public Fuji testnet. Unlike the local flow this needs, and the
+script will walk you through: (1) a Fuji key funded with test AVAX (Builder Hub faucet → C-Chain →
+cross-chain transfer to the P-Chain), (2) a **bootstrap validator** — your machine can be it
+(`--use-local-machine`), but that process must **stay running** or the L1 stops producing blocks,
+(3) an ongoing validator **balance** that drains over time (~1 AVAX ≈ 1 month) and must be topped up.
+It is a multi-step, multi-minute process, not one command. There is no automatic hosted explorer for
+a custom Fuji L1 — this app's built-in explorer keeps working by pointing at your Fuji L1's RPC.
+
+## Editing the demo contract
+
+After changing `contracts/src/AvaKitToken.sol`: `cd contracts && forge build`, then 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 for now; dark/light via next-themes; both must work.
+- Animations: Framer Motion or GSAP only.
+- The explorer is all read-only viem (`getPublicClient(chain)` → `getBlock`/`getBalance`/…); keep it that way — no server, no indexer.
+- Never hardcode a real private key. The EWOQ key is public/local-only.
+
+## Commands
+
+- `pnpm l1` — launch your local L1 (writes `l1.config.json`)
+- `pnpm dev` — dev server (http://localhost:3000)
+- `pnpm l1:fuji` — deploy the L1 to Fuji (advanced)
+- `avalanche network stop | clean` — pause | wipe the local network
+- `cd contracts && forge build` — recompile the demo token

package/templates/l1-launch/README.md

@@ -0,0 +1,45 @@
+# __PROJECT_NAME__
+
+Launch **your own Avalanche L1** with one command, then explore it in a built-in dashboard — live blocks and transactions, your balance, and a deploy-a-contract button. Scaffolded with [AvaKit](https://github.com/mericcintosun/AvaKit).
+
+## Getting started
+
+```bash
+# 1. launch your L1 (needs avalanche-cli; downloads avalanchego on first run)
+pnpm l1
+#    → creates a Subnet-EVM chain, deploys it locally, writes l1.config.json
+#    optional: L1_NAME=mychain L1_CHAIN_ID=9999 L1_TOKEN=MYL1 pnpm l1
+
+# 2. run the app
+pnpm dev    # http://localhost:3000
+```
+
+Then: import the printed EWOQ dev key into your wallet (pre-funded on your chain, local-only) →
+**Deploy demo token** → **Mint** → watch the transactions land in the built-in explorer.
+
+## What you get
+
+- **Your own chain** — a real Subnet-EVM L1 running locally (no test AVAX, no faucet, no always-on node).
+- **A built-in block explorer** — latest blocks, transactions, gas, and your balance, all read live
+  from the chain's RPC with viem. No Docker, no third-party indexer.
+- **Browser contract deploy** — a bundled ERC-20 you deploy and mint, so you can watch real
+  transactions flow through your chain.
+
+## Graduate to Fuji (advanced)
+
+```bash
+pnpm l1:fuji
+```
+
+Deploys the same L1 to the public Fuji testnet. This needs test AVAX and a validator node that
+**stays running** (your machine can be it) — see `CLAUDE.md` for the full walkthrough and caveats.
+
+## Stack
+
+Next.js 16 · `@avakit/react` · `@avakit/core` · viem · shadcn/ui · avalanche-cli · Foundry
+
+## AI-native
+
+Ships with `CLAUDE.md`, `llms.txt`, and `.cursor/rules` — including an explainer for every L1 config
+decision (VM, consensus/sovereignty, chain ID, token, `--test-defaults`, the EWOQ warning) so Claude
+Code / Cursor can walk you through building your own chain.

package/templates/l1-launch/app/globals.css

@@ -0,0 +1,95 @@
+@import "tailwindcss";
+@import "tw-animate-css";
+
+/* Scan @avakit/react's shadcn-style classes from node_modules. */
+@source "../node_modules/@avakit/react/dist";
+
+@custom-variant dark (&:is(.dark *));
+
+/*
+ * Black & white only (oklch chroma 0 = pure grayscale). Dark/light wired from
+ * day one via next-themes. Add brand colors later by editing these tokens —
+ * components never hardcode colors.
+ */
+:root {
+  --radius: 0.625rem;
+  --background: oklch(1 0 0);
+  --foreground: oklch(0.145 0 0);
+  --card: oklch(1 0 0);
+  --card-foreground: oklch(0.145 0 0);
+  --popover: oklch(1 0 0);
+  --popover-foreground: oklch(0.145 0 0);
+  --primary: oklch(0.205 0 0);
+  --primary-foreground: oklch(0.985 0 0);
+  --secondary: oklch(0.97 0 0);
+  --secondary-foreground: oklch(0.205 0 0);
+  --muted: oklch(0.97 0 0);
+  --muted-foreground: oklch(0.556 0 0);
+  --accent: oklch(0.97 0 0);
+  --accent-foreground: oklch(0.205 0 0);
+  --destructive: oklch(0.3 0 0);
+  --destructive-foreground: oklch(0.985 0 0);
+  --border: oklch(0.922 0 0);
+  --input: oklch(0.922 0 0);
+  --ring: oklch(0.708 0 0);
+}
+
+.dark {
+  --background: oklch(0.145 0 0);
+  --foreground: oklch(0.985 0 0);
+  --card: oklch(0.205 0 0);
+  --card-foreground: oklch(0.985 0 0);
+  --popover: oklch(0.205 0 0);
+  --popover-foreground: oklch(0.985 0 0);
+  --primary: oklch(0.985 0 0);
+  --primary-foreground: oklch(0.205 0 0);
+  --secondary: oklch(0.269 0 0);
+  --secondary-foreground: oklch(0.985 0 0);
+  --muted: oklch(0.269 0 0);
+  --muted-foreground: oklch(0.708 0 0);
+  --accent: oklch(0.269 0 0);
+  --accent-foreground: oklch(0.985 0 0);
+  --destructive: oklch(0.7 0 0);
+  --destructive-foreground: oklch(0.205 0 0);
+  --border: oklch(1 0 0 / 10%);
+  --input: oklch(1 0 0 / 15%);
+  --ring: oklch(0.556 0 0);
+}
+
+@theme inline {
+  --color-background: var(--background);
+  --color-foreground: var(--foreground);
+  --color-card: var(--card);
+  --color-card-foreground: var(--card-foreground);
+  --color-popover: var(--popover);
+  --color-popover-foreground: var(--popover-foreground);
+  --color-primary: var(--primary);
+  --color-primary-foreground: var(--primary-foreground);
+  --color-secondary: var(--secondary);
+  --color-secondary-foreground: var(--secondary-foreground);
+  --color-muted: var(--muted);
+  --color-muted-foreground: var(--muted-foreground);
+  --color-accent: var(--accent);
+  --color-accent-foreground: var(--accent-foreground);
+  --color-destructive: var(--destructive);
+  --color-destructive-foreground: var(--destructive-foreground);
+  --color-border: var(--border);
+  --color-input: var(--input);
+  --color-ring: var(--ring);
+  --radius-sm: calc(var(--radius) - 4px);
+  --radius-md: calc(var(--radius) - 2px);
+  --radius-lg: var(--radius);
+  --radius-xl: calc(var(--radius) + 4px);
+  --font-sans: var(--font-geist-sans);
+  --font-mono: var(--font-geist-mono);
+}
+
+@layer base {
+  * {
+    border-color: var(--border);
+  }
+  body {
+    background-color: var(--background);
+    color: var(--foreground);
+  }
+}

package/templates/l1-launch/app/layout.tsx

@@ -0,0 +1,23 @@
+import type { Metadata } from "next";
+import { Geist, Geist_Mono } from "next/font/google";
+import type { ReactNode } from "react";
+import { Providers } from "./providers";
+import "./globals.css";
+
+const geistSans = Geist({ variable: "--font-geist-sans", subsets: ["latin"] });
+const geistMono = Geist_Mono({ variable: "--font-geist-mono", subsets: ["latin"] });
+
+export const metadata: Metadata = {
+  title: "__PROJECT_NAME__",
+  description: "Your own Avalanche L1, with a built-in block explorer — scaffolded with AvaKit.",
+};
+
+export default function RootLayout({ children }: Readonly<{ children: ReactNode }>) {
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <body className={`${geistSans.variable} ${geistMono.variable} font-sans antialiased`}>
+        <Providers>{children}</Providers>
+      </body>
+    </html>
+  );
+}

package/templates/l1-launch/app/page.tsx

@@ -0,0 +1,5 @@
+import { Demo } from "@/components/demo";
+
+export default function Home() {
+  return <Demo />;
+}

package/templates/l1-launch/app/providers.tsx

@@ -0,0 +1,22 @@
+"use client";
+
+import { injectedAdapter, type WalletAdapter } from "@avakit/core";
+import { AvaKitProvider } from "@avakit/react";
+import { ThemeProvider } from "next-themes";
+import { type ReactNode, useMemo } from "react";
+import { chain } from "@/lib/l1";
+
+export function Providers({ children }: { children: ReactNode }) {
+  // Your L1: connect a browser wallet (Core / MetaMask). On local networks,
+  // import the EWOQ dev key (printed by `pnpm l1`) — it's pre-funded on your
+  // chain. On Fuji, use your own funded wallet.
+  const adapters = useMemo<WalletAdapter[]>(() => [injectedAdapter()], []);
+
+  return (
+    <ThemeProvider attribute="class" defaultTheme="system" enableSystem disableTransitionOnChange>
+      <AvaKitProvider chains={[chain]} adapters={adapters}>
+        {children}
+      </AvaKitProvider>
+    </ThemeProvider>
+  );
+}