Create thirdweb dApp

The easiest way to get started with thirdweb is by using create-thirdweb-dapp. This CLI tool enables you to quickly start building a new thirdweb application, with everything set up for you. You can create a new app using one the defaults thirdweb templates, or by using one of the official thirdweb examples. To get started, use the following command:

npx create-thirdweb-dapp@latest
# or
yarn create tw-app
# or
pnpm create tw-app

This will prompt you to choose between "Next.js", "Create React App" and "Vite". You can also pass them as a flag:

npx create-thirdweb-dapp --next
# or
npx create-thirdweb-dapp --cra
# or
npx create-thirdweb-dapp --vite

This will also prompt you to choose between TypeScript or JavaScript, you can also pass them as a flag:

npx create-thirdweb-dapp --typescript
# or
npx create-thirdweb-dapp --javascript

You can also use the shortcute --js or --ts.

An example of using both flags at the same time:

npx create-thirdweb-dapp --next --ts`

To create a new app in a specific folder, you can send a name as an argument. For example, the following command will create a new Next.js app called thirdwebb-app in a folder with the same name:

npx create-thirdweb-dapp@latest thirdweb-app
# or
yarn create tw-app thirdweb-app
# or
pnpm create tw-app thirdweb-app

One example of using the --example flag:

npx create-thirdweb-dapp@latest --example custom-minting-page
# or
yarn create tw-app --example custom-minting-page
# or
pnpm create tw-app --example custom-minting-page

Options

create-thirdweb-dapp comes with the following options:

• --ts, --typescript - Initialize as a TypeScript project.
• -e, --example [name]|[github-url] - An example to bootstrap the app with. You can use an example name from the thirdweb-example organization.
• --use-npm - Explicitly tell the CLI to bootstrap the app using npm. To bootstrap using yarn we recommend to run yarn create tw-app
• --use-pnpm - Explicitly tell the CLI to bootstrap the app using pnpm. To bootstrap using pnpm we recommend running pnpm create tw-app

Why use Create thirdweb App?

create-thirdweb-dapp allows you to create a new thirdweb dApp within seconds. It is officially maintained by the creators of thirdweb, and includes a number of benefits:

• Interactive Experience: Running npx create-thirdweb-dapp (with no arguments) launches an interactive experience that guides you through setting up a project.
• Zero Dependencies: Initializing a project is as quick as one second. Create thirdweb dApp has zero dependencies.
• Support for Examples: Create thirdweb dApp can bootstrap your application using an example from the thirdweb examples collection (e.g. npx create-thirdweb-dapp --example contract-hub).

Local Development

The simplest way to work on the CLI locally is to:

1. Install the package locally
2. Run the dev command to compile any changes in realtime $ npm install -g ./ $ yarn dev