Truffle and Gatsby

This box comes with everything you need to start using smart contracts from a Gatsby generated static website.

Installation

First ensure you are in a new and empty directory.

1. Run the unbox command via npx and skip to step 3. This will install all necessary dependencies. A Create-React-App is generated in the client directory.

   npx truffle unbox develo-pera/truffle-gatsby

2. Alternatively, you can install Truffle globally and run the unbox command.

   npm install -g truffle
   truffle unbox develo-pera/truffle-gatsby

3. Run the development console.

   truffle develop

4. Compile and migrate the smart contracts. Note inside the development console we don't preface commands with truffle.

   compile
   migrate

5. In the client directory, we run the React app. Smart contract changes must be manually recompiled and migrated.

   // in another terminal (i.e. not in the truffle develop prompt)
   cd client
   npm run start

6. Truffle can run tests written in Solidity or JavaScript against your smart contracts. Note the command varies slightly if you're in or outside of the development console.

   // inside the development console.
   test
   
   // outside the development console..
   truffle test

7. To build the application for production, use the build script. A production build will be in the client/build folder.

   // ensure you are inside the client directory when running this
   npm run build