Fuel dApp Template ⛽🌴

The best way to get started building decentralized applications on Fuel! Built using NextJS, DaisyUI, Forc, Sway and Typescript.

Out-of-the-box local toolchain & wallet setup
Easily deploy your smart contract in Sway to your local toolchain or the Fuel Beta-2 testnet
Customizable frontend built using Tailwind CSS

QuickStart

Prerequisites

Node.js v16.15.0 or newer
Yarn
Git
Rust, Cargo and Forc (explained in the installation section)

Installation

Install the Rust toolchain by following the steps here
The Fuel toolchain is required to compile Sway contracts & run them on the FuelVM. Install the Fuel toolchain by the command below; you can also find the steps here

$curl --proto '=https' --tlsv1.2 -sSf \ https://fuellabs.github.io/fuelup/fuelup-init.sh | sh
The beta-2 network is the second public Fuel testnet. Install the beta-2 toolchain by using the following command: fuelup toolchain install beta-2

Getting started

Clone this repo & install dependencies:

git clone https://github.com/edakturk14/fuel-starter-kit.git
cd fuel-starter-kit
yarn install

Local Deployments

Start the fuel chain locally

yarn fuel:chain

Deploy the example contract locally. You'll see the contract ID on the terminal, make sure to save it.

yarn fuel:deploy:local

Update the Contract ID on .env.development in the nextjs folder.

# The target contract you want to interact with
NEXT_PUBLIC_CONTRACT_ID=<YOUR_CONTRACT_ID>

Start your app & visit http://localhost:3000

yarn next:start

Testnet deployments:

For a testnet deployment, you'll need a tesnet account. To generate a testnet wallet, follow the steps here
Deploy the example contract to the Fuel Beta-2 testnet

yarn fuel:deploy:testnet

The command will prompt you to sign the transaction. To get a signature, open a another terminal and use the following command to generate a signature:

forc-wallet sign TRANSACTION_ID ACCOUNT_INDEX

Copy the signature from the previous terminal and paste it into your current terminal window. Then, press enter to execute the signature.

If everything goes well, the contract will be deployed to the testnet, and you'll see the contract ID and block number displayed on the terminal.

Update .env.development in the nextjs folder.

NEXT_PUBLIC_NETWORK=testnet
NEXT_PUBLIC_WALLET_SECRET (you can use the same account used for the deployment. Get the secret with forc wallet export --account-index 0)
NEXT_PUBLIC_CONTRACT_ID (you will need to add 0x in the beginning of the contract-id)

Start your app & visit http://localhost:3000

yarn next:start

redk4n / fuel-dapp-template