Drizzle Truffle Box
This box comes with everything you need to start using smart contracts from a react app with Drizzle. It includes
drizzle-react-components to give you a complete overview of Drizzle's capabilities.
Install Truffle and Ganache CLI globally. If you prefer, the graphical version of Ganache works as well!
npm install -g truffle npm install -g ganache-cli
Download the box. This also takes care of installing the necessary dependencies.
truffle unbox drizzle
Run the development blockchain, we recommend passing in a blocktime. Otherwise, its difficult to track things like loading indicators because Ganache will mine instantly.
// 3 second blocktime. ganache-cli -b 3
Compile and migrate the smart contracts. Note inside the development console we don't preface commands with
Run the webpack server for front-end hot reloading (outside the development console). Smart contract changes must be manually recompiled and migrated.
// Serves the front-end on http://localhost:3000 npm run start
// If inside the development console. test // If outside the development console.. truffle test
Jest is included for testing React components. Compile your contracts before running Jest, or you may receive some file not found errors.
// Run Jest outside of the development console for front-end component tests. npm run test
To build the application for production, use the build command. A production build will be in the build_webpack folder.
npm run build
Where do I find more information about Drizzle?
Why is there both a truffle.js file and a truffle-config.js file?
truffle-config.jsis a copy of
truffle.jsfor compatibility with Windows development environments. Feel free to delete it if it's irrelevant to your platform.
Where is my production build?
The production build will be in the
build_webpackfolder. This is because Truffle outputs contract compilations to the
Where can I find more documentation?
I'm trying to run
truffle unbox drizzlein my CI environment but my build keeps failing. How can I fix it?
We're treating warnings as errors when the env variable
CIis set to
true. If this is affecting your ability to unbox drizzle in your CI environment, you can set the variable
IGNORE_DRIZZLE_BOX_WARNINGS=trueand warnings won't be treated as errors anymore during unboxing.