FreddyWorks wiki

Full documentation for clients and freelancers using FreddyWorks — milestone escrow, USDC payouts on Polygon, contracts, disputes, withdrawals and account safety.

Account Settings & Customization

Your account settings hub at /settings gives you full control over your platform experience, security protocols, wallet connections, and interface preferences. Because FreddyWorks operates with complete pseudonymity and zero KYC requirements, properly configuring your security and wallet preferences is essential for protecting your funds and managing your projects seamlessly.

---

Accessing Account Settings

To access your settings, navigate to /settings directly or click on your profile avatar in the top navigation bar and select Settings. The settings dashboard is divided into dedicated tabs for streamlined management:

Preferences: Display theme, language, and notification toggles.
Wallet & Payouts: Connected Web3 wallets and withdrawal destination addresses.
Security: Authenticator app configuration and session management.
Account: Profile handles, email configurations, and permanent account status.

---

Theme Customization

FreddyWorks provides a responsive visual interface tailored for both high-focus work and low-light environments.

Dark Mode: Default high-contrast dark theme designed to reduce eye strain during extended work sessions.
Light Mode: Clean, bright interface optimized for high-glare environments.
System Sync: Automatically matches your operating system or browser theme settings.

To switch themes, select the theme toggle under Preferences or use the quick-toggle icon located in the navigation bar. Your selection saves instantly across all active sessions on that browser.

---

Language & Localization

FreddyWorks connects clients and freelancers across the globe. You can adjust your platform display language to match your native preferences:

Interface Language: Translates navigation menus, project creation flows, milestone dashboards, and system alerts into your selected language.
Chat Translation Alignment: Works alongside the real-time auto-translation feature in /messages, ensuring smooth collaboration across different languages.

To change your language, go to Preferences > Language, choose your preferred language from the dropdown menu, and confirm. The interface updates immediately without requiring a page refresh.

---

Notification Preferences

Stay informed about contract milestones, incoming messages, and escrow releases without experiencing notification overload. Under Preferences > Notifications, you can customize real-time alerts across various platform events:

Messages: Real-time alerts when a client or freelancer sends a direct message in /messages.
Escrow & Milestones: Immediate notifications when a milestone is funded, submitted for review, approved, or auto-released after the 7-calendar-day review window.
Proposals & Contracts: Alerts for new proposals received (for clients) or proposal acceptances and contract updates (for freelancers).
Disputes & Appeals: Critical updates if a dispute is filed or an appeal is submitted.

You can toggle notifications on or off independently for browser push alerts and email notifications.

---

Wallet Management & Payout Settings

FreddyWorks utilizes USDC on the Polygon network for all deposits, escrow funding, and milestone payments. Managing your wallet connections correctly ensures smooth deposits and automated payouts.

Connecting Your Wallet

To interact with deposits and platform contracts, you can link your Web3 wallet via RainbowKit and WalletConnect:

Navigate to Wallet & Payouts in /settings.
Click Connect Wallet.
Choose your preferred wallet provider (such as MetaMask, Rainbow, Coinbase Wallet, or any WalletConnect-compatible wallet).
Approve the connection request in your wallet application.

Setting Your Saved Payout Address

When withdrawing funds from your FreddyWorks balance:

Withdrawals are sent directly to your saved Polygon wallet address in USDC on Polygon.
FreddyWorks charges a 0% withdrawal fee.
Withdrawals are processed automatically without requiring manual administrative approval.
To set or update your address, enter a valid Polygon (MATIC) network address under Saved Withdrawal Address and verify the change with your authenticator code.

Note: Always verify that your receiving address supports USDC on the Polygon network before initiating withdrawals.

---

Security Settings

Because FreddyWorks requires no KYC (no identity documents, passports, or personal verification are ever requested), securing your account through standard cryptographic best practices is crucial.

Two-Factor Authentication (2FA)

Two-factor authentication using an authenticator app (such as Google Authenticator, Authy, or 1Password) adds an essential layer of protection:

Mandatory for Withdrawals: An authenticator code is required every time you initiate a USDC withdrawal.
Account Protection: Protects your funds, contract authorizations, and settings modifications from unauthorized access.

Setting Up 2FA:

Navigate to Security > Authenticator App.
Scan the displayed QR code with your authenticator app.
Save your emergency backup code in a secure, offline location.
Enter the 6-digit code generated by your app to verify and activate 2FA.

Active Sessions & Device Management

Under the Security tab, you can view all active sessions, including browser types, approximate locations, and last active timestamps. If you notice unfamiliar activity, click Log Out All Other Sessions to terminate access across all devices instantly.

---

Progressive Web App (PWA) Installation

FreddyWorks is fully optimized as a Progressive Web App (PWA), providing a native-app experience on desktop and mobile

Affiliate Program

The FreddyWorks Affiliate Program allows you to earn passive crypto income by referring new clients and freelancers to the platform. Whether you are an active freelancer, a business hiring talent, or a content creator in the Web3 space, you can monetize your network by introducing others to seamless, milestone-based crypto freelancing.

All affiliate rewards are distributed in USDC on the Polygon network, providing fast, predictable, and borderless payouts without intermediary banking delays or currency conversion hurdles.

---

How to Sign Up as an Affiliate

Participating in the FreddyWorks Affiliate Program is open to all registered users without an application waiting period or approval queue.

Step 1: Create or Access Your Account

To participate, you must have an active FreddyWorks account. Because FreddyWorks operates on a decentralized ethos, no KYC (Know Your Customer) or identity documents are ever requested. Your account remains pseudonymous, tied securely to your email and connected Web3 wallet.

Note that FreddyWorks accounts are permanently designated as either a Freelancer or a Client at registration. However, both account types have equal access to the affiliate program and use the exact same referral mechanics.

Step 2: Navigate to the Affiliate Hub

Log in to your FreddyWorks account.
From the main navigation menu or your user dashboard, navigate to /affiliate.
Your affiliate dashboard will automatically initialize, generating your unique referral code and tracking link.

---

Getting and Customizing Your Referral Link

Your unique referral link is the primary tool for attributing new registrations and contract activity to your account.

Locating Your Link

Inside the /affiliate dashboard, you will find your master referral link:

https://freddy.works/?ref=YOUR_CODE

Deep Linking to Specific Platform Pages

You can append your referral tracking parameter (?ref=YOUR_CODE) to various landing pages across FreddyWorks to direct your audience to the most relevant destination:

For Hiring Clients: Direct founders and managers to post a project by linking to /post?ref=YOUR_CODE.
For Talent and Freelancers: Send freelancers directly to explore open gigs at /work?ref=YOUR_CODE.
For Marketplace Browsers: Showcase predefined service packages using /services?ref=YOUR_CODE.

When a visitor clicks your link, a tracking cookie attaches to their session. If they register an account, they are permanently linked to your affiliate profile.

---

Commission Structure

FreddyWorks operates on a transparent, milestone-based escrow system where all payments are conducted strictly in USDC on Polygon. The affiliate commission model is directly tied to the platform fees generated by your referred users.

Standard Platform Fee Context: FreddyWorks charges a 10.0% platform fee on completed freelancer earnings (with repeat-partner discounts lowering this over time) and a 0.0% fee for clients.
Affiliate Revenue Share: Affiliates earn a percentage of the net platform commission collected on every completed milestone across contracts involving their referred users.
Two-Sided Attribution: You earn rewards whether you refer the Client posting the project or the Freelancer completing the work. If you refer both parties on the same contract, you receive commissions on both sides of the qualifying platform revenue.
Escrow Settlement: Affiliate rewards are credited to your balance the moment escrow funds are successfully released to the freelancer upon milestone completion.

---

Affiliate Tier System

To reward high-volume promoters and community leaders, FreddyWorks utilizes a tiered commission structure. As your referred users complete more project volume, your commission percentage increases automatically.

| Tier Level | Qualifying Referral Volume (USDC) | Commission Share (% of Platform Fee) |

| :--- | :--- | :--- |

| Tier 1 (Starter) | 0 – 5,000 USDC | 15% |

