dokrypt init

Usage

dokrypt init <project-name> [flags]

Arguments

Argument	Required	Description
`project-name`	Yes	Name of the new project directory

Flags

Flag	Type	Default	Description
`-t, --template`	`string`	`evm-basic`	Template to use
`--chain`	`string`	`ethereum`	Chain type
`--engine`	`string`	`anvil`	Node engine (`anvil`, `hardhat`, `geth`)
`--no-git`	`bool`	`false`	Skip git repository initialization
`--dir`	`string`	`.`	Target parent directory

Description

Creates a new project directory with smart contracts, tests, deployment scripts, and a dokrypt.yaml configuration file scaffolded from the selected template. The scaffolding process:

Validates the project name and checks that the target directory doesn’t already exist
Loads the selected template (built-in or installed from marketplace)
Renders all template files, replacing variables like {{ .ProjectName }}, {{ .ChainName }}, {{ .ChainID }}, and {{ .Engine }}
Initializes a git repository (unless --no-git is set)
Displays the created files and next steps

Available Templates

Template	Difficulty	Description
`evm-basic`	Beginner	Counter + ERC-20 starter
`evm-token`	Intermediate	ERC-20, vesting, staking, multisig
`evm-nft`	Intermediate	ERC-721, marketplace, royalties, IPFS
`evm-dao`	Advanced	Governor, timelock, treasury, voting
`evm-defi`	Advanced	AMM, lending, staking, oracle

Examples

Basic project with defaults

dokrypt init my-project

Creates my-project/ with the evm-basic template, Anvil engine, and Ethereum chain.

DeFi project

dokrypt init my-defi-app --template evm-defi

Creates a full DeFi stack with AMM (Factory, Pair, Router), lending vault, staking rewards, and oracle contracts. Configures IPFS, Blockscout, and Chainlink mock services.

NFT project with custom chain

dokrypt init my-nft --template evm-nft --chain polygon --engine hardhat

Skip git initialization

dokrypt init my-project --no-git

Scaffold into a specific directory

dokrypt init my-project --dir /home/user/projects

Output Structure

The created directory structure depends on the template. For evm-basic:

my-project

dokrypt.yaml

foundry.toml

README.md

contracts

Counter.sol

SimpleToken.sol

test

Counter.t.sol

SimpleToken.t.sol

scripts

deploy.js

Errors

Error	Cause	Solution
Directory already exists	Target directory is not empty	Choose a different name or delete the existing directory
Template not found	Template name is invalid	Run `dokrypt template list` to see available templates
Failed to load template	Template filesystem is corrupted	Reinstall Dokrypt or the template

Overview

Project Lifecycle

Blockchain Operations

Testing & CI

Deployment & Verification

Configuration & Templates

System

Usage

Arguments

Flags

Description

Available Templates

Examples

Basic project with defaults

DeFi project

NFT project with custom chain

Skip git initialization

Scaffold into a specific directory

Output Structure

Errors

​Usage

​Arguments

​Flags

​Description

​Available Templates

​Examples

​Basic project with defaults

​DeFi project

​NFT project with custom chain

​Skip git initialization

​Scaffold into a specific directory

​Output Structure

​Errors

Usage

Arguments

Flags

Description

Available Templates

Examples

Basic project with defaults

DeFi project

NFT project with custom chain

Skip git initialization

Scaffold into a specific directory

Output Structure

Errors