Agent skill

Create Vechain Dapp

by vechain in vechain/x-app-template

Scaffold a VeChain dApp with Next.js, VeChain Kit, Chakra UI v3, and GitHub Pages deployment.

MITAuto-check passedDevelopment

Install Create Vechain Dapp

skills CLI
$ npx skills add vechain/x-app-template --skill create-vechain-dapp -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vechain/x-app-template create-vechain-dapp --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vechain/x-app-template.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/create-vechain-dapp .claude/skills/create-vechain-dapp && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
create-vechain-dapp
GitHub stars
450
Token cost
~1.8k tokens
SKILL.md length
753 words
Files
4 (incl. references)
Skills in repo
11
Repo updated
First seen
Licence
MIT

At a glance

Scaffold a VeChain dApp with Next.js, VeChain Kit, Chakra UI v3, and GitHub Pages deployment.

  • Works in 4 steps: Gather requirements → Scaffold → Install and verify → …
  • Creating a new VeChain project
  • SKILL.md covers CRITICAL RULES, Stack, Operating procedure and Success criteria, plus 2 more sections
  • Calls yarn, git and make

What it does

Create Vechain Dapp is an agent skill from vechain/x-app-template. Scaffold a VeChain dApp with Next.js, VeChain Kit, Chakra UI v3, and GitHub Pages deployment. Supports standalone (frontend-only) or monorepo (Turbo + Hardhat contracts) modes. Use when creating a new VeChain project, scaffolding a dApp, setting up a VeChain frontend, or bootstrapping a VeChain monorepo.

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/monorepo.md`, `references/shared.md` and `references/standalone.md`).

It sits in Development, covering Smart contracts, Monorepo tooling and Design systems. It works with GitHub and Next.js. The repository describes itself as: Vechain VeBetterDAO X-App template. The licence is MIT.

When your agent uses it

  • Creating a new VeChain project
  • Scaffolding a dApp
  • Setting up a VeChain frontend
  • Bootstrapping a VeChain monorepo

Example prompts

  • “/create-vechain-dapp”

Requirements

  • Docker

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Gather requirements
  2. Scaffold
  3. Install and verify
  4. Git init

What it can do on your machine

Read from SKILL.md and the folder at commit 8692b6a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • yarn
    • git
    • make
    • nvm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use yarn and git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Create Vechain Dapp loads about 1.8k tokens when it runs, and up to ~16k if it reads all its reference files. Until then it costs about 81 tokens; SKILL.md has 753 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~81
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~16k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vechain/x-app-template at commit 8692b6a, republished under its MIT licence (© vechain). 753 words, ~1,806 tokens.

Download SKILL.mdSave it as .claude/skills/create-vechain-dapp/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
create-vechain-dapp
description
Scaffold a VeChain dApp with Next.js, VeChain Kit, Chakra UI v3, and GitHub Pages deployment. Supports standalone (frontend-only) or monorepo (Turbo + Hardhat contracts) modes. Use when creating a new VeChain project, scaffolding a dApp, setting up a VeChain frontend, or bootstrapping a VeChain monorepo.
license
MIT
metadata.author
VeChain
metadata.version
0.1.0

Create VeChain dApp

Scaffold a production-ready VeChain dApp with wallet connection, dark mode, and GitHub Pages deployment.

CRITICAL RULES

  1. Read reference files FIRST. Based on the user's chosen mode, read the appropriate reference files before creating any files. Briefly mention which files you are reading so the user can confirm the skill is active.
  2. Always read shared.md — it contains the source code templates used by both modes.
  3. Replace all placeholders in every template before writing files. See Variable Substitution below.
  4. After compaction or context loss, re-read this SKILL.md to restore awareness of the reference table and operating procedure.

Stack

LayerTechnology
FrameworkNext.js 14 (App Router, static export)
UIChakra UI v3, next-themes
Wallet@vechain/vechain-kit (VeWorld + WalletConnect)
StateReact Query
ContractsHardhat + @vechain/sdk-hardhat-plugin + OpenZeppelin UUPS (monorepo only)
BuildTurborepo (monorepo only)
DeployGitHub Pages via GitHub Actions
Node20 LTS

Operating procedure

Phase 1 — Gather requirements

Ask the user (use structured questions if available):

  1. Project name — kebab-case (e.g. my-vechain-dapp)
  2. Mode — standalone (frontend only) or monorepo (Turbo + contracts)
  3. Network — test or main (default: test)
  4. Target directory — where to create the project (default: current directory)
Phase 2 — Scaffold

Read the appropriate reference files and create all files.

Standalone mode:

  1. Read references/shared.md
  2. Read references/standalone.md
  3. Create files in {{TARGET_DIR}}/{{PROJECT_NAME}}/

Monorepo mode:

  1. Read references/shared.md
  2. Read references/monorepo.md
  3. Create frontend files in {{TARGET_DIR}}/{{PROJECT_NAME}}/apps/frontend/
  4. Create other files at monorepo root and in packages/
Variable substitution

Replace these placeholders in ALL templates:

PlaceholderValue
{{PROJECT_NAME}}kebab-case project name
{{PROJECT_TITLE}}Title-case project name (for UI display)
{{NETWORK_TYPE}}test or main
Phase 3 — Install and verify
bash
cd {{PROJECT_NAME}}
nvm use
yarn install

Standalone: yarn dev (localhost:3000), yarn build (static export → out/)

Monorepo: make solo-up (start Thor solo node, requires Docker), then yarn dev (auto-deploys contracts to solo), yarn build, yarn contracts:compile, yarn contracts:test. Stop with make solo-down, reset with make solo-clean.

Phase 4 — Git init
bash
git init && git add . && git commit -m "Initial scaffold: VeChain dApp"

Success criteria

  • yarn dev starts without errors
  • Page renders with Navbar and wallet connect button
  • Dark/light mode toggle works
  • yarn build produces static output
  • .github/workflows/deploy.yml is present

Key patterns

Client-only VeChain Kit

VeChain Kit cannot run server-side. The entire app shell (ClientApp) is loaded via dynamic(() => ..., { ssr: false }) in layout.tsx. All VeChain Kit imports inside ClientApp children work normally since the parent is already client-only.

Static export for GitHub Pages

next.config.js uses output: "export" with configurable basePath/assetPrefix via NEXT_PUBLIC_BASE_PATH env var. GitHub Actions defaults to /${{ github.event.repository.name }} for GitHub Pages. Set to empty string for custom domains. Important: metadata.icons and raw <img src> paths do NOT auto-prepend basePath — prefix them manually.

Chakra UI version pinning

Pin @chakra-ui/react to an exact version (currently 3.30.0). VeChain Kit uses Chakra v2 internally, and newer v3 releases can break VeChain Kit's button/modal theming.

Show full SKILL.md (302 more words)Show less
Provider chain

ChakraProvider → ColorModeProvider → QueryClientProvider → VeChainKitProvider → App

Contract architecture (monorepo only)

All contracts in the monorepo scaffold are UUPS upgradeable using OpenZeppelin's upgradeable contracts and a custom VeChainProxy.sol (ERC1967). Key files:

  • scripts/helpers/upgrades.ts — core deploy/upgrade proxy helpers. Copy as-is from the template. All deploy scripts, upgrade scripts, and tests depend on it.
  • contracts/VeChainProxy.sol — ERC1967 proxy contract. Copy as-is.
  • scripts/deploy/deploy.ts — production deployment using deployProxy from helpers.
  • scripts/upgrade/ — interactive CLI upgrade system with versioned config registry.

For contract architecture, upgrade patterns, storage safety, security, and testing — follow the smart-contract-development skill. It is the authoritative reference for all Solidity development patterns on VeChain.

Config package and auto-deployment (monorepo only)

The monorepo uses a packages/config package that centralizes contract addresses and network settings per environment. Key mechanics:

  • local.ts is git-ignored — each dev's solo deployment produces different addresses. A mock is auto-generated on first run.
  • NEXT_PUBLIC_APP_ENV controls which config file is loaded (local, testnet, mainnet).
  • yarn dev runs against solo, yarn dev:testnet against testnet, yarn dev:mainnet against mainnet.
  • Turbo pipeline ensures: generate mock config → compile contracts → check/deploy on target network → write addresses to matching config file → start frontend.
  • checkContractsDeployment.ts runs before dev for any environment — if contracts aren't deployed, it deploys them and writes addresses to the correct config file (local.ts, testnet.ts, or mainnet.ts).
VeChain Kit integration
  • VeChainKitProvider wraps the app with network config and wallet options
  • WalletButton from vechain-kit renders the connect/account button
  • useWallet, useSendTransaction, useCallClause for wallet/contract interaction
  • Refer to the vechain-kit skill for advanced patterns (hooks, theming, social login)
  • Refer to the vechain-core skill for SDK patterns (fee delegation, multi-clause)

Reference files

Read the matching files BEFORE creating any files. See Critical Rules above.

TopicFileRead when...
Shared source codereferences/shared.mdAlways — contains all component/provider templates
Standalone configreferences/standalone.mdUser chose standalone mode (frontend only)
Monorepo configreferences/monorepo.mdUser chose monorepo mode (Turbo + contracts)

© vechain, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in .agents/skills/create-vechain-dapp of vechain/x-app-template.

  • SKILL.md
  • references/monorepo.md
  • references/shared.md
  • references/standalone.md

Open the folder on GitHubat commit 8692b6a

Compare with similar skills

Create Vechain Dapp next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Create Vechain Dapp compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Create Vechain Dapp this skillvechain/x-app-template450—~1.8kAutomated safety check: PassMIT
Scaffold Nextjsmblode/agent-skills144—~2.8kAutomated safety check: PassMIT
Linea Dependency MaintenanceConsensys-Incorporated/linea-attestation-registry1771 repos~3.7kAutomated safety check: WarnMIT
Scaffold ProjectMarve10s/Better-Fullstack754—~716Automated safety check: PassMIT
Project Scaffoldingaiskillstore/marketplace430—~2kAutomated safety check: PassNone
Prepare Cloudflare Production DeploymentLubomirGeorgiev/cloudflare-workers-nextjs-saas-template786—~5.9kAutomated safety check: NotesMIT

Similar skills

  • Scaffold Nextjs

    mblode/agent-skills

    Scaffolds a Next.js turborepo with Blode UI, icons, Ultracite (oxlint/shadcn), workspace hooks, and GitHub/Vercel setup.

    144 GitHub stars~2.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Linea Dependency Maintenance

    Consensys-Incorporated/linea-attestation-registry

    Safely plan and execute dependency maintenance for JavaScript/TypeScript (npm, pnpm) and GitHub Actions, including npm lockfiles, pnpm workspaces, catalogs, overrides, SHA-pinned action versions…

    177 GitHub starsUsed in 1 repo~3.7k tokens
    DevelopmentAuto-check: warnings
  • Scaffold Project

    Marve10s/Better-Fullstack

    Scaffold a new app, API, backend, fullstack project, mobile app, polyglot service, monorepo, or starter with Better Fullstack.

    754 GitHub stars~716 tokensUpdated today
    DevelopmentAuto-check passed
  • Project Scaffolding

    aiskillstore/marketplace

    IDE-grade project scaffolding wizard for creating new projects with comprehensive configuration.

    430 GitHub stars~2k tokensUpdated today
    DevelopmentAuto-check passed
  • Prepare Cloudflare Production Deployment

    LubomirGeorgiev/cloudflare-workers-nextjs-saas-template

    Source-of-truth runbook for preparing this Vinext Cloudflare Workers SaaS template for production deployment.

    786 GitHub stars~5.9k tokensUpdated 2 days ago
    DevOps & CloudAuto-check: notes
  • New Config

    lidofinance/diffyscan

    Creates or extends a Diffyscan verification config for a deployed contract or deployment.

    142 GitHub stars~1k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed

More from vechain/x-app-template

All 11 skills in this repo
  • Secure GitHub Actions

    vechain/x-app-template

    Secure GitHub Actions workflows against supply-chain, privilege, and shell-injection risks.

    450 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Translate

    vechain/x-app-template

    Manages translation files for react-i18next. An agent skill from vechain/x-app-template.

    450 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Frontend

    vechain/x-app-template

    Generic frontend development patterns for VeChain dApps — React Query, Turborepo architecture, state management, Chakra UI, i18n, loading states, and transaction UX.

    450 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Smart Contract Development

    vechain/x-app-template

    Solidity smart contract development on VeChainThor — Hardhat setup, ERC-20/721 patterns, upgradeable contracts, gas optimization, testing with Thor Solo, security auditing, and ABI codegen.

    450 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Vebetterdao

    vechain/x-app-template

    VeBetterDAO and X2Earn app development — B3TR/VOT3 tokens, reward distribution, sustainability proofs, app submission, governance, VeVote, quadratic funding, B3MO Quests, and navigators.

    450 GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Vechain Core

    vechain/x-app-template

    Core VeChain development — SDK usage, fee delegation (VIP-191), multi-clause transactions, dual-token model, legacy migration, and general VeChainThor development patterns.

    450 GitHub stars~1.2k tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about Create Vechain Dapp

What does Create Vechain Dapp do?

Scaffold a VeChain dApp with Next.js, VeChain Kit, Chakra UI v3, and GitHub Pages deployment. Create Vechain Dapp is an agent skill from vechain/x-app-template.js, VeChain Kit, Chakra UI v3, and GitHub Pages deployment.

When should I use Create Vechain Dapp?

Create Vechain Dapp fits situations like: creating a new VeChain project; scaffolding a dApp; setting up a VeChain frontend; bootstrapping a VeChain monorepo.

How do I install Create Vechain Dapp in Claude Code?

Run `npx skills add vechain/x-app-template --skill create-vechain-dapp -a claude-code`. Or copy the skill folder (.agents/skills/create-vechain-dapp in vechain/x-app-template) into .claude/skills/create-vechain-dapp in your project. Claude Code loads it when a task matches its description.

How do I install Create Vechain Dapp in Codex?

Run `npx skills add vechain/x-app-template --skill create-vechain-dapp -a codex`. Or copy the skill folder (.agents/skills/create-vechain-dapp in vechain/x-app-template) into .agents/skills/create-vechain-dapp in your project. Codex loads it when a task matches its description.

Can I use Create Vechain Dapp in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vechain/x-app-template --skill create-vechain-dapp -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/create-vechain-dapp, .gemini/skills/create-vechain-dapp, .github/skills/create-vechain-dapp and .opencode/skills/create-vechain-dapp in your project.

What does Create Vechain Dapp need to run?

Going by SKILL.md and its folder, Create Vechain Dapp needs the command-line tools its instructions call (yarn, git, make and nvm). Our summary lists: Docker.

Does Create Vechain Dapp access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Create Vechain Dapp safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Create Vechain Dapp use?

Create Vechain Dapp is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Create Vechain Dapp use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 14k tokens, read only when the agent opens those files.

What are the alternatives to Create Vechain Dapp?

Skills that share tags, products or a category with Create Vechain Dapp: Scaffold Nextjs (mblode/agent-skills, 144 stars), Linea Dependency Maintenance (Consensys-Incorporated/linea-attestation-registry, 177 stars), Scaffold Project (Marve10s/Better-Fullstack, 754 stars) and Project Scaffolding (aiskillstore/marketplace, 430 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Create Vechain Dapp?

vechain (a GitHub organization) maintains it in vechain/x-app-template, which has 450 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on July 20, 2026.

Source: vechain/x-app-template on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.