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

Dev Preview

Build the ui theme:

$ cd packages/ui
$ yarn build

Build in local

$ cd packages/hardhat-ts
$ yarn chain

Open a new terminal

$ yarn deploy

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

aeither/starter-test