Roomly | Hotel Booking Marketplace — Flutter App and Web Admin Panel

Roomly is a multi-vendor hotel booking marketplace (OTA) you deploy and operate. Hotels list room types, rates, and availability; travellers search, book, and pay; you earn a commission on every confirmed booking. It ships as four polished surfaces built on one shared backend: a Flutter guest app (iOS + Android), an SEO booking website, a hotel dashboard, and an admin panel.

What makes it different: almost every hotel item in this category is a browse-and-book UI wrapped around a fake availability model. Roomly ships a real ARI engine (Availability / Rates / Inventory) — per-date allotments, rate plans, stop-sell, min-stay rules, and transaction-safe, row-locked double-booking prevention. Two people racing for the last room? One is confirmed, the other gets a clean “no longer available”. That, plus a working front desk and commission payouts, is the depth buyers discover is missing after they buy something cheaper.

Before you buy — honest v1 scope (please read). The booking engine, payments, commission, front desk, and all four surfaces are fully working. A few integrations are deliberately scaffolded, not finished, so nothing surprises you after purchase:

• Image / media upload is URL-based. The Cloudflare R2 / S3 env surface is reserved, but no in-app upload flow ships in v1 — the demo uses public image URLs.
• Mobile push notifications are not bundled. The Flutter app has in-app notification preferences, but no push provider (FCM/APNs) is wired in.
• Transactional email is scaffolded. SMTP settings and a status badge are in place; connect a nodemailer transport to send booking emails.

The full list — including AI rate-limiting, manual payouts, and i18n — is in ️ Roadmap & honest limitations further down. None of these block the core sell-rooms-and-collect-commission flow.

Four surfaces, one codebase

• Guest app (Flutter): search + map, live-priced property detail, room/rate selection, Stripe / PayPal / Pay-at-Hotel checkout, booking confirmation with QR, my-bookings with refund-preview cancel, post-stay reviews, dark mode.
• Hotel dashboard: onboarding wizard, occupancy/ADR/RevPAR KPIs, a genuine rate & availability calendar with inline and bulk edits, a full front desk (check-in with room assignment, check-out, walk-ins), housekeeping board, reviews, earnings & payouts.
• ️ Admin panel: hotel approvals, per-property commission overrides, global bookings, review moderation, payout batches, and marketplace settings.
• Public booking website: server-rendered for SEO with schema.org JSON-LD, destination and property pages, full web checkout, and guest booking lookup by reference — no account required.

⚙️ Built on a real engine

• Daily-granularity ARI — inventory and rate rows per date, availability as a single indexed query (no N+1), a rolling ~24-month horizon maintained by a background job.
• Double-booking prevention — inventory decremented inside the booking transaction with row locks and re-verification under lock.
• Money done right — integer cents everywhere; commission snapshotted at confirmation so later rate changes never rewrite history.
• Commission & payouts — global rate + per-property overrides, prepaid vs pay-at-hotel handled correctly (pay-at-hotel raises a “commission due” invoice netted against the next payout).
• ♻️ Cancellations — evaluated against the policy snapshot stored on the booking, with an accurate refund preview.
• Pluggable payments — one interface, Stripe + PayPal fully implemented, Pay-at-Hotel built in, Razorpay adapter ready to key in; idempotent, signature-verified webhooks.
• Optional AI — natural-language search and recommendations over OpenAI or Gemini, server-side, that hide themselves cleanly when no key is set (the product is 100% functional with zero AI keys).

AI features & disclosure

AI-usage disclosure (per Envato policy). Roomly can optionally use a third-party AI service — OpenAI or Google Gemini, your choice — to power two features: natural-language search (e.g. “a quiet beachfront hotel under $150 with a pool”) and property recommendations. That is the only place AI is used in the product.

• Optional and off by default. No AI key is included with the item. With no key set, the natural-language search box hides itself and Roomly falls back to keyword search + popularity recommendations — the product is 100% functional with zero AI.
• Server-side only. The AI request runs on your server; the model ID comes from env (OPENAI_MODEL / GEMINI_MODEL), and no AI key is ever shipped in the mobile app bundle or exposed to the browser.
• You supply the key and pay the provider. If you enable it, OpenAI or Google bills you directly for usage (see ” Third-party service costs” below). The model only returns a validated search-filter object — it never has direct access to your database.