How Arette Works & Platform Guidelines
The definitive master reference guide to every capability, page, rule, and workflow in the Arette ecosystem.
1. Platform Overview & Sovereign Ecosystem
The sovereign talent network for high-stakes tech & creative work.
1.1 Mission & Sovereign Talent Philosophy
Core PhilosophyArette was built to replace opaque resumes, speculative gig platforms, and endless interview loops with verified competence. In an era where AI can generate text and boilerplate instantly, true talent is proven through real deliverable outputs, peer-reviewed engineering, and sovereign escrow execution.
1.2 Core Architecture & Protocol Modules
The platform operates across 5 integrated software pillars that feed into one sovereign reputation and payment ledger:
Showcase real code, Figma files, 3D models, and design systems scored by mathematical jury.
100% upfront client deposit protection with structured 1-4 lot deliverables.
3-5 day paid test milestones before permanent full-time hiring.
Autonomous cognitive engine for code review, resume audits, and mentoring.
In-browser coding sandboxes and masterclasses with affiliate revenue loops.
1.3 Explore Feeds & Talents Directory Navigation
Navigating the platform to find elite creative work, hiring opportunities, and vetted builders:
Browse "Just In", "Featured", "Awards", and category spotlights across Design, Code, 3D, and Audio.
Filter vetted creators by verified skills, hourly rates, timezone, and live availability badge status.
Browse ready-to-order fixed deliverable packages or custom milestone contracting scopes.
Discover full-time, contract, and paid trial opportunities from verified companies.
2. Self-Serve Ad Promotions & Campaigns
Scale reach across home feeds, search results, and category spotlights via CPC/CPM auctions.
2.1 How Promotions & The Self-Serve Engine Work
Arette features a real-time self-serve advertising engine on /promote. Creators, agencies, course authors, and hiring companies can sponsor their assets to amplify visibility. Sponsored cards display a refined, minimal "Sponsored" badge and blend naturally into the discovery grid without disrupting organic curation.
2.2 Campaign Creation & Targeting Placements
Choose any published Project, Service Gig, Job Post, Academy Course, or Agency Profile.
Target by creative disciplines (UI/UX, 3D, Frontend, AI), skills, country/region, or specific placements (Main Feed, Search Spotlight, Explore Sidebar).
Choose Cost-Per-Click (CPC) or Cost-Per-Thousand-Impressions (CPM). Set daily spending limits and total campaign caps in $ARC or USD.
2.3 Real-Time Telemetry, CTR & Budget Depletion
Monitor campaign telemetry live on your Campaign Dashboard. The engine tracks impressions, unique click-throughs (CTR), conversions (orders, job applications, or course enrollments), and cost-per-result. Campaigns pause automatically once the budget cap is reached.
2.4 Advertising Policies, Prohibited Content & Quality Rules
Promotions must represent legitimate creative work, vacancies, or educational courses. False advertising, deceptive clickbait, NSFW content, or copyright infringement result in immediate campaign termination without refund and account penalties.
3. Projects, Showcases & The 10x Jury Multiplier
Host high-fidelity portfolios, submit case studies, and earn monthly prize pool rewards.
3.1 Submitting a Project & Case Study Guide
Click "Post" (/post). Upload high-resolution hero cover shots, media carousels, embedded Figma frames, GitHub repository links, live production URLs, discipline tags, and write a structured case study detailing the problem, solution, and business impact.
3.2 Editing Projects, Media & Adding Collaborators
You can edit your project at any time by clicking "Edit Project" from your project page or profile. Update media assets, add or remove co-creators (which credits the project on their profiles upon acceptance), modify discipline tags, or toggle visibility.
3.3 The 10x Jury Multiplier & Anti-Smurfing Ledger
Community member votes count as 1.0x Effective Votes (requires 0.01 ARC token micro-fee to eliminate botting). Approvals from vetted industry masters (The Jury) apply a massive 10.0x Multiplier, propelling top-tier craftsmanship to the top of Explore leaderboards.
3.4 Monthly Excellence Cash Pools & Project Awards
Every 30 days, global leaderboards snapshot top-performing projects. Cash prize pools distribute automatically:
3.5 Challenges, Hackathons & Sponsor Prize Purses (/challenges & /prizes)
Arette regularly hosts sponsored design and engineering challenges with locked prize pools. Creators submit project briefs that meet prompt criteria to compete for cash bounties, hiring fast-tracks, and verified challenge winner badges.
4. Articles & Technical Insights
Publish in-depth engineering writeups, design analyses, and earn organic Credits.
4.1 Writing & Publishing Markdown Articles
In Articles → Write Article (/articles), author technical case studies, architectural deep-dives, or design critiques. Format with rich markdown, headings, code syntax highlighting, cover banners, and discipline tags.
4.2 Editing Articles, Embedding Sandboxes & Figma
Authors can update articles post-publication, embed interactive live code sandboxes, Figma prototype frames, and GitHub gists to provide readers with interactive demonstrations.
4.3 Earning Organic Credits & Reader Token Tips
High-signal articles earn organic reader token tips in $ARC, read-time XP distributions, and unlock featured placement in the Explore technical insights section.
5. Services, Milestone Escrow, Withdrawals & Disputes
100% Peace of Mind Escrow, 7-Day Auto-Approval, and Direct Bank Settlement Rails.
5.1 Listing a Service / 3-Tier Deliverable Packages
In Provider Studio → Create Service (/services), define your service package: title, category, 3 structured tiers (Basic, Standard, Premium), turnaround delivery days, revision counts, and deliverable checklist.
5.2 In-Chat Discovery, Client Inquiries & Ordering
Clients can order fixed tier packages directly or message providers to discuss custom project scopes. Providers and clients align on requirements in real-time before contracting.
5.3 Structured 1-4 Lot Milestone Scope Proposals
For complex contracts, providers create 1-4 lot milestone proposals inside the chat workspace. Each milestone has an explicit scope, delivery date, and price. Client acceptance locks 100% of the milestone funds into platform escrow.
5.4 Escrow Triple-Lock, 7-Day Clock & 24h Clearance
Uploading deliverables starts the 7-day (168h) auto-approval clock. If the buyer takes no action, funds auto-release to the provider. Approved funds clear a 24h security clearance before becoming withdrawable.
Live Milestone Escrow & Settlement Calculator
5.5 How to Withdraw Earnings to Your Bank
Once funds clear the 24-hour hold, they appear in your Withdrawable Available Balance.
Navigate to Services → Provider Studio → Orders & Overview (/services/provider/orders).
Choose Local Bank Transfer or Stripe Express for direct bank deposits.
Enter withdrawal amount. Bank transfers arrive within 1–2 business days. Platform fee: 8% on provider earnings ($0 fee for buyers).
5.6 How to File a Dispute & Resolution Arbitration
If an unresolvable disagreement arises on an active service order or Paid Trial milestone:
Inside the Order Workspace room options menu, click "File Dispute".
Escrow funds and the 7-day auto-release timer are instantly frozen.
Both parties submit chat logs, draft files, and agreed proposal specifications.
Arette mediators enforce a binding ruling (full refund, full release, or split).
5.7 Automated Invoices & Tax Receipts (INV-YYYY-XXXXXX)
Every completed service order, milestone release, or token purchase automatically generates a compliant, downloadable PDF invoice containing unique serial numbers, VAT/tax details, corporate addresses, and itemized fee breakdowns for accounting and tax compliance.
5.8 Instant Offers: 0% Direct Client Escrow Links (BYOC)
0% Platform Booking FeeInstant Offers allow creators, studios, and agencies to bring external clients (from Twitter, LinkedIn, WhatsApp, email, or inbound referrals) into Arette’s institutional escrow ecosystem via a single shareable link (/pay/:shareCode).
External buyers do not need an account beforehand. They review a legally binding Statement of Work (SOW), deliverables list, and mutual NDA, then pay via Stripe (Card / Apple Pay) or Paystack (Cards / Bank Transfer).
Choose between 100% Upfront Escrow or 50/50 Split Escrow (50% upfront deposit to initiate kickoff, 50% balance funded upon final milestone approval).
Direct client bookings via Instant Offer links waive the standard platform fee. 100% of the project funds go directly to the creator upon milestone approval.
- Navigate to Services → Orders & Overview → Instant Offers (/services/provider/orders?tab=instant_offers).
- Click "+ Create Instant Offer" to open the scope builder.
- Set your title, deliverables checklist, total price, currency, revision limits, and optional Mutual NDA.
- Copy your customized share link (
/pay/:shareCode) or the formatted ready-to-send DM pitch to send directly to your client.
6. Jobs, Contract-to-Hire ATS & Recruiting Suite
Funded Paid Trials, 4-Pillar Scorecards, Blind Merit Mode, and Dynamic Offer Letters.
6.1 How Candidates Apply & Track Pipeline Status
Browse openings on /jobs. Click 1-Click Apply. Use Maya Cover Letter AI to generate tailored application copy. Track your application status (Applied → Review → Trial → Offer) in your Candidate Dashboard. Application token fee: 0.02 ARC.
6.2 Requirements & Guide to Posting Jobs for Employers
In Recruiter Suite → Post Job, set compensation range, required tech skills, screening questions, and Paid Trial brief specs. Publishing fee: 0.05 ARC (included unlimited in Agency tier).
6.3 Candidate Match Score (0–100%) & Maya Code Audit
Maya parses uploaded candidate resumes and audits verified portfolio repos, calculating a 0–100% semantic job match score with tailored technical interview question recommendations.
6.4 4-Pillar Scorecards & Candidate Ratings
Interview panels rate candidates 1.0 to 5.0 across 4 structured rubrics: Domain Competency, Problem Solving, Communication, and Team Culture Fit. Scores aggregate into an objective hiring scorecard.
6.5 Blind Merit Mode & Unconscious Bias Elimination
Toggle on Blind Merit Mode to mask candidate names, photos, gender, and contact info during early screening to evaluate purely on technical deliverables and proof-of-work.
6.6 Interview Scheduling & Automated Status Emails
Send automated interview scheduling links, rejection feedback emails with respectful templates, and status milestone triggers directly from the candidate pipeline table.
6.7 Contract-to-Hire Paid Trials (3–5 Day Escrow Tests)
Instead of multi-round whiteboard quizzes, employers convert shortlisted applicants into a funded 3-5 day Paid Trial milestone in protected platform escrow. If deliverable standards are met, convert to full-time hire at $0 recruiter penalty fee.
6.8 Dynamic Executive Offer Letters & SHA-256 E-Sign
Generate customized executive PDF offer letters with base salary, bonuses, stock options/RSUs, and reporting structures. Includes dual-party e-signatures with SHA-256 cryptographic verification seals.
6.9 2-Way Sync with Greenhouse, BambooHR & Workable
Connect existing applicant tracking systems to bi-directionally sync candidates, interview stages, and feedback scorecards without duplicate manual data entry.
7. Collections: Project Moodboards & Talent Rosters
Organize creative inspiration and bookmark candidate benches.
7.1 Creating Moodboards & Talent Rosters
Click the bookmark icon on any project or talent card to save to existing collections or create a new collection with a custom title, description, and cover shot.
7.2 Public vs Private Collections & Collaborative Curation
Public Collections appear on your profile and in Explore feeds for community curation. Private Collections remain visible only to you and invited team members.
8. Teams & Creative Studios
Form agency collectives, list team services, and collaborate on client pitches.
8.1 Creating & Customizing Studio Profiles
Set up your creative studio profile with a custom slug, agency logo, bio, verified website, and showcase aggregated work from all members in a collective studio portfolio.
8.2 Inviting Members & Role Permissions
Invite collaborators by handle, assign Lead / Member permissions, and delegate who can accept briefs or represent the studio in client pitches.
8.3 Team Gigs & Automated Client Revenue Splits
List complex services as a studio entity. Configure automatic revenue split percentages among team members for completed client milestone contracts.
8.4 Team Tier Allocations & Studio Badges
Free Starter accounts can join 1 team; Pro and Agency subscribers can create and administer multi-seat agency studios with verified checkmarks.
9. Companies & Enterprise SAML 2.0 / SSO
Institutional identity federation, JIT provisioning, and GDPR compliance.
9.1 Adding & Managing Corporate Entities
In Settings → Organizations, register company profiles, upload corporate logos, verified domain verification, and invite recruiters and hiring managers.
9.2 SAML 2.0 / Enterprise Single Sign-On (SSO) & JIT Provisioning
Federate identity across Okta, Google Workspace, Microsoft Entra (Azure AD), or OneLogin. Upload your IdP X.509 certificate (AES-256 encrypted at rest) and configure corporate domain whitelisting for automatic Just-In-Time (JIT) employee onboarding and collaborative recruitment workspace routing.
- In Okta Admin, navigate to Applications → Create App Integration → SAML 2.0.
- Single sign-on URL:
https://arette.xyz/api/auth/sso/callback/:company_slug(check Use this for Recipient and Destination URL). - Audience URI (SP Entity ID):
https://arette.xyz/api/auth/sso/metadata/:company_slug - Default RelayState:
:company_slug - Name ID format:
EmailAddress| Application username:Email - Attribute Statements:
email→user.emaildisplayName→user.firstName + " " + user.lastNamedepartment→user.department
- Copy Okta's SSO URL, Issuer, and X.509 Certificate into Arette Company Settings.
- In Google Admin Console, go to Apps → Web and mobile apps → Add custom SAML app.
- Download the Google IdP certificate and copy the SSO URL & Entity ID.
- ACS URL:
https://arette.xyz/api/auth/sso/callback/:company_slug - Entity ID:
https://arette.xyz/api/auth/sso/metadata/:company_slug - Name ID format:
EMAIL| Name ID:Basic Information > Primary email - Attribute Mapping:
email→Primary emaildisplayName→First namedepartment→Department
- Turn User access to ON for everyone.
In your Arette Company SSO settings, enter your company's domain(s) in Corporate Email Domains (Comma-separated) (e.g. arette.xyz, company.com). When an employee types their work email on the Arette login screen (e.g. maya@arette.xyz), Arette automatically:
- Detects your organization's SAML configuration and hides the standard password field.
- Generates an RFC 1951 raw DEFLATE-compressed
SAMLRequestredirect to your Identity Provider. - Just-In-Time (JIT) Provisions the employee on their first login: marks them
is_verified: true, upgrades their profile toPROtier, and auto-assigns them to your recruitment workspace as a Reviewer/Interviewer without requiring manual admin invites. - Maintains employee personal token wallets at
$0.00for platform security; corporate contracts and job postings are funded through the central company owner billing account or Stripe/Paystack corporate cards.
https://arette.xyz/api/auth/sso/callback/:company_slughttps://arette.xyz/api/auth/sso/metadata/:company_slug*Note: Each registered organization receives its own dedicated tenant URL (replace :company_slug with your organization's handle, e.g. olucorp). For local testing, use http://localhost:3000 instead of https://arette.xyz.
| IdP Attribute Name | Arette System Key | Description |
|---|---|---|
| email / nameID | user.email | Corporate email address (mandatory) |
| displayName / firstName + lastName | user.display_name | User's full display name |
| department | user.department | Corporate department/division |
| role / groups | company.role | Workspace role: Admin, Recruiter, or Reviewer |
9.3 GDPR / CCPA 1-Click Candidate Anonymization
Execute 1-Click Right-to-be-Forgotten data anonymization (`ANON-XXXXX`) and automated 365-day candidate data purge schedulers for compliance with global privacy regulations.
9.4 Company Multi-Seat Tiers & Recruiter Permissions
Manage multi-seat enterprise licensing with granular role-based access control (Owner, Admin, Recruiter, Interviewer).
10. User Tiers & Feature Gating
Starter, Pro, and Agency subscription tiers and feature permissions.
10.1 Starter Plan ($0 / mo)
Free TierBasic portfolio hosting, 0.15 ARC monthly token allowance, 50 Maya AI credits, 1 team membership, and public Explore directory access.
10.2 Pro Plan ($2.50 / mo)
Creator TierVerified Pro Badge, 0.75 ARC monthly tokens, 150 Maya AI credits, unlimited collections, featured project boosts, priority client discovery, and lower withdrawal fees.
10.3 Agency & Enterprise Plan ($6.99 / mo)
Enterprise TierFull Recruiter ATS Suite, unlimited Paid Trial contracting, 2 ARC monthly tokens, 400 Maya AI credits, SAML SSO integration, and multi-company management.
10.4 Detailed Feature Gating Matrix
Check /pricing for the full comparative matrix detailing token rates, Maya allowances, team limits, and API access across plans.
11. User Settings, Resumes & Availability
Configure public credentials, resumes, and availability indicators.
11.1 Profile Customization, Custom Handle & Social Links
Update username handle, bio, headline, timezone, hourly rate, GitHub, Figma, Dribbble, Twitter, and LinkedIn social links on /settings.
11.2 PDF Resume Upload & Automated Skill Parser
Upload PDF resume. The system automatically extracts work experience, education, and technical skills into your public profile credentials.
11.3 Live Availability Badges ("Freelance", "Deep Work", "Full-Time")
Toggle your availability status between "Available for Freelance", "In Deep Work", or "Open to Full-Time" to prioritize ranking in Recruiter search results.
11.4 Maya AI Cover Letter Generator
Configure default preferences for Maya to tailor your job application cover letters using your verified project case studies and skills.
12. Central Maya AI Ecosystem
Autonomous co-pilot across code debugging, candidate audits, and authoring.
12.1 Central Maya Interface & Freeform Copilot
Access /maya for freeform AI reasoning, architecture brainstorming, technical code reviews, and career path roadmapping.
12.2 Classroom In-Video Code Debugger & Lesson Tutor
Inside the Academy video classroom, Maya analyzes live browser terminal code, explains complex algorithmic concepts, and assists students through debugging.
12.3 ATS Candidate Screener & Interview Pack Builder
Maya audits candidate repositories, verifies commit frequency and architectural depth, and provides recruiters with tailored question packs.
12.5 Maya Monthly Credits & Instant Top-Ups
Monthly allowances: Starter (50 credits), Pro (150 credits), Agency (400 credits). Instant top-up packs can be purchased with $ARC tokens anytime.
13. Academy, Course Builder & Affiliate Commissions
Interactive browser sandboxes, Instructor Studio, and up to 50% referral commissions.
13.1 Interactive In-Browser Coding Sandboxes & Learning
Learn directly in the browser. Watch high-definition video lectures alongside live code editors and terminals without installing local dependencies.
13.3 Course Builder: Quizzes, Chapters & Pass Marks
Design chapter milestones with auto-graded multiple choice quizzes, set passing thresholds, attach downloadable project files, and track student completion rates.
13.4 Verifiable Cryptographic Certificates & Cart
Graduating from a masterclass generates a tamper-evident certificate with a unique SHA verification hash (/certificates/:hash). Students can add multiple courses to their Cart Drawer for unified checkout.
13.5 Affiliate Referral Engine (Up to 50% Commission)
Generate referral links with 30-day tracking cookies and Sub-ID tags on /commissions to earn up to 50% commission on course sales.
13.6 Brand & Agency Sponsored Scholarships
Apply for full tuition scholarships on /scholarship funded by sponsor brands for emerging market creators.
14. Dual-Layer Economy & Token Ledger ($ARC)
Withdrawable fiat deliverable escrow vs in-app micro-utility $ARC tokens.
Hard fiat earned from completed services, paid trials, course sales, and affiliate commissions. 100% withdrawable to local banks or Stripe.
Micro-utility tokens for zero-spam voting (0.01 ARC), commenting (0.005 ARC), boosting projects (0.01 ARC), and posting jobs (0.05 ARC).
14.2 Purchasing $ARC Utility Token Bundles
Purchase token bundles on /tokens using local cards or bank transfers to support voting, commenting, and job applications.
14.3 Micro-Action Token Fee Schedule
15. XP Progression, Streaks & Badges
Gamified reputation leveling and dynamic credit exchange.
15.1 Earning XP Across Creative & Learning Activities
Earn XP for submitting projects (+150 XP), maintaining daily login streaks (+10 XP), voting on community showcases (+5 XP), completing Academy lessons (+25 XP), and delivering milestone deliverables.
15.2 Dynamic XP to Credit Conversion Formula
Accumulated XP automatically converts to platform Credits at the rate of 2,000 XP = 1 Credit to unlock features and rewards.
15.3 Cryptographic Profile Badges & Honors
Earn verifiable badges displayed on your public profile: Verified Pro, Jury Member, Top Contributor, Hackathon Winner, and Academy Graduate.
15.4 Profile Onboarding & Deep-Work Burnout Telemetry
New members follow an interactive Profile Completion checklist to earn starter XP bonuses. Platform wellbeing telemetry monitors continuous deep-work sessions (4+ hours) and suggests ergonomic rest breaks.
16. Real-Time Chat, Workspace Drawer & SOW Sign-Off
Real-time Socket messaging, asset exchange, and in-chat contract proposals.
16.1 Real-Time Socket Messaging
Direct 1-on-1 and team communication with live typing indicators, delivery receipts, and online presence tracking.
16.2 Workspace Context Drawer & File Sharing
A dedicated right-hand sidebar displaying active milestone briefs, attached Figma/GitHub links, NDA files, and delivery archives.
16.3 In-Chat SOW Sign-Off & Escrow Funding
Review structured proposals inside the chat stream and fund escrow with 1 click without leaving the conversation.
17. Analytics & Telemetry Dashboards
Track portfolio traffic, escrow financial GMV, and recruiter hiring funnels.
17.1 Creator & Portfolio Traffic Telemetry
Track unique visitors, project view counts, click-through rates, and follower growth trends across your showcases.
17.2 Financial GMV, Escrow & Clearance Telemetry
Monitor gross merchandise volume (GMV), active escrow contracts, 24-hour clearance countdowns, and net lifetime earnings.
17.3 Recruiter Hiring Funnels & Velocity
Track applicant drop-off rates across review stages, time-to-hire velocity, and Paid Trial conversion percentages.
17.4 Company & Team Visitor Tracking Intelligence
See which verified companies, venture capital scouts, and studio recruiters visited your profile on /analytics.
18. Rules, Safety & Enterprise Governance
Zero tolerance rules, SOC2/GDPR compliance, and formal appeal procedures.
AES-256 encrypted credential vaults at rest; TLS 1.3 enforced for all API traffic in transit.
PCI-DSS Level 1 compliant financial processing through Stripe Connect and Paystack rails.
1-Click Right-to-be-Forgotten candidate anonymization and automated purge lifecycle.
High availability enterprise SLA backed by automated multi-region daily database snapshots.
18.1 Zero Tolerance Violations & Safety Rules
- Anti-Smurfing & Vote ManipulationCreating proxy accounts or coordinating bulk vote brigades results in immediate leaderboard disqualification and account termination.
- Plagiarism & Uncredited WorksPublishing other creators' work without authorization triggers immediate content removal and reputation reset.
- Off-Platform Circumvention on EscrowSoliciting off-platform payment on active service briefs voids escrow guarantees and may freeze withdrawal access.
18.2 Content Flagging Queue & Formal Dispute Appeals
Users can flag suspicious content or appeal moderation actions directly through our formal review desk. Arette compliance officers review submissions within 24 hours to ensure fair platform governance.
18.3 Instant Offer Anti-Fraud Guardrails & Moderation Protocol
Trust & Safety ProtocolTo protect clients and prevent financial crime, money laundering, or abusive contracting, all Instant Offer links operate under strict platform guardrails:
Creators who have not completed identity verification (KYC) are capped at a maximum of $1,500 USD (or equivalent in other supported currencies) per instant offer link. Completing KYC unlocks unconstrained commercial contracting volume.
Creators cannot purchase or fund their own instant offer proposals. Self-dealing transactions where the buyer’s email, registered user identity, or wallet matches the creator are hard-blocked at both intent authorization and payment confirmation.
Every public checkout page includes a discreet reporting channel for phishing, impersonation, or copyright violations. If a link receives 3 or more independent reports, the proposal is automatically suspended and escrow authorization is locked pending review.
Platform compliance officers actively inspect proposals on the Admin Services & Escrow Monitor (/admin?tab=services-escrow), with the ability to audit report logs, suspend illicit links, or restore legitimate proposals immediately.
Was this documentation helpful?
Help us continuously refine the Arette operational handbook.