| Tier 2 (Pro) | 5,001 – 25,000 USDC | 20% |

| Tier 3 (Elite) | 25,001 – 100,000 USDC | 25% |

| Tier 4 (Partner) | 100,000+ USDC | 30% |

How Tier Progression Works

Cumulative Volume: Tier progress is calculated based on the total completed contract volume (in USDC on Polygon) generated by all your referred users combined.
Permanent Elevation: Once you unlock a tier, your account maintains that earning rate for all future completed milestones across your entire referral network.

---

Tracking Referrals and Earnings

The affiliate dashboard at /affiliate gives you comprehensive, real-time analytics to measure campaign effectiveness and monitor your earnings.

Key Metrics Displayed:

Total Clicks: Real-time counter of visits generated through your custom referral links.
Total Sign-Ups: The number of unique users (freelancers and clients) who created an account through your attribution link.
Active Contracts: Number of ongoing projects currently funded in escrow by your network.
**Total Volume

AI-Powered Tools

Overview of AI-Powered Features on FreddyWorks

FreddyWorks integrates artificial intelligence across every phase of the freelancing lifecycle. From drafting high-converting proposals to evaluating complex project requirements and facilitating multilingual communication, these built-in tools help both clients and freelancers work faster, communicate clearly, and collaborate globally without language or technical barriers.

All payments and escrow transactions on the platform are settled strictly using USDC on the Polygon network, ensuring fast, low-cost execution alongside intelligent project management.

---

AI Proposal Generator for Freelancers

Crafting tailored, professional proposals for every project can be time-consuming. The AI Proposal Generator helps freelancers draft compelling, relevant applications in seconds.

How to Use the Proposal Generator

Navigate to any active project listing on /browse or /work.
Click Submit Proposal.
Select the Generate with AI option within the proposal editor.
The system analyzes the project description, required deliverables, and technical criteria alongside your profile skills and past work history.
Review the generated proposal text, customize key details, adjust the proposed milestone breakdown, and submit.

Key Capabilities

Scope Alignment: Automatically references the client’s explicit project requirements.
Tone Optimization: Generates professional, clear, and action-oriented introductory pitches.
Milestone Drafting: Suggests a structured sequence of project deliverables based on the project scope.

---

AI Pricing Advisor

Setting a competitive yet profitable rate is crucial for winning bids while protecting your earnings. The AI Pricing Advisor provides real-time guidance when structuring your proposal bids.

How It Works

Scope Analysis: When submitting a proposal, the advisor evaluates project complexity, skill requirements, and timeline expectations.
Rate Recommendations: It suggests competitive pricing tiers (minimum, recommended, and premium) denominated in USDC on Polygon.
Fee Calculation: The advisor factors in the standard 10.0% freelancer platform fee, showing your exact net payout for each milestone upon completion.

---

AI Budget Estimator for Clients

Clients creating new listings on /post can use the AI Budget Estimator to determine realistic market rates and design structured milestone budgets.

How to Estimate Project Budgets

Go to /post and enter your project title and project description.
Click Estimate Budget.
The AI scans the requested deliverables, expected timeline, and required expertise to provide a recommended total budget in USDC on Polygon (all projects require a minimum budget of $10 USDC).
The tool also outputs a recommended Milestone Breakdown, segmenting the total cost into manageable phases with clear deliverables.

Benefits for Clients

Fair Market Scoping: Prevents under-budgeting that leads to low proposal quality or over-budgeting that inflates project costs.
Instant Milestone Structure: Automatically generates logical phases for escrow funding, ensuring clear review criteria at each delivery point.

---

AI Project Assistant

The AI Project Assistant serves as an interactive collaboration helper accessible directly from your project workspace and /dashboard.

Key Functions

Milestone Planning: Assists both parties in breaking large, complex deliverables into actionable checklists before funding escrow.
Requirement Clarification: Helps clients draft clearer technical specifications or acceptance criteria if deliverables are ambiguous.
Task Drafting: Suggests structured timelines, delivery checklists, and review steps to keep project execution aligned.

You can interact with the assistant inside active project dashboards whenever you need structured advice on project milestones, technical scope definitions, or workflow management.

---

Semantic AI Search

FreddyWorks features a dual-layer search system combining traditional keywords with Semantic AI Search across /search, /browse, and /freelancers.

Keyword vs. Semantic Search

Keyword Search: Matches exact text queries (e.g., "Solidity", "React Developer").
Semantic AI Search: Understands context, intent, and conceptual relationships (e.g., searching "Build an automated inventory sync for an e-commerce storefront" will surface freelancers with backend API, webhook, and database integration skills, even if the exact phrase is not in their profile).

Using Semantic Search Effectively

Use natural language to describe the exact problem you want to solve.
Filter results by category, budget in USDC on Polygon, and delivery timeline.
Switch seamlessly between searching for active projects or discovering top-rated freelancer profiles and public resumes (/r/username).

---

AI-Driven Dispute Resolution

While milestone-based escrow protects both parties by locking funds in USDC on Polygon until deliverables are approved, unexpected disagreements can occur. FreddyWorks provides an AI Dispute Analysis system to provide fast, objective evaluations.

How Dispute Analysis Works

Dispute Filing: Either party initiates a dispute within the 7-day dispute filing window following a milestone delivery or revision request.
Evidence Snapshots: The platform generates comprehensive snapshots of the project scope, agreed milestone requirements, chat logs, uploaded deliverables, and revision histories.
Objective Evaluation: The AI analyzes the submitted evidence against the original project terms, determining whether contractual deliverables were met according to the project specifications.
Resolution Finding: The system issues a structured resolution recommendation regarding the distribution or

Dashboard & Project Tools

The FreddyWorks Dashboard (/dashboard) serves as your central command hub for overseeing active contracts, monitoring milestone escrow, tracking deliverables, and organizing your crypto freelancing workflow. Whether you hold a dedicated Client account or Freelancer account, the dashboard aggregates real-time data into visual project management tools so you can run your operations seamlessly.

---

High-Level Overview Metrics

At the top of the dashboard, customizable metric cards display a snapshot of your account's operational and financial status. All financial balances and escrow amounts are denominated exclusively in USDC on the Polygon network.

Core Metric Cards

Active Projects: Displays the total number of open contracts currently in progress. Clicking this card filters your project view to show contracts requiring immediate attention.
Escrow Balances / Pending Funds:
For Clients: Displays the total USDC currently locked across active milestone escrows waiting for freelancer submission and approval.
For Freelancers: Shows the pending USDC locked in funded milestones that will become available for withdrawal once your work is approved or upon expiration of the 7-calendar-day auto-release window.
Total Earnings / Spend: Tracks historical volume settled through the platform. For freelancers, this reflects net earnings after the platform commission (10.0% standard, lower for repeat client contracts). For clients, this reflects total USDC disbursed with 0.0% platform fees.
Proposals & Action Items: Summarizes pending proposal responses, active review windows, and milestones awaiting client deposit.

---

Calendar View for Deadlines and Deliverables

The integrated Calendar View organizes your project schedule across days, weeks, and months. It automatically populates dates based on contract agreements and milestone submission windows.

```

+-------------------------------------------------------------+

| OCTOBER 2024 |

| Sun Mon Tue Wed Thu Fri Sat |

| 1 2 3 [Milestone 1] 4 5 |

| 6 7 8 9 10 11 [Release] 12 |

+-------------------------------------------------------------+

```

Key Calendar Features

Milestone Due Dates: Highlights specific delivery deadlines established within active project contracts.
Auto-Release Countdowns: Visualizes the 7-calendar-day review window. When a freelancer submits work, the calendar displays the exact date and time the escrowed USDC will automatically release if the client takes no action.
Deposit Reminders: Alerts clients when upcoming milestones in a multi-phase project require escrow funding to keep the contract active.
Custom Views: Switch seamlessly between monthly planning grids and detailed daily schedules to manage workloads without missing a cutoff.

---

Gantt Timeline for Multi-Phase Projects

