Skip to content

Debanjannnn/ForkWork

Repository files navigation

πŸš€ Fork Work

The only cut taken? Your gas fees.

Live Demo License Next.js Solidity

image

A revolutionary Web3 platform that connects talented freelancers with clients through smart contracts, eliminating traditional platform fees and middlemen. Built on blockchain technology, Fork Work ensures transparency, security, and fair compensation for all parties involved.

✨ Features

🎯 Bounty System

Contract Address: 0x0caE75a45201304d6b45541BCeF12bd3ee787e28

  • Competitive Bounties: Post tasks and let multiple freelancers compete
  • USDT Payments: Secure payments using USDT stablecoin
  • Dynamic Prize Distribution: Flexible reward allocation based on quality
  • Category-based Organization: Content, Development, Design, Research, Marketing, and more
  • Deadline Management: Automated deadline enforcement with penalty systems

πŸ’Ό Freelance Escrow

  • Smart Contract Escrow: Secure payment holding until work completion
  • Staking Mechanism: Freelancers stake native tokens to demonstrate commitment
  • Proposal System: Detailed project proposals with evidence tracking
  • Auto-expiration: Automatic proposal expiration for time-sensitive projects
  • Platform Fee: Minimal 2.5% fee (only gas fees beyond this)

πŸ” Security & Trust

  • Reentrancy Protection: Secure smart contracts with OpenZeppelin
  • Ownership Controls: Admin functions for platform management
  • Penalty Systems: Fair penalty distribution for cancelled projects
  • On-chain Verification: All transactions and agreements recorded on blockchain

🎨 Modern UI/UX

  • Responsive Design: Beautiful interface that works on all devices
  • Smooth Animations: Framer Motion powered interactions
  • Dark Theme: Eye-friendly dark mode interface
  • Wallet Integration: Seamless Web3 wallet connection
  • Real-time Updates: Live status updates and notifications

πŸ› οΈ Technology Stack

Frontend

  • Next.js 15 - React framework with App Router
  • TypeScript - Type-safe development
  • Tailwind CSS - Utility-first styling
  • Framer Motion - Smooth animations and transitions
  • Radix UI - Accessible component primitives
  • Wagmi - React hooks for Ethereum
  • Lucide React - Beautiful icons

Backend & Database

  • Prisma - Type-safe database client
  • PostgreSQL - Reliable database storage
  • Next.js API Routes - Serverless API endpoints

Blockchain

  • Solidity 0.8.19 - Smart contract development
  • OpenZeppelin - Secure contract libraries
  • USDT Integration - Stablecoin payments
  • Ethereum - Decentralized execution

Development Tools

  • ESLint - Code quality and consistency
  • Prettier - Code formatting
  • Turbopack - Fast development builds

πŸš€ Getting Started

Prerequisites

  • Node.js 18+
  • npm, yarn, pnpm, or bun
  • MetaMask or any Web3 wallet
  • USDT tokens for payments

Installation

  1. Clone the repository

    git clone https://github.com/Debanjannnn/ForkWrok.git
    cd ForkWrok
  2. Install dependencies

    npm install
    # or
    yarn install
    # or
    pnpm install
  3. Set up environment variables

    cp .env.example .env.local

    Add your configuration:

    DATABASE_URL="your-database-url"
    NEXT_PUBLIC_CONTRACT_ADDRESS="your-contract-address"
    NEXT_PUBLIC_USDT_ADDRESS="your-usdt-contract-address"
  4. Run database migrations

    npx prisma migrate dev
  5. Start the development server

    npm run dev
    # or
    yarn dev
    # or
    pnpm dev
  6. Open your browser Navigate to http://localhost:3000

πŸ“– How It Works

For Clients

  1. Connect Wallet - Link your Web3 wallet to the platform
  2. Post Project - Create a bounty or freelance gig with detailed requirements
  3. Fund Escrow - Deposit USDT to secure the payment
  4. Review Proposals - Evaluate freelancer submissions and select the best fit
  5. Approve Work - Review completed work and release payment

For Freelancers

  1. Complete Onboarding - Connect wallet and link professional profiles
  2. Build Reputation - Complete tasks to establish on-chain credibility
  3. Browse Opportunities - Find bounties and freelance gigs that match your skills
  4. Submit Proposals - Create detailed proposals with evidence and timelines
  5. Deliver Quality Work - Complete projects and receive secure payments

πŸ”§ Smart Contracts

Bounty Contract (Bounty.sol)

  • Contract Address: 0x0caE75a45201304d6b45541BCeF12bd3ee787e28
  • Manages competitive bounty competitions
  • Handles USDT payments and prize distribution
  • Implements deadline enforcement and penalty systems
  • Supports multiple categories and submission tracking

Freelance Contract (Freelance.sol)

  • Contract Addres: 0xfa80583757AaE278b0849B815A3A19bd5285d311
  • Escrow system for freelance projects
  • Staking mechanism for freelancer commitment
  • Proposal management and selection process
  • Automated deadline handling and fund release

USDT Token (Mock)

🌟 Key Benefits

For Freelancers

  • No Platform Fees: Keep 100% of your earnings (minus gas fees)
  • Secure Payments: Smart contract escrow ensures payment security
  • Reputation Building: On-chain reputation system for credibility
  • Flexible Work: Choose from bounties, gigs, or staked projects
  • Global Access: Work with clients worldwide without borders

For Clients

  • Quality Assurance: Staking mechanism ensures freelancer commitment
  • Transparent Process: All transactions visible on blockchain
  • Cost Effective: Minimal fees compared to traditional platforms
  • Secure Escrow: Funds held safely until work completion
  • Multiple Options: Bounty competitions or direct hiring

🀝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ”— Links

πŸ™ Acknowledgments


Fork Work - Revolutionizing the future of work, one smart contract at a time. πŸš€

The only cut taken? Your gas fees.

About

The only cut taken? Your gas fees.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •