A truffle box containing React, ZeppelinOS, OpenZeppelin, Truffle and Infura.
This box comes with everything you need to start using upgradeable Smart contracts inside your applications. It also includes all the configuration required to deploy to different networks.
Install ZeppelinOS, Ganache, and Truffle
npm install -g truffle@5.0.2 ganache-cli@6.3.0 zos@2.2.0
First ensure you are in a new and empty directory.
Run the unbox
command.
truffle unbox zeppelinos/zepkit
Run your local blockchain unlocking your first account:
ganache-cli --secure -u 0 -u 1 -u 2 --deterministic
Initialize the zeppelin os project
zos init zepkit
In the client
directory, we run the React app.
// in another terminal (i.e. not in the truffle develop prompt)
cd client
npm run start
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
Jest is included for testing React components. Compile your contracts before running Jest, or you may receive some file not found errors.
// ensure you are inside the client directory when running this
npm run test
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
-
How do I use this with the Ganache-CLI?
It's as easy as modifying the config file! Check out our documentation on adding network configurations. Depending on the port you're using, you'll also need to update line 29 of
client/src/utils/getWeb3.js
. -
Where is my production build?
The production build will be in the
client/build
folder after runningnpm run build
in theclient
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!