So this box is a fork of the origional Drizzle Truffle Box. It comes with everything described below plus a few extra tests and acts as an example of how to plugin to an Azure DevOps Pipeline. See the section on Remote DevOps
for instructions on how to connect your github repo to an Azure Pipeline.
This box comes with everything you need to start using smart contracts from a react app with Drizzle. It includes drizzle
, drizzle-react
and 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.
mkdir dapp-starter cd dapp-starter truffle unbox dleonard00/dapp-starter
-
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, in a seperate terminal window. Note inside the truffle development console we don't preface commands with
truffle
.truffle console compile migrate
-
Run the webpack server for front-end hot reloading (outside the truffle development console). Smart contract changes must be manually recompiled and migrated.
// Serves the front-end on http://localhost:3000 npm run start
If you see an error message with the 🦊 fox. Ensure your metamask account is unlocked and you select
Localhost 8545
/Private Network
as the network provider. -
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.
// 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
Prerequisite: Ensure truffle is a dev dependency. If you pulled this repo then you can skip this step.
npm install truffle --save-dev
https://github.com/marketplace/azure-pipelines
located in
./azure-pipelines.yml
\
- From the Azure devops dashboard select "Builds" in the left menu.
- Select your pipeline
- In the dropdown menu click "Status Badge"
- Copy the markdown generated for you.
- Commit the badge to your
README.md
-
Where do I find more information about Drizzle?
Check out our documentation or any of the three repositories (
drizzle
,drizzle-react
,drizzle-react-components
). -
Why is there both a truffle.js file and a truffle-config.js file?
truffle-config.js
is a copy oftruffle.js
for 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_webpack
folder. This is because Truffle outputs contract compilations to thebuild
folder. -
Where can I find more documentation?
This box is a marriage of Truffle and a React setup created with create-react-app. Either one would be a great place to start!