scaffold-moonshot-starter

Typescript x NestJS x NextJS x Chakra-UI scaffold-eth production ready starter kit.

Tech stack overview

We are using TypeScript with Next.js on the front-end, and NestJS on the back-end. Ceramic is our main data store in conjunction with Filecoin & IPFS for file storage.

📁 Folder structure

.
├── packages # Monorepo using yarn workspaces & lerna
│ ├── web # Landing page using NextJS, TypeScript, Chakra-UI
│ ├── dapp # Web3, decentralized app using NextJS, TypeScript, Chakra-UI and ethers.js
│ ├── ui # Theme/design system shared accross web & dapp folders
│ ├── schemas # Ceramic and JSON schemas
│ ├── hardhat # Your contracts, using Hardhat with Typechain and ethers v5
│ └── server # TypeScript NodeJS server using NestJS as a production ready back-end framework
└── ... config ...

🏄‍♂️ Quick Start

Prerequisites

• Node
• Yarn
• Git
• Account and API key for WEB3.storage

Setup env

In each package individually, create your .env files by copying the .example.env and fill in the empty values.

$ cd packages/[dapp, hardhat and schemas]
$ cp .example.env .env

Create API Key

Go to https://web3.storage and set the value of WEB3STORAGE_TOKEN with your web3.storage API key.

Clone the starter

$ git clone https://github.com/moonshotcollective/scaffold-moonshot-starter.git

install dependencies

$ cd scaffold-moonshot-starter && yarn install

🏺‍ Publish your Ceramic schemas

$ cd packages/schemas
$ yarn build

🛰 Run the backend

$ cd packages/server && yarn start:dev

👷‍ Build it!

run hardhat locally, get some faucet and 🛰 deploy your contract Create a mnemonic.secret file or set one of your dev private key as the DEPLOYER_PRIVATE_KEY environment variables in packages/hardhat/.env

$ cd packages/hardhat
$ yarn chain
$ yarn faucet <YOUR_DEV_ADDRESS>

Deploying on localhost
$ yarn deploy --network localhost --reset

Deploying on mumbai
$ yarn deploy --network mumbai --reset

Deploying on an other testnet (make sure to edit the hardhat.config.js first)
$ yarn deploy --network mytestnet --reset

Testnet Faucets

• Kovan
• Mumbai
• Rinkeby
• BSC

Dev Preview

Start the 📱 dApp:

$ cd packages/dapp
$ yarn dev

Start the 📱 landing page:

(Optional, doesn't need anything else to run)

$ cd packages/web
$ yarn dev