DEV3 Mileroost – Freelance Marketplace Laravel Script with Escrow Milestones, Hourly Billing & Flutter App

Mileroost is a freelance marketplace you operate, built by DEV3 Technologies on Laravel 12 and Filament 4, with one Flutter app that switches between client and freelancer modes. Clients post projects or buy gigs, freelancers send proposals with bid credits, and the money for each milestone is held in your platform's escrow wallet until the work is approved. Your staff run disputes, payouts and trust and safety from the operator panel.

What it does

• Projects and proposals. Clients post fixed-price or hourly projects with skills, budget and screening questions. Freelancers send proposals that cost bid credits (called roosts), can boost a proposal, and see a fee estimate before they send. Clients shortlist, compare up to three proposals side by side and hire.
• Escrow milestones. A fixed contract is split into milestones. The client funds one, the freelancer submits work, and the client approves, asks for changes (with a revision limit) or opens a dispute. If the client stays silent, the milestone releases itself after the number of days you set. Every transition is idempotent and journalled.
• Hourly contracts. Freelancers log time with a timer or manual entries under a weekly cap. The week closes in the client's timezone, the client reviews it, can dispute single days, and the invoice is charged and released.
• Gigs. Freelancers sell fixed packages (basic, standard, premium) with delivery days and revisions.
• Disputes. Both sides add evidence to a hash-chained timeline. Your staff rule with a split preview: release, refund or any percentage, and the ruling posts to the escrow wallet in one step.
• Fee tiers. A service fee by lifetime billings per client and freelancer pair, applied marginally across bands, plus an optional client fee. Everything you can change sits in Settings.
• Payouts and KYC. Earnings mature after a holding period, freelancers request payouts, finance builds a weekly batch and marks it processed. ID and address documents are reviewed by hand before the first payout.
• Reviews and messages. Double-blind reviews after a contract ends, one message thread per contract with attachments and a meeting-link field.
• Operator panel. Users, projects, contracts, an escrow board with ageing and an auto-release queue, disputes, payments and refunds, payout batches, KYC queue, reports, catalogue, fee tiers and roost packs. Roles for owner, trust and safety, finance and support.
• The Roost Ladder. A dashboard strip showing how milestones climb from waiting for funding, through funded and submitted, to approved and released.
• Flutter app. One app for both modes: post a project, compare proposals, hire, fund a milestone, review work, run a timer, submit work, request a payout, message, dispute and review. Demo mode works without a server, and the source is included.

Install and demo data

A web installer checks the server, writes the configuration, migrates and loads demo data or an empty install, then creates the operator account. The demo is a fictional marketplace with about 9,000 users, 16,000 projects, 190,000 proposals and 7,500 contracts. Every demo password is password. Node.js is not needed because compiled assets are included.

Good to know before you buy

• You are the merchant of record. Client funds for milestones are held in your platform's escrow wallet and released to freelancers' earnings. Payments and payouts are simulated until you connect a gateway that supports marketplaces. This is not a licensed escrow service: you are responsible for payment and money-transmission licensing where you operate.
• Disputes are decided by your staff from an evidence timeline. There is no appeal and no arbitration service in 1.0.
• Hourly work uses timesheets (manual entries and a timer). There is no screenshot or activity monitoring. Automatic hourly charging works with the simulated gateway only; real gateways use the client's hosted checkout.
• KYC is manual document review. There is no identity-verification API.
• No video calls. Contracts carry a meeting-link field. No AI matching, proposal writing or dispute decisions.
• One marketplace currency, with display conversion only. Roost packs are bought on the web; the app shows balances.
• One Flutter app (client and freelancer modes) with source. Store publishing is your step, and a guide is included.
• A cron entry is required (schedule:run every minute) for auto-release, weekly billing, maturity and reminders.
• No hosted demo. The brands, people and places in the screenshots are fictional.

Quality checks

Mileroost 1.0.0 passed the seven release gates of the DEV3 Laravel suite on the final code: static analysis (Larastan level 6), the Pest suite (322 tests, 75 of them money vectors), a front-end size budget, migrations and seeding on MySQL 8 and SQLite, a headless-browser pass over 60 pages with full happy paths and a dispute path, MySQL race checks (double release, dispute against release, double fund, payout requests, last roosts and weekly caps), an installer test from the package and a secret scan. The app passed 263 Flutter tests, including the same money vectors and a run against the live backend. A review of the escrow, fee and dispute logic found sixteen issues, all fixed before release.