Build your own Yelp with Claude Code

A local business review site: business listings with hours and photos, star reviews, search by category and area and more.

WeekendA working first version in a day or two

The Claude Code prompt

Build my own take on Yelp: a local business review site. Give it an original name, logo, colours and copy, and do not use Yelp's name, branding or assets.

Version one should have:
- Business listings with hours and photos
- Star reviews
- Search by category and area
- Map view
- Business owner claims

The hard part: Seeding listings and stopping fake reviews. Start in one city and verify reviewers.

How to build it:
1. Read this folder first. If it is empty, set up Next.js (App Router, TypeScript, Tailwind) with Postgres through Prisma or Supabase, and Supabase Auth or Auth.js for sign-in. Write a short PLAN.md with the data model, screens, third-party services and what you are leaving out of version one.
2. Build the core loop end to end before anything else: business listings with hours and photos, working with real data saved to the database.
3. Add the rest of the features one at a time, and seed realistic demo data so every screen looks alive.
4. Keep API keys in environment variables, and put any paid service behind a small interface with a local stub, so the app runs on a fresh machine without accounts.
5. Run it, click through every screen on desktop and mobile widths, fix what breaks, and finish with a summary of what works, what is stubbed and how to deploy it.

Paste it into Claude Code in an empty folder. It plans first, so read PLAN.md and steer before it starts building.

Version one

  • Business listings with hours and photos
  • Star reviews
  • Search by category and area
  • Map view
  • Business owner claims

The hard part

Seeding listings and stopping fake reviews. Start in one city and verify reviewers.

Make it yours: a niche Yelp ignores, an original name and brand, and one feature it does badly done well.

More to build

More in Booking & local · Every build idea