/community

A collection of documents and resources relating to initiatives from the Community Development group at MakerDAO.

Primary LanguageJavaScriptGNU Affero General Public License v3.0AGPL-3.0

All Contributors

Gatsby ❀️ Dai

Community at Maker

The Maker Foundation Community Development team began with a mandate to directly foster the growth of the MakerDAO ecosystem by focusing on our community’s most motivated members. We launched a series of initiatives that encouraged people to participate in, and contribute to, the success of the Dai Stablecoin. With the dissolution of the Maker Foundation and Community Development, these programs are now sunset and archived. Anyone interested in learning more about the programs can visit Archives tag in the Community repo.

One of the Community Development projects is the community portal, a community developed resource, built and maintained by MakerDAO community members. Below are instructions on getting started with the portal, which is built with Gatsby and DAI UI.

Portal

πŸš€ Setting Up Local Environments

We've built this as a Theme-UI Gatsby starter for projects that will use Dai-UI theme kits.

See the official Dai-UI repo for more in-depth information.

  1. Clone

    git clone https://github.com/makerdao/community.git
  2. Install dai-ui-theme-maker and dai-ui-icons are pre-installed. This project makes use of yarn. You'll likely need to use npm to get everything setup once cloned.

    # This project makes use of yarn.
    yarn

    PREREQUISITES: You need to have these dependencies installed before the "yarn" command. β—‹ https://brew.sh/ β—‹ https://nodejs.org/en/ β—‹ https://yarnpkg.com/

  3. Start

     yarn start
  4. Open the source code and start editing!

    Your site is now running at http://localhost:8000!

    Note: You'll also see a second link: http://localhost:8000/___graphql. This is a tool you can use to experiment with querying your data. Learn more about using this tool in the Gatsby tutorial.

🧐 What's inside?

A quick look at some important files and directories you'll see in this project.

.
β”œβ”€β”€ node_modules
β”œβ”€β”€ src
|    β”œβ”€β”€ gatsby-plugin-theme-ui
|    β”œβ”€β”€ images
|    β”œβ”€β”€ modules
|    └── pages
β”œβ”€β”€ .gitignore
β”œβ”€β”€ .prettierrc
β”œβ”€β”€ gatsby-browser.js
β”œβ”€β”€ gatsby-config.js
β”œβ”€β”€ gatsby-node.js
β”œβ”€β”€ gatsby-ssr.js
β”œβ”€β”€ LICENSE
β”œβ”€β”€ package-lock.json
β”œβ”€β”€ package.json
└── README.md

Important Directories

  1. src/gatsby-plugin-theme-ui: This directory contains all files that will be consumed by the gatsby-plugin-theme-ui on build and provided to components through context. For more info see their docs.

  2. src/modules: This directory is the mirror image of a components folder. Except it's organized by contextual focused. You can find all your ui related components in the ui folder.

Gatsby Usual Suspects

  1. /node_modules: This directory contains all of the modules of code that your project depends on (npm packages) are automatically installed.

  2. /src: This directory will contain all of the code related to what you will see on the front-end of your site (what you see in the browser) such as your site header or a page template. src is a convention for β€œsource code”.

  3. .gitignore: This file tells git which files it should not track / not maintain a version history for.

  4. .prettierrc: This is a configuration file for Prettier. Prettier is a tool to help keep the formatting of your code consistent.

  5. gatsby-browser.js: This file is where Gatsby expects to find any usage of the Gatsby browser APIs (if any). These allow customization/extension of default Gatsby settings affecting the browser.

  6. gatsby-config.js: This is the main configuration file for a Gatsby site. This is where you can specify information about your site (metadata) like the site title and description, which Gatsby plugins you’d like to include, etc. (Check out the config docs for more detail).

  7. gatsby-node.js: This file is where Gatsby expects to find any usage of the Gatsby Node APIs (if any). These allow customization/extension of default Gatsby settings affecting pieces of the site build process.

  8. gatsby-ssr.js: This file is where Gatsby expects to find any usage of the Gatsby server-side rendering APIs (if any). These allow customization of default Gatsby settings affecting server-side rendering.

  9. LICENSE: Gatsby is licensed under the MIT license.

  10. package-lock.json (See package.json below, first). This is an automatically generated file based on the exact versions of your npm dependencies that were installed for your project. (You won’t change this file directly).

  11. package.json: A manifest file for Node.js projects, which includes things like metadata (the project’s name, author, etc). This manifest is how npm knows which packages to install for your project.

  12. README.md: A text file containing useful reference information about your project.

