scaffold-eth / OP-RetroPGF3-Discovery-Voting

Create the voting and discovery process for OP retroactive public goods funding for badgeholders
https://op-retropgf3-discovery-voting.vercel.app
MIT License
14 stars 15 forks source link

Retroactive Public Goods Funding (RPGF) Voting Experience

Purpose

Badgeholders (voters in RetroPGF) need to be able to discover and vote on nominated projects. A good voting experience is core to supporting the work of badgeholders and ensuring an accurate RetroPGF process. This build seeks to empower badgeholders to find projects of various disciplines that have produced meaningful impact in the ecosystem that deserve to be promoted with funding.

Features of this build

Guiding insights and materials

Technology

🏗 Scaffold-ETH 2

Popular front end tool, Scaffold-ETH 2 has been used for it's easily forkable components designed with interacting with onchain data in mind. Built using NextJS, RainbowKit, Hardhat, Wagmi, and Typescript. Scaffold-ETH 2 Repo

MongoDB

For all the data housing needs to make project discovery and list curation as seamless and friction-free as possible.

Getting set up with the project

Requirements

Before you begin, you need to install the following tools:

Quickstart

To get started with this project, follow the steps below:

  1. Clone this repo & install dependencies
git clone https://github.com/scaffold-eth/OP-RetroPGF3-Discovery-Voting.git
cd OP-RetroPGF3-Discovery-Voting
yarn install
  1. Copy the .env.example file and change name to .env.local. Set the MONGO_URI to the database you are using.

  2. In the terminal, start your the project:

yarn start

Visit your app on: http://localhost:3000.

Deploying to Vercel

Hint: We recommend connecting your GitHub repo to Vercel (through the Vercel UI) so it gets automatically deployed when pushing to main.

If you want to deploy directly from the CLI, run yarn vercel and follow the steps to deploy to Vercel. Once you log in (email, github, etc), the default options should work. It'll give you a public URL.

If you want to redeploy to the same production URL you can run yarn vercel --prod. If you omit the --prod flag it will deploy it to a preview/test URL.

Make sure to check the values of your Scaffold Configuration before deploying your NextJS App.

Scaffold App Configuration

You can configure different settings for your dapp at packages/nextjs/scaffold.config.ts.

export type ScaffoldConfig = {
  targetNetwork: chains.Chain;
  pollingInterval: number;
  alchemyApiKey: string;
  walletConnectProjectId: string;
  onlyLocalBurnerWallet: boolean;
  walletAutoConnect: boolean;
  // your dapp custom config, eg:
  // tokenIcon : string;
};

The configuration parameters are described below, make sure to update the values according to your needs:

You can extend this configuration file, adding new parameters that you need to use across your dapp (make sure you update the above type ScaffoldConfig):

  tokenIcon: "💎",

To use the values from the ScaffoldConfig in any other file of your application, you first need to import it in those files:

import scaffoldConfig from "~~/scaffold.config";

A multitude of more detailed information related to Scaffold-ETH 2 can be found at the Scaffold-ETH 2 Repo

Contributing to OP-RetroPGF3-Discovery-Voting

We welcome contributions to OP-RetroPGF3-Discovery-Voting!

Please see CONTRIBUTING.MD for more information and guidelines for contributing to OP-RetroPGF3-Discovery-Voting.