For complex, multi-milestone contracts, the Gantt Timeline offers a visual roadmap of project progression, phase dependencies, and concurrent milestone execution.

```

Project: Mobile App UI/UX

Phase 1: Wireframing [==================] (Completed)

Phase 2: High-Fi Mockups [===============> ] (In Progress)

Phase 3: Design System [--------] (Locked)

|-------------------|-------------------|--------|

Week 1 Week 2 Week 3

```

Navigating the Gantt Chart

Milestone Status Tracking: Each milestone appears as a horizontal bar color-coded by state:
Draft / Unfunded: Awaiting escrow deposit from the client (minimum 10 USDC).
In Progress: Funded in escrow; work is actively being executed by the freelancer.
Under Review: Deliverable submitted; 7-calendar-day review window active.
Completed: Escrow released to the freelancer.
Dependency Identification: Understand which phases must be reviewed and released before the next milestone's escrow can be funded.
Progress Scrubber: Drag and view timeline estimates across multi-week contracts to prevent bottlenecks and ensure deadlines align with client expectations.

---

Recent Activity Feed

The Activity Feed provides a chronological, real-time audit trail of all interactions across your account. Instead of checking individual contract pages, you can review live updates directly from this stream.

Monitored Events

Escrow Deposits: Immediate confirmation when a client funds a milestone with USDC on Polygon.
Work Submissions: Alerts when a freelancer attaches deliverables and initiates the review phase.
Funds Released: Notifications when milestone payments clear and move to your available withdrawal balance.
System Alerts: Warnings regarding project inactivity, approaching the 14-day auto-abort window, or updates on the 168-hour AI dispute appeal window.
Direct Messages: Summaries of new unread chats from active project threads.

---

Quick Actions Hub

The Quick Actions bar sits prominently on the dashboard to reduce navigation time and let you execute essential tasks in a single click:

Post a Project (/post): (Clients) Rapidly publish a new project listing using the built-in AI budget estimator and proposal wizard.
Find Work (/work): (Freelancers) Jump directly into project search using semantic AI queries or keyword filters.
Deposit Funds: Add USDC on Polygon to your account balance to fund upcoming contract milestones.
Withdraw Earnings: Transfer settled USDC directly to your saved Polygon wallet address. All withdrawals are processed automatically and require your authent

Disputes & Resolution

FreddyWorks provides a milestone-based escrow system designed to protect both clients and freelancers during every contract. While most milestones conclude smoothly with mutual approval, conflicts can occasionally arise regarding deliverables, deadlines, or scope.

The FreddyWorks dispute system offers an objective, automated resolution process powered by AI, backed by a formal appeal framework. When a dispute is opened, escrow funds remain securely locked, ensuring neither party loses funds unfairly while the case is under review.

---

When to File a Dispute

A dispute should be treated as a last resort after direct communication in the platform chat has failed to resolve an impasse. Both clients and freelancers can initiate a dispute on any active, funded milestone within the 7-day dispute filing window.

Common Grounds for Clients

Non-Delivery: The freelancer failed to submit the required deliverables by the agreed deadline without communication or justification.
Incomplete or Substandard Work: The submitted deliverable significantly deviates from the agreed project brief or milestone specifications.
Unresponsive Freelancer: The freelancer is completely unresponsive after escrow has been funded.

Common Grounds for Freelancers

Withheld Payment: The work was delivered fully according to milestone specifications, but the client refuses to release the escrowed funds.
Unreasonable Scope Expansion: The client demands additional work far outside the original milestone agreement before approving the payout.
Unresponsive Client: The client fails to review submissions, though the 7 calendar day auto-release window normally protects against client inactivity unless manually paused.

---

How to Open a Dispute and Submit Evidence

Once initiated, a dispute immediately halts the milestone lifecycle and pauses any automatic 7 calendar day escrow releases.

Step-by-Step Submission Process

Access the Milestone: Navigate to /dashboard or the specific project workspace and select the contested milestone.
Initiate the Dispute: Click Open Dispute. You will be prompted to select a primary reason for the dispute.
Draft Your Statement: Provide a clear, chronological summary of the issue. Focus on factual occurrences, agreed-upon milestone terms, and specific points of failure.
Attach Evidence: Upload all supporting documentation. Relevant evidence includes:
Deliverable files, code repositories, design mockups, or live previews.
Specific references to milestone requirements outlined in the initial contract.
Clarifications or agreements documented in the FreddyWorks platform chat.
Submit for Analysis: Once submitted, the other party is notified and provided a dedicated timeframe to present their counter-evidence and statement.

Note: The platform automatically captures platform messaging history as part of the case snapshot. External communications outside FreddyWorks cannot be verified and are not considered valid evidence.

---

AI-Powered Analysis and Resolution

Once both parties have submitted their evidence—or after the response timer elapses—the FreddyWorks AI dispute system evaluates the case.

How the AI Evaluates the Case

The AI resolution engine analyzes the comprehensive record of the milestone, including:

The Original Scope: The project description, proposal terms, and milestone requirements established at contract creation.
Communication History: Real-time chat logs and file exchanges conducted within the /messages system.
Submitted Deliverables: The actual work files uploaded against the required technical and creative specifications.
Timeline of Events: Submission timestamps, revision requests, and response intervals from both sides.

Speed and Objectivity

Traditional arbitration can take weeks. The FreddyWorks AI dispute engine delivers a detailed, reasoned judgment promptly after evidence collection closes, breaking down its findings point-by-point based on the contractual obligations.

---

Dispute Outcomes and Financial Settlement

The dispute resolution system can issue three potential outcomes depending on the evidence:

Full Release to Freelancer: If the evidence proves that the freelancer satisfied the milestone specifications, the full escrow amount (minus the standard platform commission) is released to the freelancer.
Full Refund to Client: If the deliverable was not provided or failed entirely to meet agreed-upon requirements, the full escrow balance is returned to the client in USDC on Polygon.
Partial Split: In cases where substantial, usable work was completed but certain requirements were missed, the engine may award a proportionate split between client and freelancer.

Dispute Financial Terms

Standard Platform Fee: Freelancers pay a 10.0% platform fee on completed milestones. (Clients pay 0.0%).
Dispute Penalty: The losing party in a dispute pays a 5% dispute fee calculated against the disputed milestone amount.
Mutual Cancellation Alternative: If both parties mutually agree to cancel a contract without a formal dispute, the cancellation fee is 0%.

---

The Appeal Process and Elevated Review

FreddyWorks provides a comprehensive appeal mechanism if either party believes an AI dispute resolution overlooked critical evidence.

```

+-----------------------------------------------------------+

| Dispute Opened |

| (Escrow paused; evidence collected) |

+----------------

Finding & Applying for Work

Finding and winning projects on FreddyWorks allows you to leverage your skills in a global, borderless marketplace. With no KYC requirements, instant pseudonymous onboarding, and guaranteed payments held in milestone escrow using USDC on Polygon, freelancers can focus entirely on delivering quality work.

This guide details how to navigate project listings, utilize semantic search, craft compelling proposals, and price your services strategically.

---

Browsing and Filtering Projects

FreddyWorks offers dedicated interfaces to explore open contracts. You can find active opportunities by visiting /work or /browse.

Using Platform Filters

To narrow down thousands of listings to the jobs that best match your skill set and availability, apply the sidebar filters:

Category and Subcategory: Filter by specific disciplines, such as Web Development, UI/UX Design, Content Writing, Smart Contract Engineering, or Digital Marketing.
Budget Range: Set minimum and maximum thresholds. Keep in mind that the minimum project budget on FreddyWorks is 10 USDC.
Required Skills: Select specific technologies or tools (e.g., React, Solidity, Figma, Python) to display contracts requiring your exact stack.
Project Duration: Filter by expected turnaround times to manage your delivery pipeline.

---

Utilizing Semantic AI Search

In addition to traditional keyword matching, FreddyWorks features a built-in Semantic AI Search on the /search page.

Standard keyword search looks for exact text matches, which can sometimes omit relevant projects if a client uses non-standard terminology. Semantic AI search analyzes the natural language meaning, intent, and context of your query.

How to Use Semantic Search Effectively

Describe your exact expertise: Instead of searching "frontend", try "building responsive dashboards with charting libraries for Web3 dApps".
Search by problem domain: Input prompts like "clients looking to redesign an e-commerce checkout flow" or "smart contract auditing for token launches".
Multi-Language matching: The semantic search engine interprets queries across multiple languages, matching you with international clients regardless of phrasing differences.

---

Evaluating Project Details

Before submitting a proposal, review the contract specifications thoroughly to ensure the project aligns with your capabilities and expectations.

Key Details to Review

Scope and Deliverables: Ensure the client has provided clear requirements. Vague scopes can lead to misunderstandings later.
Milestone Structure: Look at how the client intends to break down the project. On FreddyWorks, client funds are locked into secure milestone escrow prior to you starting work on each phase.
Auto-Release Policy: Remember that all milestone deliverables operate under a 7 calendar day review window. If a client goes unresponsive after you submit work for a milestone, funds are automatically released to your balance once the 7 calendar days pass.
Activity Indicators: Check the project timeline to confirm the listing is active. Contracts with no client activity auto-abort after 14 days of inactivity.

---

Crafting and Submitting Proposals

Once you find an appropriate project, click Submit Proposal on the project page. A winning proposal clearly demonstrates your understanding of the client's problem, outlines your approach, and defines clear deliverables.

```

