Overview
ReviewDesk is a review management app for small local businesses with one to ten locations, and you get the full source code. It pulls Google reviews into one inbox, drafts replies (from templates or an AI model you choose) and posts them back to Google once a person approves. After a visit it sends every customer the same short ask by WhatsApp, SMS, email or a take-home QR card, with two equal options: leave a Google review, or tell the business privately.
It suits agencies that manage reviews for local clients, developers who want to run a review SaaS under their own brand, and multi-location owners who want the tool in-house. It comes with a marketing site, three plans wired to Stripe Checkout, owner/manager/front-desk roles, and a seeded demo business so the whole desk can be explored before any API key is added.
Features
Review inbox and replies
- One inbox: Google and Facebook reviews from every location in one feed, filterable by status, stars, location, source, flagged and date.
- Reply drafts: One click writes a draft from your reply templates, or from OpenAI, Anthropic or Gemini when a key is set. A person approves and posts.
- Post to Google: Approved replies are posted to the Google Business Profile, and a posted reply can be deleted again.
- Auto-replies: Off, "draft on pull, person posts", or "post on pull" above a minimum star rating. Healthcare locations never auto-post.
- Status and assignment: Mark a review as needs reply, replied, escalated or reported, and assign it to a team member.
- Suspicious reviews: Flag a review as possibly fake and store the Google report case ID against it.
- Share card: Turn a good review into a PNG image for social posts.
Review requests
- Send after a visit: Pick a customer, a channel (WhatsApp, SMS, email or QR) and send a first ask or one reminder.
- Ask timing: Asks queue a set number of hours after a visit, with one reminder later, and a 90-day cooldown per customer.
- Two equal doors: Each location has a public ask page with "Leave a Google review" and "Tell us privately". The private note never hides the Google option.
- Take-home QR cards: A printable QR code per location that opens the ask page.
- Policy checks: Ask copy that filters for 5 stars, offers a gift or names staff is rejected. Replies that ask someone to change a rating are blocked, and healthcare replies cannot name a condition or procedure.
- Send log: Every ask and reminder with channel, location and status.
Customers and visits
- Customer list: Add visitors by hand or paste a CSV of name, phone and email.
- Consent by region: A region setting (India, United States, European Union) decides whether a customer must have agreed before a contact is stored and messaged.
- Visit webhook: A POST endpoint lets a booking or POS system report a visit, which queues the ask.
- Google Calendar visits: Connect a calendar (read-only) and finished appointments queue asks.
- Review matching: Matches new reviews to customers by name and phone, so people who already reviewed are not asked again.
Private feedback
- Feedback queue: Private notes from the ask page with a team score, theme tags and status (new, in progress, resolved).
- Recovery tracking: Record the recovery action (call, refund, rebook) and a note. Insights show an estimated recovered value from a per-ticket figure you set.
- Alerts: Email alerts for new private feedback and for new 1–2 star Google reviews. The review alert includes a ready reply and a signed link that posts it.
Locations and listings
- Location health: Each location is shown as Strong, Watch or Risk from its rating and unreplied reviews.
- Google import: Connect Google and import the Business Profile locations you manage.
- Listing checklist: Address, phone, website, hours, category and photo date, with a completeness score and a stale-photo warning.
- Google posts: Write an update, offer or event. It posts to Google when connected and stays a draft otherwise.
- Nearby snapshot: Pull nearby competitors' ratings and review counts from Google Places, or add them by hand.
- Review widget: An embeddable iframe per location showing the average rating and recent reviews.
Dashboard, insights and assistant
- Today view: A weekly briefing, counts for unreplied low ratings, open private notes, queued asks and listing gaps, plus a 14-day review chart.
- Insights: Rating over 30 days, review volume, praise/mixed/miss split, reply rate, median reply time and the themes people mention (wait time, staff, cleanliness, price and so on).
- Ivy assistant: A chat panel that answers questions about the desk from its own data and can draft a reply. An AI key makes the answers read more naturally.
Team, billing and admin
- Roles: Owner, manager and front desk, each with different permissions.
- Plans: Shop (1 location), Studio (up to 5) and Group (up to 10), enforced when adding locations. Stripe Checkout and a signed webhook update the plan.
- Settings: A "Wires" panel shows which services are configured, plus reply templates, tone, AI provider, ask timing, alert email and an audit log.
- Marketing site: Home, product, pricing, privacy and terms pages, and 32 industry pages (cafes, clinics, gyms, salons and more).
- Scheduled sync: One secured endpoint pulls Google reviews, runs auto-replies, processes calendar visits and sends queued asks. A GitHub Actions workflow calls it every 15 minutes.
Good to know
- Facebook reviews are imported with a manual "sync" button. Replies to Facebook reviews are saved on the desk but are not posted back to Facebook, and the scheduled sync does not pull Facebook.
- Inviting a team member creates their login with the demo password and sends no email. There is no password reset or change-password screen. Plan to add these before going live.
- The owner can still change the plan from Settings without paying, even when Stripe is set up. To make billing binding, lock that field to the Stripe webhook.
- The Harbor demo business is seeded on first start, and the login page has an "Open Harbor demo" button. Remove both for a production install.
- Google review and reply calls only return data after Google approves your Cloud project for the Business Profile API.
GOOGLE.md explains the steps.
- Without the scheduled sync, reviews only arrive on a manual pull and queued asks only go out while someone has the desk open.
Tech stack
- Next.js 16 (App Router, server actions), React 19 with the React Compiler, TypeScript
- Tailwind CSS 4
- PostgreSQL through the
postgres driver; tables are created on first request
- Email/password auth with hashed passwords and session cookies
- Direct REST calls to Google Business Profile, Google Places, Google Calendar, Facebook Graph, Resend, Twilio, WhatsApp Cloud API, Stripe, OpenAI, Anthropic and Gemini (no SDKs)
qrcode for take-home cards
- Docker, Fly.io config, pnpm
What's included
- Full Next.js app: marketing site, sign-up and login, the desk, and the public ask, private feedback, widget, share and reply-link pages
- Seeded demo business (three locations with reviews, customers, private notes and posts)
Dockerfile, docker-compose.yml for local Postgres, and fly.toml
- GitHub Actions workflow for the 15-minute sync
README.md with setup and deploy steps, and GOOGLE.md with the Google Cloud and Business Profile setup
.env.example listing every supported key
Requirements and third-party costs
You need Node 22+, pnpm and a PostgreSQL database. Only AUTH_SECRET, DATABASE_URL and APP_URL are needed to start. Every other service stays off until its keys are set, and the desk still runs: drafts come from templates, and asks can be sent as QR cards.
- Hosting and database (required): Any Node or Docker host, such as Fly.io, plus PostgreSQL.
- Google Cloud (required for Google reviews): An OAuth client and Business Profile API access, which Google must approve. The API itself has no fee.
- Google Places API (optional): Nearby competitor snapshot. Billed by Google per request.
- Resend (optional): Email asks and alerts.
- Twilio (optional): SMS asks, and WhatsApp asks through Twilio.
- WhatsApp Cloud API (optional): An alternative to Twilio for WhatsApp. Meta bills per conversation.
- OpenAI, Anthropic or Google Gemini (optional): AI reply drafts, the weekly briefing and the assistant. Templates are used without a key.
- Facebook app (optional): Importing Facebook Page reviews.
- Stripe (optional): Charging customers for the three plans.
- A scheduler (recommended): GitHub Actions or any cron service to call the sync endpoint every 15 minutes.
The purchase covers the source code only. Service fees are billed by the providers listed above.