DAOhaus is a platform for summoning and managing Moloch DAOs. We've worked to reimagine our platform into multiple apps, libraries, and microservices. We're using a monorepo to streamline the development of all of these elements, and we used Nx to scaffold our monorepo.
If you'd like to join our community, we coordinate on Discord.
This is the 2nd version of this monorepo - several community members contributed to the development of this codebase. Contributions and fuller githistory can be seen in the original/deprecated repo.
Our monorepo follows the recommended Nx structure with apps
and libs
folders. The apps
folder contains our core applications, subgraphs, and infrastructure jobs. The libs
has our utilities, librarires, and infrastructure resources.
Our applications in the apps
folder are our DAO infrastructure and leverage our libraries, subgraphs, and contracts. Currently, we have two categories for these applications:
Our libraries in the libs
folder are structured to be consumed by our apps as well as used by external developers using our tooling. Currently, we have three categories of libraries:
Our monorepos use Nx as a build system and for scaffolding. If this your first time using Nx, you'll have to install it globally on your system:
npm install -g nx
Here is a basic guide. Each package README (and project.json
) will have more details about commands within each package.
`git clone git@github.com:HausDAO/daohaus-monorepo.git` or `git@github.com:HausDAO/daohaus-monorepo.git`
# clone the entire monorepo at the top level on the develop branch
`nvm use`
# switch to node 16.16.0
`yarn global add nx`
# download nx globally for running nx commands
`yarn`
# run yarn to install all of the packages and dependencies
Once cloned and everything is installed, you'll be able to run each package! Package-level commands are run with nx run
instead of yarn
-- this may be new if you're used to working in a different monorepo structure. Each package has similar command structure, but some packages have additional commands.
The package-level commands can be found in each package's project.json
.
# run a specific package locally (usually on localhost:3000)
# such as the component library or frontend applications
nx run app-name:serve
# example to run the Admin app:
nx run core-app:serve
# lint a specific package
nx run app-name:lint
# example to lint the Hub app:
nx run hub-app:lint
# build a specific package:
nx run app-name:build
# example to build the Hub app:
nx run hub-app:build
We've created generators that leverage nx
with predetermined option flags.
Our stack uses Rollup as our React build tool. This generator will scaffold a new React app.
nx g @nrwl/react:app my-new-app
TypeScript is enabled and included by default.
Our stack uses Rollup as our React build tool. This generator will scaffold a new React library (such as a component library).
nx g @nrwl/react:lib my-new-lib --publishable --importPath @myorg/my-new-lib
TypeScript is enabled and included by default.
Notes: - use the --publishable
flag for external libraries - use the --buildable
flag for internal libraries
npx nx generate @nrwl/js:library my-new-lib --publishable --importPath @daohaus/my-new-lib
Notes: - use the --publishable
flag for external libraries - use the --buildable
flag for internal libraries