Proposal Submission Structure:

┌──────────────────────────────────────────────┐

│ 1. Personalized Hook & Problem Summary │

├──────────────────────────────────────────────┤

│ 2. Actionable Solution & Methodology │

├──────────────────────────────────────────────┤

│ 3. Proposed Milestones & Delivery Schedule │

├──────────────────────────────────────────────┤

│ 4. Relevant Portfolio Items or Case Studies │

└──────────────────────────────────────────────┘

```

Using the AI Proposal Generator

To accelerate your workflow, FreddyWorks provides an integrated AI Proposal Generator:

Open the proposal editor on any project listing.
Select Generate Proposal. The AI scans the client's project description, requirements, and your profile strengths.
Review the generated draft. The tool creates an initial layout outlining milestones, timelines, and tailored technical solutions.
Always personalize the output: Edit the generated text to add specific examples, your unique voice, links to your live work, or portfolio items hosted at /r/username.

Structuring Proposed Milestones

Break your work into measurable stages. For each milestone:

Provide a descriptive title (e.g., "Milestone 1: Wireframes and Design System").
Specify the exact deliverables included.
Assign a clear cost in USDC on Polygon (each milestone must meet or exceed platform minimums).
Set an estimated delivery date.

---

Pricing Strategies and Platform Fees

Setting competitive rates requires balancing your target income against platform fees and market standards.

Understanding Platform Fees

Client Fee: 0.0% (Clients pay no platform commission on contracts).
Freelancer Fee: A standard 10.0% commission is deducted automatically from your earnings upon the successful completion and payout of each milestone.
Repeat-Partner Discount: When you work repeatedly with the same client on FreddyWorks, your freelancer fee decreases on subsequent contracts. This discount is locked into each contract at the moment of creation, incentivizing long-term client relationships.

Pricing Recommendations

Calculate Net Earnings: When entering your milestone quotes, factor in the 10.0% platform fee so your net payout in USDC on Polygon matches your financial expectations.
Use the Pricing Advisor Tool: Leverage FreddyWorks' built-in AI pricing advisor to see recommended market rates based on similar completed c

Getting Started with FreddyWorks

Welcome to FreddyWorks

FreddyWorks is a decentralized, cryptocurrency-powered freelancing platform designed to remove traditional banking barriers and connect clients and freelancers across the globe. By using USDC on the Polygon network for all platform transactions, FreddyWorks provides fast, borderless payments backed by secure milestone escrow.

FreddyWorks operates pseudonymously: no identity verification (KYC) documents are ever requested. You can register, hire or work, and settle contracts entirely through your Web3 wallet and verified email.

---

Step 1: Creating Your Account

Getting started on FreddyWorks begins with creating an account and selecting your platform role.

1. Register with Your Email

Navigate to the signup page to begin:

Enter your preferred email address and create a strong password.
Confirm your email address using the verification code sent to your inbox.
Choose your username. This username will be your unique identifier across the platform and will power your public profile link (for example, /r/username).

2. Choose Your Account Type

During registration, you must select your account role:

Freelancer: Search for work, submit proposals, complete milestones, and receive earnings.
Client: Post projects, review proposals, fund escrow milestones, and hire talent.

Important Note: Account types are permanent. An account cannot hold both roles, and you cannot switch account types after registration. If you plan to both hire and work on the platform, you must register two separate accounts with different email addresses.

---

Step 2: Connecting Your Crypto Wallet

All financial transactions on FreddyWorks—including milestone escrow funding, payouts, and balance withdrawals—are settled in USDC on the Polygon network.

1. Connect via RainbowKit

Click the Connect Wallet button in the top navigation bar.
Select your preferred provider from the wallet modal (such as MetaMask, Rainbow, or any mobile wallet via WalletConnect).
Approve the connection request inside your wallet extension or mobile app.

2. Configure Your Withdrawal Settings

Once your wallet is connected, configure your security settings before transacting:

Navigate to Settings (/settings) and confirm your default Polygon payout address.
Set up an authenticator app (2FA). An authenticator code is required for every withdrawal to ensure account security.
Withdrawals to your saved Polygon wallet address carry a 0% withdrawal fee and process automatically without manual admin queues.

---

Step 3: Setting Up Your Profile

A complete profile establishes credibility and helps you stand out in semantic AI searches (/search). Navigate to Edit Profile (/profile) to customize your details.

```

Profile Checklist:

├── Avatar: Upload a clear personal image or brand logo

├── Display Name & Bio: Define your expertise or company mission

├── Skills & Tags: Add relevant industry keywords for AI discovery

├── Rate & Availability: Set baseline hourly rates (Freelancers)

└── Portfolio / Resume: Showcase past work and certifications

