🌍 Relay Funder

Relay Funder is an open-source crowdfunding infrastructure for refugee and displaced communities unlocking direct, transparent, and community-led capital flows across the Ethereum ecosystem.

Relay Funder uses quadratic funding rounds where individuals and match-fund sponsors can directly support verified campaigns. Using Celo stablecoins bridged to Ethereum (USDT) Relay Funder enables transparent, auditable fund flows for humanitarian and development projects.

Prerequisites

• pnpm (locked in as the package manager)
• Docker and Docker Compose (for local development only)

Quick Start (Local Development)

1. Clone and Install Dependencies:

   git clone <repository-url>
   cd relay-funder-app
   pnpm install
   

2. Set Up Environment Variables:

   cp env.template .env.local
   

   Edit .env.local and populate the required variables. Refer to env.template for all available options and their descriptions.

Pinata Setup (IPFS File Storage)

To use Pinata for decentralized file storage:

1. Create Account: Sign up at Pinata Cloud

2. Get API Key: Generate a JWT token in the API Keys section with pinFileToIPFS and pinList permissions

3. Create Gateway: Set up a gateway in your Pinata dashboard

4. Configure Environment: Set these variables in your .env.local:

   FILE_STORAGE_PROVIDER="PINATA"
   PINATA_API_JWT_ACCESS_TOKEN="your_jwt_token"
   NEXT_PUBLIC_PINATA_GATEWAY_URL="your_gateway_url"
   

Reown AppKit Setup (Web3 Wallet Integration)

To configure Reown AppKit for wallet connections:

1. Create Account: Sign up at Reown Cloud

2. Create Project: Generate a new project in the dashboard

3. Get Project ID: Copy your project ID from the project settings

4. Configure Environment: Set these variables in your .env.local:

   NEXT_PUBLIC_REOWN_CLOUD_PROJECT_ID="your_project_id_here"
   # Optional: Set to any truthy value to disable email login (enabled by default)
   # NEXT_PUBLIC_REOWN_FEATURE_DISABLE_EMAIL=true
   

5. Start Development Environment:

   docker compose up
   

   This will start:

   • PostgreSQL database
   • Next.js development server (accessible at http://localhost:3000)

6. Initialize Database (in a new terminal):

   docker compose exec app pnpm prisma migrate dev
   docker compose exec app pnpm prisma db seed
   

7. Setup Development Wallet

Create a browser profile and install a Wallet like metamask

visit https://faucet.celo.org/alfajores and add the testnet copy your account-address into the form and claim CELO

Enhanced Development Setup

In order to efficently and securely develop relay-funder-app, there is a app-shell available that uses the same environment as the next-application. While it is possible to do things pnpm install in the host and execute some scripts (eg pnpm prisma db migrate) directly from the host (docker compose exec app COMMAND) it is often more consistent to completely enter a development-environment that matches the later production environment as closely as possible while still in full control without installing all the required tools for the project in the host (which often results in conflicts with other projects).

To enable the developer to do so, the docker compose file is providing both a app-service and a app-shell-service. The developer will enter the cloned directory and execute docker compose up as the documentation mentions before and the result is that only the app is started in develop-mode (with hot-reloading enabled).

Environment Setup

For the docker environment it is possible to configure various details. This is strictly not required as the docker compose file contains defaults. All of the variables displayed here are optional

touch .env
# postgres configuration, the defaults are fine, the postgres is only reachable by the app
echo "POSTGRES_USER=somebody" >> .env
echo "POSTGRES_PASSWORD=somepassword" >> .env
echo "POSTGRES_DB=somedatabasename" >> .env
# postgres admin configuration: a web-based tool to query the database
echo "[email protected]" >> .env
echo "PGADMIN_DEFAULT_PASSWORD=someotherpassword" >> .env
echo "PGADMIN_PORT=1235" >> .env
# app configuration: change the default port 3000
echo "DEV_APP_PORT=1234" >> .env

Development Container

In order to run commands, use the shell service:

docker compose run --rm app-shell /bin/bash

This will start the required services (database,app) and drop you in a shell that has the correct node version, pnpm et al installed. Its a alpine-based minimal container with some development tools. You are root in that container, you may install more software (apk add) which is gone once you close the terminal. You may modify all files of the app (using the pnpm scripts or your own cli-magic). In case you create files, be aware that you are root, this means the file wont be writeable to your host-user (eg your editor) until you correct the ownership. pnpm chown fixes that up - a thing that happens when prisma creates migrations for example. The develop container prompt is prefixed with aka-app so you immediately see that you are not in your host.

Development Database Management

Sometimes it is required to inquire the postgres database directly. If you prefer a desktop-tool, just expose the port of the database-container to your host, but ideally all you need is a browser.

Prisma Studio (Database Browser)

Prisma Studio provides a visual interface to browse and edit your database data:

Option 1: Direct Docker Exec

docker compose exec app pnpm prisma studio --port 5555

Option 2: Via App Shell

docker compose run --rm app-shell pnpm prisma studio --port 5555

여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