🗳️ DEVoter Voting Platform

Non-custodial voting platform for web3 repositories. Vote with tokens that stay in your wallet.

🌐 Live Platform • 📖 Landing Page • 🔧 API Docs

---

⚡ Core Features

• 🔐 Wallet Authentication - thirdweb-powered secure login
• 📝 Repository Submission - Submit repos for community voting
• 🗳️ Non-Custodial Voting - Tokens never leave your wallet
• 📊 Real-time Leaderboards - Live rankings and statistics
• 📈 Historical Data - Track voting trends over time

🛠️ Tech Stack

Technology	Purpose
Next.js 14 + TypeScript	Full-stack React framework
PostgreSQL + Prisma	Database and ORM
thirdweb SDK	Voting contracts & authentication
decent.xyz	Multi-token support
Vercel	Hosting + serverless functions

🚀 Quick Start

# Clone and setup
git clone https://github.com/devoter-xyz/devoter-app
cd devoter-voting

pnpm install

# Setup database
npx dotenv -e .env.local -- npx prisma db push

# Start development
pnpm dev

🔧 Environment Variables

To get started, create a .env file in the root of the project by copying .env.example.

cp .env.example .env

This file should contain the following environment variables. For local development, you can use the placeholder values provided in .env.example or replace them with your actual credentials.

In CI environments, .env.example is copied to .env if present. If .env.example is not found, the CI process will continue without it, assuming environment variables are provided by other means (e.g., GitHub Secrets).

DATABASE_URL=postgresql://username:password@localhost:5432/devoter
NEXT_PUBLIC_THIRDWEB_CLIENT_ID=your_client_id
THIRDWEB_SECRET_KEY=your_secret_key

💾 Database Management

# View database in browser
npx dotenv -e .env.local -- npx prisma studio

# Run database migrations
npx dotenv -e .env.local -- npx prisma migrate dev

# Reset database (development only)
npx dotenv -e .env.local -- npx prisma migrate reset

# Run database seeder
npx dotenv -e .env.local -- ts-node --compiler-options {\"module\":\"CommonJS\"} prisma/seed.ts

🔐 Admin Actions

To create actions restricted to admin users, use the adminActionClient from src/lib/actions.ts. This client will verify that the user is authenticated and is present in the AdminUser table.

Example Usage

// src/actions/admin/someAdminAction.ts
import { adminActionClient } from '@/lib/actions';

export const someAdminAction = adminActionClient.action(async ({ ctx }) => {
  // This code will only execute if the user is an admin
  console.log('Admin user ID:', ctx.session.userId);
  // ... your admin logic here
});

Adding an Admin User

To add an admin user, you need to manually add their user ID to the AdminUser table in the database. You can do this using Prisma Studio:

1. Start Prisma Studio:

   npx dotenv -e .env.local -- npx prisma studio

2. Open your browser to http://localhost:5555.
3. Navigate to the AdminUser model.
4. Click "Add record" and enter the id and walletAddress of the user you want to make an admin. The id should be the user's ID from the User table.

🚀 Deployment

Component	Platform	Auto-Deploy
🌐 Main App	Vercel	✅ On push to main
⏰ Cron Jobs	Vercel Functions	✅ Configured in vercel.json
💾 Database	Vercel PostgreSQL	✅ Managed service

---

Empowering Web3 Repository Discovery 🚀

Report Bug • Request Feature • Contribute