❀️ Made with Love

Dai-UI - MakerDAO's Dai-UI Team

This Starter - @Maximum_Crash and @andytudhope

Contributors ✨

Thanks goes to these wonderful people (emoji key):


RΓ©jon Taylor-Foster

πŸ’» 🎨 πŸ’‘

Amy Jung

🎨 πŸ“– 🚧 πŸ§‘β€πŸ« πŸ‘€ πŸ’΅ πŸ“† πŸ§‘β€πŸ« πŸ“Ή

Davidutro

πŸ“– πŸ–‹ πŸ“† πŸ€” πŸ§‘β€πŸ« πŸ‘€ πŸ“’ πŸ“Ή

Anna Alexa

πŸ“ πŸ–‹ πŸ“– πŸ€” πŸ§‘β€πŸ« πŸ“† πŸ’¬

Tim Black

πŸ“– 🚧 πŸ§‘β€πŸ« πŸ‘€ πŸ› πŸ’» πŸ“†

shea-fitz

🎨

LongForWisdom

πŸ’Ό πŸ“† πŸ’¬ πŸ€” πŸ“’ πŸ“–

prose11

πŸ–‹ πŸ“– 🚧

Artem Isios Gordon

πŸ–‹ πŸ€” πŸ‘€

Seth Goldfarb

πŸ“ πŸ–‹ πŸ› πŸ€” πŸ‘€ πŸ“–

Richard Brown

πŸ› πŸ–‹ πŸ“– πŸ’΅ 🚧 πŸ§‘β€πŸ« πŸ“† πŸ“Ή πŸ‘€

Aaron Anderson

πŸ“– πŸ› πŸ’»

TomDeMichele

πŸ“ πŸ–‹ πŸ› πŸ€”

isaacpearl

πŸ’»

Be Fit Sandpiper

πŸ’»

Alex Singh

πŸ”§ πŸ› πŸ’»

Andrew Burban

πŸ–‹ 🚧 πŸ“†

Andy Tudhope

πŸ“– πŸ› 🎨 πŸ”§ πŸ’»

Dennis Mitchell

πŸ–‹

Gala GuillΓ©n

πŸ–‹ 🌍

Hadassah Damien

πŸ’‘ πŸ“‹ πŸ€” πŸ“’

Hayden Sander

πŸ“– πŸ–‹ πŸ€”

anatta

πŸ–‹ πŸ“– πŸ€”

Jerry Goldfarb

πŸ”Š πŸ“ πŸ–‹ πŸ“– πŸ€” 🚧 πŸ“† πŸ’¬

Jose Ferrari

πŸ–‹

Josiah

πŸ› πŸ’» πŸš‡ πŸ”§

Juan Guillen

πŸ’Ό πŸ“‹ πŸ€” πŸ“† πŸ’¬ 🌍 πŸ“Ή

Kevin Wildenradt

πŸ€” πŸ“† πŸ’»

Marcin Jagodzinski

🌍 πŸ’¬ πŸ“Ή

Mario Ferrari

πŸ’¬ 🚧

Nazzareno Massari

πŸ’» πŸš‡ πŸ›

Pavel Korecky

πŸ–‹

Richard Rosa

🎨

Scott Herren

πŸ’» πŸ›

blimpa

πŸ–‹ πŸ“– 🚧 πŸ“Ή πŸ“†

Elihu

πŸ–‹ πŸ“– 🚧 πŸ“† πŸ€”

Sai Teja

πŸ–‹

This project follows the all-contributors specification. Contributions of any kind welcome!