```

Profile Setup for Freelancers

Avatar & Bio: Add a professional avatar and write a comprehensive summary highlighting your core specializations, background, and work philosophy.
Skills & Certifications: Tag your primary skills. The FreddyWorks semantic search engine matches your skill tags directly with client project requirements.
Hourly Rate: Set your baseline rate in USDC on Polygon. This rate displays on your public card across the freelancer directory (/freelancers).
Portfolio & Resume Builder: Add past project samples, case studies, and external links. You can also generate a dedicated public resume page located at /r/username.

Profile Setup for Clients

Company/Client Bio: Explain what your company, DAO, or project does so freelancers understand your domain.
Hiring Preferences: Highlight preferred time zones, typical project scopes, and communication expectations.

---

Step 4: Navigating the Dashboard

Your central hub for managing platform activity is the Dashboard (/dashboard). The dashboard adapts based on your account role:

Main Dashboard Modules

Active Projects: Displays all ongoing contracts, current milestone statuses, and pending deliverables.
Gantt & Calendar Views: Visualize upcoming deadlines, project timelines, and scheduled milestone releases.
Analytics Panel: Track your total spending or earnings in USDC on Polygon, proposal conversion rates, and completed contracts.

Core Navigation Pages

Find Work / Projects (/work and /browse): Freelancers can browse open projects, filter by budget, or use AI-assisted search.
Find Freelancers (/freelancers): Clients can browse talent directories, evaluate past ratings, and send direct project invitations.
Messages (/messages): Real-time chat between clients and freelancers featuring automated translation tools.
Payment History (/payments): Review historical escrow deposits, released milestone funds, platform fees, and withdrawal transaction hashes.

---

Action Plan for Clients

Messaging & Communication

Overview of the Messaging System

Clear communication is essential for successful crypto freelancing. FreddyWorks provides an integrated, real-time messaging hub located at /messages that allows clients and freelancers to coordinate project requirements, negotiate proposals, share assets, and track progress.

Because FreddyWorks operates globally without requiring identity verification or KYC documents, the platform’s chat environment is designed to provide secure, pseudonymous collaboration while maintaining verifiable communication records for all milestone-based contracts.

---

Real-Time Chat Features

The FreddyWorks messaging interface is built to support fluid, instant collaboration between project participants. Whether negotiating an initial proposal or executing complex milestones, all conversations are organized systematically.

Conversation Organization

Project-Specific Threads: When a proposal is submitted or a contract is formed, a dedicated chat thread is created. This links the conversation directly to the relevant project and milestone timeline.
Direct Pre-Contract Inquiries: Clients can contact freelancers directly from their public profiles or portfolio pages to discuss potential work before initiating a formal contract.
Status and Activity Indicators: Chat threads display real-time message delivery and updates, ensuring you know when your project partner is reviewing your input.

Chat Interface Capabilities

Markdown Formatting: Format messages using standard Markdown syntax (such as lists, bold text, code blocks, and headers) to share technical briefs or code snippets clearly.
Message History: Full chat logs remain accessible for the duration of the contract and afterward, providing an immutable reference of agreed-upon deliverables and feedback.

---

Auto-Translation for Global Collaboration

Freelancers and clients on FreddyWorks represent a global decentralized workforce. To eliminate language barriers, the messaging system includes built-in auto-translation.

How Auto-Translation Works

Automatic Detection: The messaging system automatically detects the language of incoming messages.
One-Click Translation: If a message is received in a language other than your selected platform interface language, a translation toggle appears directly beneath the message bubble.
Bilingual Viewing: You can view the translated text alongside the original message to ensure nuance, technical terminology, and context are accurately understood.
Outgoing Translation: You can compose messages in your native language without worrying about whether your project partner speaks the same language.

This feature enables seamless coordination across continents without requiring third-party translation tools or browser extensions.

---

File Sharing and Asset Exchange

Direct file sharing inside the messaging workspace facilitates quick reviews, asset handoffs, and feedback cycles throughout the project lifecycle.

Supported File Types and Deliverables

The messaging workspace supports a wide variety of project attachments, including:

Documents and Specifications: PDF, DOCX, TXT, and Markdown files for briefs, contracts, and documentation.
Design and Media Assets: PNG, JPG, SVG, and compressed archive files (such as ZIP or TAR) for mockups, graphics, and UI assets.
Code and Technical Deliverables: Source files, configuration scripts, and repositories.

File Sharing Guidelines

Centralize Deliverables: Always upload essential project assets directly within the official chat thread or the associated milestone submission area.
Use Clear Naming Conventions: Label files with version numbers (e.g., Design_System_v1.2.zip) to prevent confusion during revision requests.
Avoid External Links for Final Submissions: While links to live staging sites or cloud drives are acceptable for discussions, formal milestone deliverables should be documented within the FreddyWorks conversation history.

---

Notification System

To ensure that neither clients nor freelancers miss important project updates, milestone deadlines, or new messages, FreddyWorks utilizes a dual notification system.

In-App Notifications

Notification Center (/notifications): Clicking the bell icon in the platform navigation brings up a real-time list of platform events.
Event Categories: In-app alerts notify you of new chat messages, proposal submissions, milestone funding events in USDC on Polygon, approval requests, and dispute updates.
Unread Indicators: Visual badges on the navigation bar highlight unread messages and pending contract actions.

Email Alerts

Offline Notifications: If you are not actively browsing the platform, FreddyWorks sends email alerts for urgent events, such as new messages, milestone submissions, or client approvals.
Preference Management: You can customize your email alert preferences in /settings to determine which types of updates trigger an email notification.
PWA Push Notifications: If you have installed the FreddyWorks Progressive Web App (PWA) on your desktop or mobile device, you can enable native system push notifications for immediate delivery.

---

Communication Best Practices

Maintaining professional, clear, and documented communication protects both parties and ensures smooth milestone approvals.

1. Keep All Work Discussions on FreddyWorks

Dispute Protection: In the event of a disagreement, AI-powered dispute resolution relies on evidence snapshots taken directly from the platform. Discussions, file uploads, and agreement modifications conducted outside FreddyWorks cannot be verified during a dispute review.
Milestone Clarity: Clearly outline what constitutes completion for each milestone within the chat before the client locks the USDC on Polygon into escrow.

2. Document Scope Changes in Writing

If p

Payments & Escrow System

FreddyWorks utilizes a transparent, non-custodial financial infrastructure designed to remove traditional banking friction, cross-border delays, and excessive processing fees. By operating entirely on USDC on the Polygon network, the platform provides fast, predictable, and low-cost transactions for clients and freelancers worldwide.

Identity verification is never required on FreddyWorks. Users operate pseudonymously without submitting KYC documents, using secure cryptographic wallets and milestone-based escrow to guarantee financial safety.

---

Supported Currency and Network

FreddyWorks exclusively supports a single asset and blockchain for all financial operations:

Asset: USDC
Network: Polygon

All deposits, escrow funding, fee assessments, and withdrawals are conducted solely in USDC on Polygon. Sending any other token or using an unsupported network will result in a failed transaction.

---

Depositing Funds

Clients and freelancers can add funds to their platform balance through the built-in deposit interface.

How to Deposit:

Connect your Web3 wallet (such as MetaMask or Rainbow) via the platform wallet interface.
Navigate to your balance menu or the deposit section on the dashboard.
Select the amount of USDC on Polygon you wish to transfer.
Confirm the transaction in your connected wallet.
Once confirmed on the Polygon network, your platform balance will update immediately.

The minimum project budget on FreddyWorks is 10 USDC. Ensure your balance meets or exceeds this threshold before initiating or funding contracts.

---

Milestone-Based Escrow

Every project on FreddyWorks is divided into one or more milestones. The escrow system protects both parties by ensuring that funds are committed before work begins and released only when work meets project specifications.

```

[ Client Funds Milestone ]

│

▼

[ Escrow Holds USDC on Polygon ]

│

▼

[ Freelancer Submits Deliverable ]

│

┌─────┴────────────────────────┐

▼ ▼

[ Client Approves ] [ 7 Calendar Days Inactivity ]

│ │

└──────────────┬───────────────┘

▼

[ Escrow Releases Payment ]

