Skip to content
Aptos Docs

create-aptos-dapp

create-aptos-dapp builds a template project for dapp developers to easily create a front-end and a smart contract on the Aptos network.

Why use create-aptos-dapp?

Section titled “Why use create-aptos-dapp?”
  • Templated Setup: create-aptos-dapp generates predefined end-to-end dapp templates and configuration files for you. It saves manual setup of the project structure, which can be time-consuming and error-prone.
  • Contract Directory: create-aptos-dapp generates a contract directory that includes the basic structure for Move smart contract modules.
  • Best Practices: create-aptos-dapp incorporates best practices and structure recommendations to develop for the Aptos network.
  • Built-in Move Commands: create-aptos-dapp includes built-in commands for common tasks, such as initializing the Move compiler, compiling, and publishing smart contracts on-chain.

Prerequisites

Section titled “Prerequisites”

Using create-aptos-dapp

Section titled “Using create-aptos-dapp”

  1. Navigate to the directory you want to work in.

    Terminal window
    cd your/workspace

  2. Install create-aptos-dapp.

    Terminal window
    npx create-aptos-dapp@latest

  3. Follow the CLI prompts.

    After installing, you will need to answer several questions about your project including:

    1. The project’s name
    2. Which template to use (see below)
    3. Whether to use Mainnet or Devnet for testing

    cad

Templates

Section titled “Templates”

create-aptos-dapp provides you with premade end-to-end dapp templates, i.e. a ready dapp with configurations and a beautiful UI to get you started with creating a dapp on Aptos.

The goals of the templates are to:

  1. Familiarize users with different Aptos Standards by having an end-to-end dapp template examples.
  2. Educate users on how to build a dapp on Aptos from the front-end layer to the smart contract layer and how everything in-between.
  3. Provide users with pre-made templates to quickly deploy simple dapps

Current Templates

Section titled “Current Templates”

All current templates are available on Aptos Learn. Read more about specific templates below:

Tools create-aptos-dapp utilizes

Section titled “Tools create-aptos-dapp utilizes”
  • React framework
  • Vite development tool
  • shadcn/ui + tailwind for styling
  • Aptos TS SDK
  • Aptos Wallet Adapter
  • Node based Move commands