Skip to content

Latest commit

 

History

History
300 lines (215 loc) · 10.1 KB

README.md

File metadata and controls

300 lines (215 loc) · 10.1 KB



Everything you need to create Web3 Dapps in 4 minutes.

Stargazers Forks Contributors Issues MIT License

This package includes the global command to start the Create Web3 DApp CLI builder.

Please refer to this package's documentation and the following links for an in depth explanation:

  • Docs - Everything you need to know when using CW3D
  • GitHub - look at the extensive code example or start contributing
  • Website - Learn more about CW3D and add components to your project
  • Templates - Check out the pre-built project templates
  • Components Library - Add features directly to your project through components
  • Examples - See the components implemented in a real world dapp
  • Community - Meet other builders, get support, and give feedback!

What is create-web3-dapp?

create-web3-dapp is an npx tool that allows developers to create web3 applications in ~4 minutes.

The dapp created with create-web3-dapp are NextJS-based, and compatible with the most used blockchains such as Ethereum, Polygon, Polygon zkEVM, Optimism, Arbitrum, and Solana. Create-web3-dapp allows web3 developers to build production-ready decentralized applications at lightning speed, using pre-made React components, webhooks, and APIs.

No complicated configuration or folder structures, only the files you need to build your Dapp.

templates



Usage

npx create-web3-dapp@latest

If you've previously installed create-web3-dapp globally via npx create-web3-dapp, the CLI builder will notify you if a new version has been released. In any case, we suggest you to run using the latest available version by running npx create-web3-dapp@latest.

(npx comes with npm 5.2+ and higher, see instructions for older npm versions)



Quick Start

To create a new app:

  1. In your terminal run:
  npx create-web3-dapp@latest
  1. Select and create the dependencies, components, and contracts you want to include in your web3 application.

Create web3 dapp will then create a directory containing the files to kickstart your project and install the install dependencies you'll need

npx create-web3-dapp@latest
cd my-create-web3-dapp
npm run dev

In case you've installed a blockchain development environment, navigate to the frontend folder before running npm run dev.

Now navigate on http://localhost:3000/ to see your dapp.

Next, learn how to add a web3 ready component from the create-web3-dapp library.



Smart Contracts Backpack - CLI Smart Contract creator

Create web3 dapp doesn't only set up your blockchain development environment, that to the built-in smart contracts backpack it also allows to create fully fledged Solidity Smart Contracts directly from the CLI.

Note: This will work only if you have installed a blockchain development environment

The smart contracts backpack can create audited smart contracts, deployment scripts and tests, of one of the following standards:

  • ERC721: NFT collection smart contract
  • ERC20: Crypto currency smart contract
  • ERC1155: Fungibility agnosting smart contract

Learn more on how to create, build and deploy, the smart contracts backpack in the docs.



Web3 React Components Library

Create web3 dapp allows developers to prototype their dapps in minutes thanks to a full library of responsive, production ready, web3 React components.

Note: The components work best inside create-web3-dapp projects, but are compatible with any NextJS project.

Use the following links to learn how to implement the components in the library:

  • Docs: a brokendown guide for every component
  • Github: see the components implemented in a real-world project

component


Example implementation:

  1. In /components create nftCreator.jsx
  2. In/styles create NftCreator.module.css
  3. In /pages/apicreatepinFileToIpfs.jspinJsonToIpfs.js
  4. Copy the corresponding code below into each of the created files above.
  5. Import the NftCreator component at the top of your page:

import styles from "../styles/Home.module.css";
import NftCreator from "../components/nft-creator";
import contract from "../abis/smartContractAbi.json";

export default function Home() {
	return (
		<div>
			<main className={styles.main}>
				<NftCreator
					abi={contract.abi}
					contractAddress={
						"0x9FaCAf075Cda7C0947DA0F0B4164332e01422E97"
					}
				/>
			</main>
		</div>
	);
}

More components? Check detailed instructions on the Docs.



Dapp Templates Library

Create web3 dapp gives you access to a library of production ready, web3 applications to kickstart your project with. NFTs Explorer, and much more coming soon.

The templates are available for developers to use as is, or they can be customized to fit the needs of their particular project.

Note: keeping dependencies to the minimum, and the code lean is our top priority, this to grant the templates, full customisability.

Use the following links to learn how to kickstart your dapp using the templates library:


templates




Folder Structure

create-web3-dapp has two folders structures, based on the presence of a blockchain development environment, or not.

With Blockchain Development Environment

📦Root
 ┣ 📂components
 ┃ ┣ 📂navigation
 ┃ ┃ ┗ 📜navbar.jsx
 ┃ ┗ 📜InstructionsComponent.jsx
 ┣ 📂layout
 ┃ ┗ 📜mainLayout.jsx
 ┣ 📂pages
 ┃ ┣ 📂api
 ┃ ┣ 📜_app.js
 ┃ ┗ 📜index.jsx
 ┣ 📂public
 ┃ ┗ 📜alchemy_logo.svg
 ┣ 📂styles
 ┃ ┣ 📜Home.module.css
 ┃ ┣ 📜Navbar.module.css
 ┃ ┣ 📜InstructionsComponent.module.css
 ┃ ┗ 📜globals.css
 ┣ 📜.env.local
 ┣ 📜.gitignore
 ┣ 📜next.config.js
 ┣ 📜package-lock.json
 ┗ 📜package.json

Without Blockchain Development Environment

📦Root
 ┣ 📂.vscode
 ┃ ┗ 📜settings.json
 ┣ 📂backend
 ┃ ┣ 📂contracts
 ┃ ┃ ┗ 📜MyContract.sol
 ┃ ┣ 📂scripts
 ┃ ┃ ┗ 📜MyContract_deploy.js
 ┃ ┣ 📂test
 ┃ ┃ ┗ 📜Lock.js
 ┃ ┣ 📜.env.local
 ┃ ┣ 📜hardhat.config.js
 ┃ ┣ 📜package-lock.json
 ┃ ┗ 📜package.json
 ┣ 📂frontend
 ┃┣ 📂components
 ┃ ┃┣ 📂navigation
 ┃ ┃ ┗ 📜navbar.jsx
 ┃  ┃┗ 📜InstructionsComponent.jsx
 ┃┣ 📂layout
 ┃┃ ┗ 📜mainLayout.jsx
 ┃┣ 📂pages
 ┃┃ ┣ 📂api
 ┃┃ ┣ 📜_app.js
 ┃┃ ┗ 📜index.jsx
 ┃┣ 📂public
 ┃┃ ┗ 📜alchemy_logo.svg
 ┃┣ 📂styles
 ┃┃ ┣ 📜Home.module.css
 ┃┃ ┣ 📜Navbar.module.css
 ┃┃ ┣ 📜InstructionsComponent.module.css
 ┃┃ ┗ 📜globals.css
 ┃┣ 📜.env.local
 ┃┣ 📜.gitignore
 ┃┣ 📜next.config.js
 ┃ ┣ 📜package-lock.json
 ┃ ┗ 📜package.json
 ┣ 📜.DS_Store
 ┣ 📜.env.local
 ┣ 📜.gitignore
 ┣ 📜LICENSE
 ┗ 📜README.md

Credits

This project exists thanks to all the people who contribute.

Acknowledgements

We are grateful to the authors of existing related projects for their ideas and collaboration:

License

Create React App is open source software licensed as GNU-AGPL.