```

Funding Milestones

Before a freelancer starts work on a milestone, the client must fund that specific milestone using their available balance of USDC on Polygon.
Escrow holds the funds securely. Neither the client nor the freelancer can independently withdraw escrowed

Platform Fees & Pricing

Transparent Pricing on FreddyWorks

Understanding platform fees is critical for budgeting projects and calculating earnings. FreddyWorks operates on a transparent, predictable fee model powered by USDC on Polygon. By removing traditional banking intermediaries, currency conversions, and complex tiered processing charges, FreddyWorks provides straightforward pricing for both clients and freelancers.

Whether you are hiring talent or delivering services, there are no hidden platform charges, no monthly subscription paywalls, and no unexpected deduction tiers.

---

Client Fees: 0.0% Platform Fee

Clients on FreddyWorks enjoy a 0.0% platform fee across all projects and milestones.

How Escrow Funding Works for Clients

0.0% Escrow Fee: When you fund a milestone, 100% of the funds go directly toward the freelancer's milestone budget. If you create a milestone for $500, you pay exactly $500 in USDC on Polygon.
0% Refund Processing Fee: If a milestone is cancelled or refunded before work commences, there is a 0% processing fee deducted by the platform.
Low Project Minimum: Projects can be launched with a minimum project budget of just $10, making the platform accessible for small tasks as well as large enterprise milestones.

Because clients face zero platform commissions, project budgets remain strictly focused on the scope of work rather than administrative overhead.

---

Freelancer Platform Fee: 10.0% Commission

Freelancers pay a straightforward 10.0% commission on completed milestone transactions.

Key Fee Details for Freelancers

Pay Only When You Earn: Platform fees are only charged upon the successful completion and approval of a milestone. If a project is not completed, no commission is charged.
Automatic Deduction: The 10.0% fee is automatically calculated and deducted when funds are released from escrow into your platform balance.
Predictable Take-Home: There are no variable sliding scales, complex calculation tiers, or unexpected deductions.

Example Calculation

When submitting proposals on /work or directly on a project page, you can easily calculate your net payout:

Milestone Budget: $1,000.00
Platform Fee (10.0%): $100.00
Net Payout to Freelancer: $900.00 in USDC on Polygon

---

Repeat-Partner Dynamics and Long-Term Collaborations

FreddyWorks is built to facilitate enduring professional relationships. As clients and freelancers establish ongoing collaborations, working repeatedly with trusted partners brings distinct operational advantages:

Direct Milestone Continuity: Clients can seamlessly open new milestones for verified freelancers without administrative setup delays.
Frictionless Scoping: Repeat collaborations eliminate discovery overhead, allowing freelancers to price proposals efficiently while maintaining steady income streams.
Automated Dispute-Free Delivery: With established communication patterns and clear expectations, repeat contracts benefit from rapid milestone approvals and uninterrupted fund releases.

---

Zero Hidden Costs: No Subscriptions or Platform Withdrawal Fees

Many freelance platforms introduce recurring charges that penalize active users. FreddyWorks maintains a zero-subscription philosophy.

1. No Monthly Membership or Subscription Fees

Free Account Creation: Signing up as a Freelancer or Client costs nothing.
Free Proposals: Freelancers can browse projects on /browse and submit proposals without buying "connects," proposal credits, or monthly "Pro" memberships.
Free Job Postings: Clients can post an unlimited number of projects via /post at zero listing cost.
Full Feature Access: Advanced dashboard tools—including Gantt charts, project analytics, the AI Proposal

Posting & Managing Projects

Posting a project on FreddyWorks gives you direct access to global talent without intermediaries, high platform fees, or traditional banking delays. Because client accounts incur a 0.0% platform fee and FreddyWorks operates entirely without KYC requirements, you can outline your requirements, accept proposals, and begin collaboration quickly and securely.

This guide walks you through every stage of the hiring journey, from structuring your project listing to finalizing milestone payments using USDC on Polygon.

---

Creating and Publishing Your Project

To post a new job, navigate to /post from your client dashboard. A well-defined project description attracts higher-quality proposals and helps freelancers accurately estimate scope and timelines.

1. Title and Category

Project Title: Provide a concise, descriptive title that immediately tells freelancers what you need (e.g., Full-Stack Developer to Build Responsive Web Application).
Category and Subcategory: Select the relevant domain—such as Web Development, UI/UX Design, or Content Creation—to ensure your listing appears in the correct filters across /browse and search results.

2. Detailed Description and Deliverables

Clearly communicate the scope, objectives, and technical expectations of the project:

Outline background context and the problem you are solving.
List specific deliverables, requirements, and required file formats.
Mention any existing infrastructure, technical stacks, or design assets you will provide.
Use the built-in AI project assistant tools if you need help refining your project requirements or outlining technical specifications.

3. Required Skills and Tags

Tag your listing with the core competencies required for the job. Freelancers search and filter opportunities using semantic AI search and specific keywords, so accurate tagging ensures the right talent discovers your post.

4. Setting the Project Budget

Set your total estimated budget in USDC on Polygon.
The platform minimum budget is 10 USDC.
If you are unsure of the going rate for your requirements, you can leverage FreddyWorks' built-in AI budget estimator to benchmark appropriate market ranges.

---

Structuring Project Milestones

FreddyWorks utilizes a milestone-based escrow model to protect both clients and freelancers. Rather than committing your entire budget upfront, you break the project down into logical, deliverable-driven phases.

Why Milestones Matter

Phased Accountability: Freelancers work on one distinct phase at a time and submit specific deliverables for review.
Capital Efficiency: You only fund the active milestone into escrow. Subsequent milestones are funded sequentially as previous ones are completed and approved.
Risk Mitigation: If an engagement is canceled mutually, there is a 0% cancellation refund fee, and all unreleased escrowed funds return to your balance.

Example Milestone Breakdown

For a 1,000 USDC web development project:

Milestone 1 (300 USDC): Wireframes, UI/UX mockups, and platform architecture.
Milestone 2 (400 USDC): Core frontend and backend feature implementation.
Milestone 3 (300 USDC): Quality assurance, bug fixes, and deployment.

---

Reviewing and Managing Proposals

Once your project is live, freelancers can submit structured proposals detailing their approach, delivery timelines, and milestone pricing.

Evaluating Submissions

Proposal Content: Evaluate the freelancer's understanding of your requirements, proposed workflow, and turnaround estimates.
Public Profiles: Visit applicant profiles and public portfolio resumes at /r/username to review verified work history, client ratings, skill badges, and past project examples.
Platform Fee Context: Note that while clients pay 0.0% in platform fees, freelancers have a 10.0% commission automatically deducted from their earnings on completed milestones (which may decrease on future contracts due to the repeat-partner discount locked in at contract creation).

Communicating with Applicants

Before awarding a contract, open a dialogue using the integrated chat at /messages:

Clarify deliverable expectations, communication cadences, and milestones.
Utilize the platform's automatic translation features if collaborating with international freelancers across different languages.

---

Hiring a Freelancer and Funding Escrow

Once you select the best candidate, you can officially award the contract and initiate the project.

Accept the Proposal: Click Accept Proposal on the freelancer's submission. You can accept the proposed milestones as written or adjust terms mutually before finalization.
Fund the First Milestone: Deposit the required amount in USDC on Polygon using your connected Web3 wallet (such as MetaMask or Rainbow).
Escrow Activation: Once the deposit transaction confirms on the Polygon network, the milestone status updates to Active. The freelancer receives an instant notification that funds are safely held in escrow and work can officially begin.

---

Tracking Progress via the Dashboard

The FreddyWorks dashboard (/dashboard) provides real-time project management tools to help you track progress across active engagements:

Gantt Timeline: Visualize active, upcoming, and completed milestones across your project timeline.
Project Calendar: Monitor submission deadlines, scheduled deliverables, and review periods.
Real-Time Notifications: Receive immediate alerts when a freelancer submits a milestone for review, sends a message, or posts an update.
Inactivity Notice: Ensure communication remains active. If a project experiences 14 consecutive calendar days of inactivity without progress updates or milestone activity, it may be subject to platform auto-abort procedures.

---

Reviewing Submissions and Completing Projects

When a freelancer co

Posting a Service

The Services Marketplace at /services allows freelancers to package their skills into clearly defined offerings. Instead of submitting proposals to open job posts, you can publish structured service listings that clients browse, evaluate, and purchase directly.

Every service listing establishes your baseline scope, delivery timeline, and starting price in USDC on Polygon. Once purchased, the listing transitions into a structured, milestone-based contract protected by secure escrow.

---

Creating a Service Listing

You can create and manage your offerings from your dashboard or directly through /services. A well-configured listing clearly outlines what you provide, sets accurate expectations, and provides clients with a seamless onboarding experience.

Listing Details and Scope

When setting up your service, you will configure the following parameters:

Service Title: A concise, action-oriented headline describing exactly what you build, design, or deliver (e.g., Full-Stack Web App UI Design & Component Library).
Tags & Categories: Relevant search tags that allow clients to find your offering using keyword queries and semantic search across the platform.
Description: A comprehensive breakdown of your service, methodologies, tech stack, and what is included versus excluded.
Specific Deliverables: A bulleted checklist of tangible items the client will receive upon completion (e.g., Figma source files, documented React components, deployment scripts).
Delivery Time: The estimated timeframe required to complete the entire engagement under standard conditions.
Included Revisions: The number of revision rounds included with the base scope.
Starting Price (in USDC on Polygon): Your baseline rate for the core offering. The minimum project value across the platform is 10 USDC.
Cover Image & Media: A high-resolution graphic or portfolio mockup that visually represents the final deliverable.

Real-Time Live Preview

As you fill out your listing details, FreddyWorks renders a live preview alongside your editing form. This shows you exactly how your service card will appear in search results and how the full service details page displays to prospective clients.

Use the live preview to verify formatting, check how deliverable lists render on different screen layouts, and ensure your cover image is properly framed and readable in both dark and light display modes.

---

From Service Order to Milestone Project

On FreddyWorks, service listings are not rigid, one-off purchases. Instead, purchasing a service initiates a structured engagement divided into sequential milestones.

```

