create-web3-dapp-grg
v1.0.0
Published
<p align="center"> <br /> <a href="https://createweb3dapp.alchemy.com"> <img src=".github/images/cw3d-logo.png" width="200" alt=""/></a> <br /> </p>
Downloads
23
Maintainers
Readme
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.
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:
- In your terminal run:
npx create-web3-dapp@latest
- 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.
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.
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
Example implementation:
- In /components create nftCreator.jsx
- In/styles create NftCreator.module.css
- In /pages/apicreatepinFileToIpfs.jspinJsonToIpfs.js
- Copy the corresponding code below into each of the created files above.
- 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.
Use the following links to learn how to kickstart your dapp using the templates library:
- Templates Docs
- Templates Library
- Github(coming soon)
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.