abc-scaffold 1.0.0 → 1.0.1

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Kimberley Bezuidenhout
+Copyright (c) 2026 Africa's Blockchain Club
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/package.json

@@ -1,42 +1,42 @@
-{
-  "name": "abc-scaffold",
-  "version": "1.0.0",
-  "description": "Africa's Blockchain Club — project-agnostic blockchain scaffolding tool",
-  "author": "Africa's Blockchain Club",
-  "license": "MIT",
-  "type": "module",
-  "bin": {
-    "abc-scaffold": "bin/abc-scaffold.js"
-  },
-  "files": [
-    "bin",
-    "src",
-    "templates",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "start": "node bin/abc-scaffold.js"
-  },
-  "keywords": [
-    "hardhat",
-    "blockchain",
-    "scaffold",
-    "ethereum",
-    "smart-contracts",
-    "africa",
-    "web3",
-    "erc4337",
-    "openzeppelin"
-  ],
-  "dependencies": {
-    "chalk": "^5.3.0",
-    "fs-extra": "^11.2.0"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "abc-scaffold",
+  "version": "1.0.1",
+  "description": "Africa's Blockchain Club — project-agnostic blockchain scaffolding tool",
+  "author": "Africa's Blockchain Club",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "abc-scaffold": "bin/abc-scaffold.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node bin/abc-scaffold.js"
+  },
+  "keywords": [
+    "hardhat",
+    "blockchain",
+    "scaffold",
+    "ethereum",
+    "smart-contracts",
+    "africa",
+    "web3",
+    "erc4337",
+    "openzeppelin"
+  ],
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "fs-extra": "^11.2.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/scaffold.js

@@ -1,341 +1,346 @@
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { createInterface } from 'readline';
-import fse from 'fs-extra';
-import chalk from 'chalk';
-import * as logger from './logger.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname  = path.dirname(__filename);
-const TEMPLATES  = path.join(__dirname, '..', 'templates');
-
-function prompt(question) {
-  return new Promise((resolve) => {
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    rl.question(question, (answer) => { rl.close(); resolve(answer.trim()); });
-  });
-}
-
-function isValidName(name) {
-  return /^[a-z0-9][a-z0-9\-_]*$/.test(name);
-}
-
-function copyTemplate(filename, targetDir) {
-  fse.copySync(path.join(TEMPLATES, filename), path.join(targetDir, filename));
-  logger.success(filename);
-}
-
-function buildReadme(projectName) {
-  return `# ${projectName}
-
-> Scaffolded with [abc-scaffold](https://github.com/africas-blockchain-club/abc-scaffold) by **Africa's Blockchain Club**
-
-A project-agnostic Hardhat workspace ready for smart contract development, testing, and frontend integration. Build anything — NFTs, DeFi protocols, DAOs, smart accounts, or any on-chain application.
-
----
-
-## Prerequisites
-
-| Tool | Version |
-|------|---------|
-| Node.js | >= 18.0.0 |
-| npm | >= 9.0.0 |
-| MetaMask | Latest |
-
----
-
-## Getting Started
-
-### 1. Install dependencies
-
-\`\`\`bash
-npm install
-\`\`\`
-
-### 2. Set up environment variables
-
-\`\`\`bash
-cp .env.example .env
-\`\`\`
-
-Fill in your values in \`.env\`:
-
-- \`SEPOLIA_RPC_URL\` — get one free from [Infura](https://infura.io) or [Alchemy](https://alchemy.com)
-- \`PRIVATE_KEY\` — your deployer wallet private key (**never commit this file**)
-- \`ETHERSCAN_API_KEY\` — for contract verification on [Etherscan](https://etherscan.io)
-
-### 3. Compile contracts
-
-\`\`\`bash
-npm run compile
-\`\`\`
-
-### 4. Run tests
-
-\`\`\`bash
-npm test
-\`\`\`
-
-### 5. Start a local Hardhat node
-
-\`\`\`bash
-npx hardhat node
-\`\`\`
-
-### 6. Deploy contracts locally
-
-\`\`\`bash
-npx hardhat run scripts/deploy.js --network localhost
-\`\`\`
-
-### 7. Start the frontend
-
-\`\`\`bash
-cd frontend
-npm install
-npm run dev
-# → http://localhost:5173
-\`\`\`
-
----
-
-## Directory Structure
-
-\`\`\`
-${projectName}/
-├── contracts/          # Solidity smart contracts
-├── scripts/            # Deployment and utility scripts
-├── test/               # Hardhat test files
-├── frontend/           # React + Vite frontend
-│   └── src/
-│       ├── App.jsx
-│       └── components/
-│           └── Navbar.jsx   ← Connect Wallet button lives here
-├── hardhat.config.js   # Hardhat configuration
-├── .env.example        # Environment variable template
-└── README.md
-\`\`\`
-
----
-
-## Writing Smart Contracts
-
-Place your Solidity files in \`contracts/\`. The config targets Solidity \`0.8.26\` with the Cancun EVM and the optimizer enabled (200 runs).
-
-**Example** — \`contracts/MyContract.sol\`:
-
-\`\`\`solidity
-// SPDX-License-Identifier: MIT
-pragma solidity ^0.8.26;
-
-contract MyContract {
-    // Your logic here
-}
-\`\`\`
-
-### Included libraries
-
-| Package | Use case |
-|---------|----------|
-| \`@openzeppelin/contracts\` | ERC-20, ERC-721, ERC-1155, access control, etc. |
-| \`@openzeppelin/contracts-upgradeable\` | UUPS / Transparent proxy upgradeable variants |
-| \`@openzeppelin/hardhat-upgrades\` | Deploy and upgrade helper tasks |
-| \`@account-abstraction/contracts\` | ERC-4337 interfaces and EntryPoint |
-
----
-
-## Writing Tests
-
-Place test files in \`test/\`. Hardhat ships with Mocha + Chai.
-
-**Example** — \`test/MyContract.test.js\`:
-
-\`\`\`javascript
-const { expect } = require('chai');
-const { ethers } = require('hardhat');
-
-describe('MyContract', function () {
-  it('should deploy successfully', async function () {
-    const MyContract = await ethers.getContractFactory('MyContract');
-    const contract = await MyContract.deploy();
-    expect(await contract.getAddress()).to.not.equal(ethers.ZeroAddress);
-  });
-});
-\`\`\`
-
----
-
-## Writing Deployment Scripts
-
-**Example** — \`scripts/deploy.js\`:
-
-\`\`\`javascript
-const { ethers } = require('hardhat');
-
-async function main() {
-  const [deployer] = await ethers.getSigners();
-  console.log('Deploying from:', deployer.address);
-
-  const MyContract = await ethers.getContractFactory('MyContract');
-  const contract = await MyContract.deploy();
-  await contract.waitForDeployment();
-
-  console.log('MyContract deployed to:', await contract.getAddress());
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exitCode = 1;
-});
-\`\`\`
-
----
-
-## Networks
-
-| Network | RPC | Chain ID |
-|---------|-----|----------|
-| Hardhat (local) | \`http://127.0.0.1:8545\` | 31337 |
-| Sepolia (testnet) | \`SEPOLIA_RPC_URL\` in \`.env\` | 11155111 |
-
----
-
-## Verifying Contracts
-
-\`\`\`bash
-npx hardhat verify --network sepolia <CONTRACT_ADDRESS> <CONSTRUCTOR_ARGS>
-\`\`\`
-
----
-
-## Frontend
-
-The \`frontend/\` folder is a Vite + React app with:
-
-- A sticky navigation bar with a **Connect Wallet** button (MetaMask / EIP-1193)
-- Ethers.js v6 already wired up
-
-### Connecting to a deployed contract
-
-Copy the ABI from \`artifacts/contracts/YourContract.sol/YourContract.json\` and import it:
-
-\`\`\`javascript
-import { BrowserProvider, Contract } from 'ethers';
-import MyContractABI from '../../artifacts/contracts/MyContract.sol/MyContract.json';
-
-const CONTRACT_ADDRESS = '0x...';
-
-async function interact() {
-  const provider = new BrowserProvider(window.ethereum);
-  const signer   = await provider.getSigner();
-  const contract = new Contract(CONTRACT_ADDRESS, MyContractABI.abi, signer);
-  // call contract methods here
-}
-\`\`\`
-
----
-
-## Resources
-
-- [Hardhat Docs](https://hardhat.org/docs)
-- [Solidity Docs](https://docs.soliditylang.org)
-- [OpenZeppelin Docs](https://docs.openzeppelin.com)
-- [EIP-4337 (Account Abstraction)](https://eips.ethereum.org/EIPS/eip-4337)
-- [Ethers.js v6 Docs](https://docs.ethers.org/v6)
-- [Vite Docs](https://vitejs.dev)
-
----
-
-*Built with Africa's Blockchain Club — scaffold your next project with \`npx abc-scaffold\`.*
-`;
-}
-
-function scaffoldFrontend(frontendDir, projectName) {
-  fse.ensureDirSync(path.join(frontendDir, 'src', 'components'));
-  fse.copySync(path.join(TEMPLATES, 'frontend'), frontendDir);
-
-  // Substitute project name in index.html
-  const htmlPath = path.join(frontendDir, 'index.html');
-  const html = fs.readFileSync(htmlPath, 'utf-8').replace(/{{PROJECT_NAME}}/g, projectName);
-  fs.writeFileSync(htmlPath, html);
-
-  logger.success('frontend/ (React + Vite + Connect Wallet)');
-}
-
-export async function scaffold(initialName) {
-  let projectName = initialName;
-
-  if (!projectName) {
-    projectName = await prompt(chalk.bold('? Project name: '));
-  }
-
-  if (!projectName) {
-    logger.error('Project name is required.');
-    process.exit(1);
-  }
-
-  // Normalise: lowercase, spaces → hyphens
-  projectName = projectName.trim().toLowerCase().replace(/\s+/g, '-');
-
-  if (!isValidName(projectName)) {
-    logger.error(`"${projectName}" is not a valid package name. Use lowercase letters, numbers, hyphens, or underscores.`);
-    process.exit(1);
-  }
-
-  const targetDir = path.resolve(process.cwd(), projectName);
-
-  if (fs.existsSync(targetDir)) {
-    logger.error(`Directory "${projectName}" already exists. Choose a different name or delete it first.`);
-    process.exit(1);
-  }
-
-  // ── Create directory structure ──────────────────────────────────────────────
-  logger.step('Creating project structure');
-
-  fs.mkdirSync(targetDir, { recursive: true });
-
-  for (const dir of ['contracts', 'scripts', 'test']) {
-    fs.mkdirSync(path.join(targetDir, dir), { recursive: true });
-    logger.success(`${dir}/`);
-  }
-
-  // ── Copy configuration files ────────────────────────────────────────────────
-  logger.step('Copying configuration files');
-
-  copyTemplate('hardhat.config.js', targetDir);
-  copyTemplate('.env.example', targetDir);
-  copyTemplate('.gitignore', targetDir);
-
-  // package.json — substitute project name
-  const pkgTemplate = fs.readFileSync(path.join(TEMPLATES, 'package.json'), 'utf-8');
-  fs.writeFileSync(
-    path.join(targetDir, 'package.json'),
-    pkgTemplate.replace('"{{PROJECT_NAME}}"', `"${projectName}"`)
-  );
-  logger.success('package.json');
-
-  // ── Generate README ─────────────────────────────────────────────────────────
-  logger.step('Generating README.md');
-  fs.writeFileSync(path.join(targetDir, 'README.md'), buildReadme(projectName));
-  logger.success('README.md');
-
-  // ── Scaffold React frontend ─────────────────────────────────────────────────
-  logger.step('Scaffolding React frontend');
-  scaffoldFrontend(path.join(targetDir, 'frontend'), projectName);
-
-  // ── Done ────────────────────────────────────────────────────────────────────
-  console.log('');
-  console.log(chalk.bold.green('✨  Project scaffolded!'));
-  console.log('');
-  console.log('  Next steps:');
-  console.log(chalk.cyan(`  cd ${projectName}`));
-  console.log(chalk.cyan('  npm install') + chalk.gray('                    # install root dependencies'));
-  console.log(chalk.cyan('  cp .env.example .env') + chalk.gray('           # fill in your keys'));
-  console.log(chalk.cyan('  npm run compile') + chalk.gray('                # compile contracts'));
-  console.log(chalk.cyan('  cd frontend && npm install') + chalk.gray('     # install frontend dependencies'));
-  console.log(chalk.cyan('  npm run dev') + chalk.gray('                    # start the UI'));
-  console.log('');
-  console.log(chalk.gray('  Docs → see README.md'));
-  console.log('');
-}
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { createInterface } from 'readline';
+import fse from 'fs-extra';
+import chalk from 'chalk';
+import * as logger from './logger.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname  = path.dirname(__filename);
+const TEMPLATES  = path.join(__dirname, '..', 'templates');
+
+function prompt(question) {
+  return new Promise((resolve) => {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(question, (answer) => { rl.close(); resolve(answer.trim()); });
+  });
+}
+
+function isValidName(name) {
+  return /^[a-z0-9][a-z0-9\-_]*$/.test(name);
+}
+
+function copyTemplate(filename, targetDir) {
+  fse.copySync(path.join(TEMPLATES, filename), path.join(targetDir, filename));
+  logger.success(filename);
+}
+
+function buildReadme(projectName) {
+  return `# ${projectName}
+
+> Scaffolded with [abc-scaffold](https://github.com/africas-blockchain-club/abc-scaffold) by **Africa's Blockchain Club**
+
+A project-agnostic Hardhat workspace ready for smart contract development, testing, and frontend integration. Build anything — NFTs, DeFi protocols, DAOs, smart accounts, or any on-chain application.
+
+---
+
+## Prerequisites
+
+| Tool | Version |
+|------|---------|
+| Node.js | >= 18.0.0 |
+| npm | >= 9.0.0 |
+| MetaMask | Latest |
+
+---
+
+## Getting Started
+
+### 1. Install dependencies
+
+\`\`\`bash
+npm install
+\`\`\`
+
+### 2. Set up environment variables
+
+\`\`\`bash
+cp .env.example .env
+\`\`\`
+
+Fill in your values in \`.env\`:
+
+- \`SEPOLIA_RPC_URL\` — get one free from [Infura](https://infura.io) or [Alchemy](https://alchemy.com)
+- \`PRIVATE_KEY\` — your deployer wallet private key (**never commit this file**)
+- \`ETHERSCAN_API_KEY\` — for contract verification on [Etherscan](https://etherscan.io)
+
+### 3. Compile contracts
+
+\`\`\`bash
+npm run compile
+\`\`\`
+
+### 4. Run tests
+
+\`\`\`bash
+npm test
+\`\`\`
+
+### 5. Start a local Hardhat node
+
+\`\`\`bash
+npx hardhat node
+\`\`\`
+
+### 6. Deploy contracts locally
+
+\`\`\`bash
+npx hardhat run scripts/deploy.js --network localhost
+\`\`\`
+
+### 7. Start the frontend
+
+\`\`\`bash
+cd frontend
+npm install
+npm run dev
+# → http://localhost:5173
+\`\`\`
+
+---
+
+## Directory Structure
+
+\`\`\`
+${projectName}/
+├── contracts/          # Solidity smart contracts
+├── scripts/            # Deployment and utility scripts
+├── test/               # Hardhat test files
+├── frontend/           # React + Vite frontend
+│   └── src/
+│       ├── App.jsx
+│       └── components/
+│           └── Navbar.jsx   ← Connect Wallet button lives here
+├── hardhat.config.js   # Hardhat configuration
+├── .env.example        # Environment variable template
+└── README.md
+\`\`\`
+
+---
+
+## Writing Smart Contracts
+
+Place your Solidity files in \`contracts/\`. The config targets Solidity \`0.8.26\` with the Cancun EVM and the optimizer enabled (200 runs).
+
+**Example** — \`contracts/MyContract.sol\`:
+
+\`\`\`solidity
+// SPDX-License-Identifier: MIT
+pragma solidity ^0.8.26;
+
+contract MyContract {
+    // Your logic here
+}
+\`\`\`
+
+### Included libraries
+
+| Package | Use case |
+|---------|----------|
+| \`@openzeppelin/contracts\` | ERC-20, ERC-721, ERC-1155, access control, etc. |
+| \`@openzeppelin/contracts-upgradeable\` | UUPS / Transparent proxy upgradeable variants |
+| \`@openzeppelin/hardhat-upgrades\` | Deploy and upgrade helper tasks |
+| \`@account-abstraction/contracts\` | ERC-4337 interfaces and EntryPoint |
+
+---
+
+## Writing Tests
+
+Place test files in \`test/\`. Hardhat ships with Mocha + Chai.
+
+**Example** — \`test/MyContract.test.js\`:
+
+\`\`\`javascript
+const { expect } = require('chai');
+const { ethers } = require('hardhat');
+
+describe('MyContract', function () {
+  it('should deploy successfully', async function () {
+    const MyContract = await ethers.getContractFactory('MyContract');
+    const contract = await MyContract.deploy();
+    expect(await contract.getAddress()).to.not.equal(ethers.ZeroAddress);
+  });
+});
+\`\`\`
+
+---
+
+## Writing Deployment Scripts
+
+**Example** — \`scripts/deploy.js\`:
+
+\`\`\`javascript
+const { ethers } = require('hardhat');
+
+async function main() {
+  const [deployer] = await ethers.getSigners();
+  console.log('Deploying from:', deployer.address);
+
+  const MyContract = await ethers.getContractFactory('MyContract');
+  const contract = await MyContract.deploy();
+  await contract.waitForDeployment();
+
+  console.log('MyContract deployed to:', await contract.getAddress());
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exitCode = 1;
+});
+\`\`\`
+
+---
+
+## Networks
+
+| Network | RPC | Chain ID |
+|---------|-----|----------|
+| Hardhat (local) | \`http://127.0.0.1:8545\` | 31337 |
+| Sepolia (testnet) | \`SEPOLIA_RPC_URL\` in \`.env\` | 11155111 |
+
+---
+
+## Verifying Contracts
+
+\`\`\`bash
+npx hardhat verify --network sepolia <CONTRACT_ADDRESS> <CONSTRUCTOR_ARGS>
+\`\`\`
+
+---
+
+## Frontend
+
+The \`frontend/\` folder is a Vite + React app with:
+
+- A sticky navigation bar with a **Connect Wallet** button (MetaMask / EIP-1193)
+- Ethers.js v6 already wired up
+
+### Connecting to a deployed contract
+
+Copy the ABI from \`artifacts/contracts/YourContract.sol/YourContract.json\` and import it:
+
+\`\`\`javascript
+import { BrowserProvider, Contract } from 'ethers';
+import MyContractABI from '../../artifacts/contracts/MyContract.sol/MyContract.json';
+
+const CONTRACT_ADDRESS = '0x...';
+
+async function interact() {
+  const provider = new BrowserProvider(window.ethereum);
+  const signer   = await provider.getSigner();
+  const contract = new Contract(CONTRACT_ADDRESS, MyContractABI.abi, signer);
+  // call contract methods here
+}
+\`\`\`
+
+---
+
+## Resources
+
+- [Hardhat Docs](https://hardhat.org/docs)
+- [Solidity Docs](https://docs.soliditylang.org)
+- [OpenZeppelin Docs](https://docs.openzeppelin.com)
+- [EIP-4337 (Account Abstraction)](https://eips.ethereum.org/EIPS/eip-4337)
+- [Ethers.js v6 Docs](https://docs.ethers.org/v6)
+- [Vite Docs](https://vitejs.dev)
+
+---
+
+*Built with Africa's Blockchain Club — scaffold your next project with \`npx abc-scaffold\`.*
+`;
+}
+
+function scaffoldFrontend(frontendDir, projectName) {
+  fse.ensureDirSync(path.join(frontendDir, 'src', 'components'));
+  fse.copySync(path.join(TEMPLATES, 'frontend'), frontendDir);
+
+  // Substitute project name in index.html
+  const htmlPath = path.join(frontendDir, 'index.html');
+  const html = fs.readFileSync(htmlPath, 'utf-8').replace(/{{PROJECT_NAME}}/g, projectName);
+  fs.writeFileSync(htmlPath, html);
+
+  logger.success('frontend/ (React + Vite + Connect Wallet)');
+}
+
+export async function scaffold(initialName) {
+  let projectName = initialName;
+
+  if (!projectName) {
+    projectName = await prompt(chalk.bold('? Project name: '));
+  }
+
+  if (!projectName) {
+    logger.error('Project name is required.');
+    process.exit(1);
+  }
+
+  // Normalise: lowercase, spaces → hyphens
+  projectName = projectName.trim().toLowerCase().replace(/\s+/g, '-');
+
+  if (!isValidName(projectName)) {
+    logger.error(`"${projectName}" is not a valid package name. Use lowercase letters, numbers, hyphens, or underscores.`);
+    process.exit(1);
+  }
+
+  const targetDir = path.resolve(process.cwd(), projectName);
+
+  if (fs.existsSync(targetDir)) {
+    logger.error(`Directory "${projectName}" already exists. Choose a different name or delete it first.`);
+    process.exit(1);
+  }
+
+  // ── Create directory structure ──────────────────────────────────────────────
+  logger.step('Creating project structure');
+
+  fs.mkdirSync(targetDir, { recursive: true });
+
+  for (const dir of ['contracts', 'scripts', 'test']) {
+    fs.mkdirSync(path.join(targetDir, dir), { recursive: true });
+    logger.success(`${dir}/`);
+  }
+
+  // ── Copy configuration files ────────────────────────────────────────────────
+  logger.step('Copying configuration files');
+
+  copyTemplate('hardhat.config.js', targetDir);
+
+  // These are stored without a leading dot in templates/ because npm strips
+  // dotfiles when publishing. We restore the dot on copy.
+  fse.copySync(path.join(TEMPLATES, 'env.example'), path.join(targetDir, '.env.example'));
+  logger.success('.env.example');
+  fse.copySync(path.join(TEMPLATES, 'gitignore'), path.join(targetDir, '.gitignore'));
+  logger.success('.gitignore');
+
+  // package.json — substitute project name
+  const pkgTemplate = fs.readFileSync(path.join(TEMPLATES, 'package.json'), 'utf-8');
+  fs.writeFileSync(
+    path.join(targetDir, 'package.json'),
+    pkgTemplate.replace('"{{PROJECT_NAME}}"', `"${projectName}"`)
+  );
+  logger.success('package.json');
+
+  // ── Generate README ─────────────────────────────────────────────────────────
+  logger.step('Generating README.md');
+  fs.writeFileSync(path.join(targetDir, 'README.md'), buildReadme(projectName));
+  logger.success('README.md');
+
+  // ── Scaffold React frontend ─────────────────────────────────────────────────
+  logger.step('Scaffolding React frontend');
+  scaffoldFrontend(path.join(targetDir, 'frontend'), projectName);
+
+  // ── Done ────────────────────────────────────────────────────────────────────
+  console.log('');
+  console.log(chalk.bold.green('✨  Project scaffolded!'));
+  console.log('');
+  console.log('  Next steps:');
+  console.log(chalk.cyan(`  cd ${projectName}`));
+  console.log(chalk.cyan('  npm install') + chalk.gray('                    # install root dependencies'));
+  console.log(chalk.cyan('  cp .env.example .env') + chalk.gray('           # fill in your keys'));
+  console.log(chalk.cyan('  npm run compile') + chalk.gray('                # compile contracts'));
+  console.log(chalk.cyan('  cd frontend && npm install') + chalk.gray('     # install frontend dependencies'));
+  console.log(chalk.cyan('  npm run dev') + chalk.gray('                    # start the UI'));
+  console.log('');
+  console.log(chalk.gray('  Docs → see README.md'));
+  console.log('');
+}

package/templates/{.env.example → env.example}

@@ -1,4 +1,4 @@
-# Example .env file - Duplicate this file to '.env' and fill in your values
-SEPOLIA_RPC_URL="https://sepolia.infura.io/v3/YOUR_INFURA_KEY"
-PRIVATE_KEY="YOUR_WALLET_PRIVATE_KEY"
-ETHERSCAN_API_KEY="YOUR_ETHERSCAN_API_KEY"
+# Example .env file - Duplicate this file to '.env' and fill in your values
+SEPOLIA_RPC_URL="https://sepolia.infura.io/v3/YOUR_INFURA_KEY"
+PRIVATE_KEY="YOUR_WALLET_PRIVATE_KEY"
+ETHERSCAN_API_KEY="YOUR_ETHERSCAN_API_KEY"

package/templates/gitignore

@@ -0,0 +1,11 @@
+node_modules
+.env
+coverage
+coverage.json
+typechain
+typechain-types
+artifacts
+cache
+package-lock.json
+.claude
+CLAUDE.md