Client Selects Service ───► Scope & Milestones Finalized ───► Client Funds Escrow ───► Work Begins

```

1. Scope Initialization

When a client selects your service, the starting price and listed deliverables populate the initial contract outline. If the project requires custom specifications or additional scope, both parties can refine the terms and adjust the final budget before execution.

2. Milestone Structuring

Every service engagement is divided into milestones. For larger or multi-stage services, work is broken down into progressive phases (for example, Milestone 1: Wireframes & Architecture, Milestone 2: Final Implementation & Assets). Each milestone has its own assigned USDC amount and clear delivery criteria.

3. Escrow Funding Before Work Begins

Before you begin work on any milestone, the client must fund the corresponding escrow balance in USDC on the Polygon network.

You should never commence work on an unfunded milestone.
The platform interface explicitly indicates when funds are secured in escrow.
Because client platform fees are 0.0%, clients fund the exact milestone budget agreed upon.

---

Milestone Deliveries and Getting Paid

Working through structured milestones protects your time and guarantees that funds are reserved before you commit resources.

Delivering Work

Once a milestone is ready, submit your deliverables directly within the project workspace. You can attach project archives, link to repositories, or share design environments. The client receives an automated notification to review your submission.

Approval and Payment Release

When the client reviews and approves your milestone delivery, the escrowed funds for that stage are released directly to your account balance.

Review Window: Clients have a 7-calendar-day review window to inspect deliverables and request revisions within scope or approve the release.
Auto-Release: If a client does not respond or request changes within 7 calendar days of submission, the platform automatically releases the escrowed milestone funds to your account balance (unless a dispute is actively filed).
Platform Commission: A 10.0% freelancer platform fee is deducted from the milestone amount upon release. If you collaborate with the same client across multiple repeat contracts, your platform fee decreases based on the platform's repeat-partner discount schedule.

---

Best Practices for High-Converting Listings

A successful service listing eliminates ambiguity and makes it easy for clients to purchase with confidence.

1. Define Concrete, Granular Deliverables

Avoid vague descriptions such as "I will build a website." Specify exact technical parameters:

Include: "Responsive 5-page static site built with Next.js, Tailwind CSS, clean semantic HTML, and deployment to your hosting provider."
Exclude: "Copywriting, brand asset creation, and custom backend API integration are available as separate add-on milestones."

2. Set Realistic Delivery Timelines

Clients evaluate delivery schedules carefully. Account for review periods, potential minor revisions, and your current

Profile & Resume Builder

Getting Started with Your Profile

On FreddyWorks, your profile is your digital identity, reputation hub, and primary marketing tool. Because FreddyWorks operates on a pseudonymous model with no KYC (identity documents are never requested), clients evaluate your capabilities based entirely on your portfolio, work history, skills, and client feedback.

Whether you are applying for project postings on /work or being discovered directly by clients through /freelancers, having a comprehensive, professional profile maximizes your visibility and winning rate.

To access your profile editor at any time, navigate to /profile from your user dashboard.

---

Core Profile Essentials

Your basic profile details provide clients with an instant snapshot of who you are, what you do, and your pricing.

Avatar and Professional Headline

Avatar: While real-world identification is never required, selecting a high-quality, distinctive avatar or brand icon helps you stand out in search results and project proposals. Use a clean, crisp image formatted as a PNG or JPG.
Professional Headline: Keep your headline concise and focused on your niche. Instead of a generic title like "Developer," use a descriptive headline such as "Full-Stack Web3 Developer | Smart Contracts & React Frontends."

Writing an Impactful Bio

Your bio should explain the value you bring to a project. Structure your bio into three key sections:

Introduction: State your core expertise, years of experience, and primary industries served.
Specializations: Highlight specific frameworks, tools, workflows, or problem-solving capabilities you bring to the table.
Collaboration Style: Outline how you communicate, deliver milestone updates, and ensure quality deliverables.

Keep your tone professional, direct, and focused on client outcomes. Avoid vague buzzwords in favor of concrete capabilities.

Setting Your Hourly Rate

Specify your baseline rate in USDC on Polygon.

Setting an accurate rate helps clients assess budget alignment before sending direct project offers.
You can use the built-in AI Pricing Advisor to gauge market rates for your specific skillset.
While individual projects on FreddyWorks are scoped into milestone-based escrow contracts, your profile rate serves as a clear benchmark for your standard pricing.

Selecting Your Primary Skills

The FreddyWorks platform uses semantic AI search alongside keyword indexing on /search and /freelancers. Adding accurate skills ensures your profile surfaces when clients look for matching talent:

Add relevant technical and domain-specific skills (e.g., Solidity, Node.js, Technical Writing, UI/UX Design).
Focus on your core proficiencies rather than listing every tool you have ever used.
Update your skills periodically as you expand your technical expertise.

---

Building Out Credentials and History

Detailed credentials build credibility and demonstrate consistent execution across past projects.

Work History

Documenting previous roles or freelance engagements provides context on how you operate within teams and independent contracts:

Role Title and Organization/Project: State your specific function.
Date Range: Provide clear timelines for past engagements.
Description and Deliverables: Summarize your core responsibilities and tangible achievements. Focus on measurable results (e.g., "Redesigned checkout flow, increasing conversion rate by 18%").

Certifications and Licenses

Adding relevant credentials validates your specialized knowledge:

Include the name of the certification (e.g., AWS Certified Solutions Architect, Certified ScrumMaster).
List the issuing organization and completion date.
Add credential URLs or verification links where applicable so clients can easily review your qualifications.

Awards and Recognitions

If you have won hackathons, received industry awards, or earned community honors:

Detail the title of the award and the hosting entity or event.
Add a brief summary explaining the criteria and the work submitted to win the recognition.

---

Curating a Winning Portfolio

Your portfolio visualizes the quality and depth of your work. Each portfolio item serves as concrete evidence of your ability to execute.

To add or manage portfolio entries:

Navigate to the Portfolio section in /profile.
Click Add Portfolio Item.
Complete the project entry details:
Project Title: A clear, descriptive title.
Cover Image & Media: Upload high-resolution screenshots, mockups, or design previews.
Project Summary: Explain the project objectives, the challenge addressed, and your specific solution.
Technologies Used: Tag the tools, libraries, or frameworks applied.
Live Links: Include links to active websites, GitHub repositories, or live demonstrations when available.

Aim to showcase 3 to 6 high-quality, relevant portfolio items rather than an overwhelming list of minor tasks.

---

Your Public Resume Page (`/r/username`)

Every freelancer on FreddyWorks automatically receives a dedicated, standalone public resume hosted at:

Search & Discovery

Overview of Search and Discovery

FreddyWorks provides robust discovery tools that allow clients to find top-tier talent and freelancers to find high-value contracts. Discovery operates through two complementary systems: direct Keyword Search for exact terminology matching, and Semantic AI Search for natural-language, intent-based queries.

Whether you are browsing open listings on /work or exploring the talent pool on /freelancers, advanced filtering options and intelligent matching ensure you connect with the right counterpart quickly and efficiently.

---

Finding Projects to Work On

Freelancers can discover new opportunities across multiple interfaces, primarily via the project browsing interface (/work and /browse) and the global search page (/search).

Keyword Search vs. Semantic AI Search

When searching for projects, you can tailor your approach depending on whether you have a specific technology stack in mind or a broader functional objective:

Keyword Search: Matches the exact words entered in the search bar against project titles, descriptions, and tag lists. Use keyword search when looking for exact terms such as Rust, Solidity, Figma, or Next.js.
Semantic AI Search: Analyzes the contextual meaning of your query rather than relying on exact word matches. If you search for "build a responsive dashboard that displays real-time price feeds", semantic search returns projects mentioning WebSockets, React analytics charts, or API integrations, even if the word "dashboard" was omitted in the project brief.

Project Filters and Facets

To refine search results on /work, use the sidebar filters to narrow down the project feed:

Category & Subcategory: Filter by domain, such as Software Development, UI/UX Design, Technical Writing, Smart Contract Auditing, or Marketing.
Budget (USDC on Polygon): Set minimum and maximum escrow budget ranges. All projects on FreddyWorks require a minimum budget of 10 USDC.
Required Skills: Select one or more specific skill tags. Results will prioritize projects requiring those core competencies.
Project Scope & Milestones: Filter based on estimated duration or single-milestone versus multi-milestone requirements.
Client History: Filter projects based on client track record and total volume funded in escrow.

---

Finding Talent in the Freelancer Directory

Clients can proactively recruit talent through the Freelancer Directory (/freelancers) rather than waiting for proposals on posted projects.

```

