Join our stargazers :)

DevAsign Maintainer App

DevAsign Maintainer App empowers open-source project maintainers to:

• Create & Manage Bounties: Install DevAsign app on project repo. Add bounties to issues/tasks.
• Monitor AI Reviews: Oversee AI-powered pull request analysis and merge decisions.
• Contributor Feedback: Automatically generate and send contributor feedback based on PR review.
• Track Contributors: View contributor activity and reputation scores.
• Manage Payments: Process bounty payments on-chain through the Stellar blockchain network.
• Configure Workflows: Set up project-specific rules and automated approval thresholds.
• Team Collaboration: Manage team members and project settings.

Tech Stack

• Framework: Next.js 15 with React 19
• Language: TypeScript
• Styling: Tailwind CSS
• State Management: Zustand
• Authentication: Firebase Auth
• HTTP Client: Axios
• Forms: Formik with Yup validation
• UI Components: Custom components with React Icons

Prerequisites

Required Software

• Node.js (version 18.0 or higher)
• npm (version 8.0 or higher) or yarn (version 1.22 or higher)
• Git (latest version)

Required Accounts & Services

• DevAsign API Server - Backend server must be running (see server setup)
• Firebase Project - for authentication services

Installation & Setup

Step 1: Clone the Repository

git clone https://github.com/devasignhq/app.devasign.com.git
cd app.devasign.com

Step 2: Install Dependencies

# Using npm
npm install

# Or using yarn
yarn install

Step 3: Environment Configuration

1. Copy the example environment file:

cp .env.example .env.local

2. Configure your .env.local file with the following variables:

# Firebase Configuration
NEXT_PUBLIC_FIREBASE_API_KEY="your-firebase-api-key"
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN="your-project.firebaseapp.com"
NEXT_PUBLIC_FIREBASE_PROJECT_ID="your-project-id"
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET="your-project.appspot.com"
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID="123456789"
NEXT_PUBLIC_FIREBASE_APP_ID="1:123456789:web:abcdef"
NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID="Q-SFQEFEEWEE"

# API Configuration
NEXT_PUBLIC_API_BASE_URL="api-url"

# App Configuration
NEXT_PUBLIC_NODE_ENV="development"

Step 4: Start the Development Server

# Start the development server
npm run dev

# The app will be available at http://localhost:3000

Configuration

Firebase Setup

1. Create a new Firebase project at Firebase Console
2. Enable Authentication and choose GitHub as your preferred sign-in method
3. Get your Firebase configuration from Project Settings
4. Add the configuration values to your .env.local file

API Server Connection

1. Ensure the DevAsign API server is running (see server setup)
2. Update NEXT_PUBLIC_API_BASE_URL in your .env.local to point to your API server
3. Verify the connection by checking the health endpoint at /health

🎯 Bounty Management

• Task Creation: Create bounty tasks with timeline and reward amounts
• Label Integration: Automatically sync with GitHub issue labels for seamless workflow
• Progress Tracking: Monitor task status from creation to completion and payment

DevAsign is open-source software licensed under the Apache 2.0 License. See LICENSE for more details.

Related Projects

• DevAsign API Server - Backend API and AI engine
• DevAsign Contributor App - Frontend for contributors
• Soroban Task Escrow Contract - Task Escrow Management