Join our stargazers :)

DevAsign Contributor App

The contributor platform for discovering bounty tasks, submitting solutions, and receiving payments through the Stellar blockchain. The DevAsign Contributor App empowers open-source contributors to:

• Discover Bounties: Browse available tasks across multiple projects and repositories
• Track Progress: Monitor submissions, reviews, and payment status
• Earn Rewards: Receive instant payments via Stellar blockchain upon task completion
• Collaborate: Communicate with project maintainers and other contributors
• Manage Earnings: View payment history and manage crypto wallet

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"

Step 4: Start the Development Server

# Start the development server
npm run dev

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

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

License

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 Project Maintainer App - Frontend for project maintainer
• Soroban Task Escrow Contract - Task Escrow Management