/freelancers Directory

├── Semantic Search Bar (e.g., "Full-stack developer with Polygon experience")

├── Filter Panel

│ ├── Primary Skill Tags (e.g., TypeScript, Python, Graphic Design)

│ ├── Project Budget Tier

│ └── Platform Activity & Completed Contracts

└── Freelancer Cards

├── Avatar & Pseudonymous Username

├── Bio & Headline

├── Top Skills & Portfolio Previews

└── Link to Public Resume (/r/username)

```

Freelancer Directory Filters

Clients can filter candidates across multiple dimensions to locate specialists:

Skills & Specialties: Match freelancers who have tagged specific frameworks, languages, or domain expertise.
Contract History & Experience: Filter by the number of successfully completed milestones and overall contract completion rate.
Recent Activity: Highlight freelancers who are actively logging in, submitting proposals, or taking on new contracts.

Evaluating Profiles and Public Resumes

Each freelancer profile provides comprehensive, verified work records without requiring real-world identity disclosures (no KYC is ever required). Profiles feature:

Public Resume (/r/username): A shareable, standardized summary of the freelancer’s skills, work portfolio, and on-platform reputation.
Portfolio Showcase: Live links, code repositories, design assets, and case studies uploaded directly by the freelancer.
Contract Track Record: Detailed history of past completed contracts, delivered milestones, and objective delivery metrics.

---

How Search Ranking Works

FreddyWorks uses an automated ranking system designed to surface the most relevant, reliable, and active participants for any given query. The ranking factors differ slightly between project and freelancer searches.

Freelancer Search Ranking Factors

When clients search for freelancers, profiles are ordered based on the following user-facing criteria:

Query Relevance & Semantic Alignment: Profiles whose bio, skills list, portfolio descriptions, and public resume match the conceptual intent of the client's search term receive top priority.
Contract Completion Track Record: Freelancers who consistently deliver approved milestones within agreed timeframes rank higher than inactive accounts.
Profile Completeness: Profiles with complete bios, structured skills, portfolio entries, and an up-to-date resume at /r/username receive higher visibility.
Platform Activity: Freelancers who actively submit proposals, respond to chat messages, and maintain up-to-date availability are prioritized over dormant profiles.

Project Search Ranking Factors

When freelancers search for open work, project listings are ordered based on:

Search Term Match: Alignment between the search query and the project title, milestone descriptions, and required skills.
Recency: Newer project postings appear higher by default in general feeds to ensure active opportunities are addressed quickly.
Clear Milestone Specifications: Projects with well-defined milestone scopes and funded escrow allocations rank more favorably in general browsing feeds.
Client Responsiveness: Projects posted by clients who actively review proposals and respond to messaging are given priority.

---

Best Practices for Search and Discovery

For Freelancers Seeking Cont

Security & Privacy

FreddyWorks is built on a trust-minimized, privacy-focused foundation. By pairing decentralized Web3 infrastructure with robust automated safety systems, the platform protects both clients and freelancers without requiring invasive personal disclosures or relying on traditional banking intermediaries.

This guide outlines the security measures protecting your account, transactions, and data on FreddyWorks, along with best practices to keep your funds and identity secure.

---

Privacy-First Architecture and No-KYC Policy

Traditional freelancing platforms require extensive identity verification, asking users to upload government IDs, proof of address, and sensitive financial records. FreddyWorks operates on a strict no-KYC (Know Your Customer) model.

Complete Pseudonymity: You are never asked to provide passports, national IDs, utility bills, or legal names to create an account, post jobs, submit proposals, or withdraw earnings.
Data Minimization: By eliminating identity verification requirements, FreddyWorks removes the risk of your personal identification documents being compromised in third-party data breaches.
Global Financial Inclusivity: Anyone with a supported Web3 wallet can participate in the digital economy without geographic or bureaucratic hurdles.

When registering, you select an account role—either Client or Freelancer. Because account types are permanent and cannot be changed or combined, your platform identity and operational history remain distinct, organized, and verifiable through on-platform reputation alone.

---

Wallet-Based Authentication and Withdrawal Security

FreddyWorks leverages modern Web3 authentication to replace insecure legacy password systems with cryptographic key pairs.

Connecting Your Wallet

Accounts interface directly with Web3 wallets such as MetaMask, Rainbow, or any compatible provider via WalletConnect and RainbowKit.

Cryptographic Signatures: Authentication occurs via cryptographic message signing. You verify your ownership of the connected wallet address without exposing private keys or seed phrases.
Non-Custodial Access: Your platform profile binds directly to your public address, preventing unauthorized password-reset takeovers.

Secure Withdrawals

Freelancers can withdraw their available balance at any time directly to their saved Polygon wallet address in USDC on Polygon. To secure account balances against unauthorized access:

Two-Factor Authenticator Requirement: An authenticator code is mandatory for every withdrawal request.
Automated Processing: Approved requests process automatically with a 0% withdrawal fee, eliminating manual processing delays while maintaining strict validation checks.

---

Milestone-Based Escrow Protection

Financial security on FreddyWorks revolves around milestone-based escrow funded exclusively with USDC on the Polygon network. Escrow ensures that freelancers are guaranteed payment upon successful completion of work, while clients retain full control over fund release based on deliverable quality.

```

[Client Funds Milestone] ──► [USDC Held in Secure Escrow] ──► [Freelancer Submits Work]

│

┌────────────────────────────────────────────────────┴────────────────────────────────────────────────────┐

▼ ▼

[Client Approves Work] [Client Does Not Respond]

│ │

▼ ▼

[Funds Released Instantly] [Auto-Release After 7 Calendar Days]

```

Escrow Safeguards

Upfront Funding: Before work begins on any milestone, the client deposits the required milestone funds into escrow. Work never begins on unbacked promises.
Minimum Project Threshold: The platform maintains a minimum project budget of 10 USDC, ensuring all contracts meet baseline transaction standards.
7-Day Auto-Release Window: Once a freelancer submits deliverables for review, the client has 7 calendar days to review the submission or request revisions. If the client does not respond within this window, the escrowed funds are automatically released to the freelancer.
14-Day Inactivity Auto-Abort: If a project remains completely inactive without funded progress or communication for 14 days, the system initiates an auto-abort protocol to safeguard stranded commitments.

---

AI-Powered Dispute Resolution and Evidence Snapshots

When project expectations diverge and direct communication does not resolve the issue, either party can trigger the formal dispute process.

Dispute Filing Window

Users have a 7-day window to submit a dispute on an active milestone. Initiating a dispute immediately freezes the 7-day auto-release timer, ensuring funds remain securely locked in escrow while the case is reviewed.

Evidence Snapshots and AI Analysis

FreddyWorks utilizes an automated AI dispute resolution system that objectively reviews contractual records:

Snapshot Capture: The system captures an immutable snapshot of the project scope, original proposal, agreed milestone deliverables, submission files, and the on-platform chat history.
Contractual Comparison: The AI reviews the submitted deliverables against the explicit specifications agreed upon in the contract milestones.
Dispute Resolution Outcome: The system determines fund distribution (full release, full refund, or partial split) based on obje