intermediate~45 minutesmarketplace

Marketplace Starter — Cursor + Supabase

Two-sided marketplace with listings and payments

Full marketplace with seller profiles, buyer discovery, Stripe Connect split payments, and reviews. For developers building the next niche marketplace.

CursorNext.js 14SupabaseSupabase AuthStripe ConnectRailwayTailwind + shadcn/ui

What's Included

🏪

Seller Profiles

Create listings with images, descriptions, and pricing

🔍

Search & Discovery

Full-text search with category filters

💸

Split Payments

Stripe Connect splits fees between platform and sellers

Reviews

Buyer reviews and ratings per listing

📨

Messaging

In-app buyer-seller messaging

Setup Guide

1

Clone and install

Clone the marketplace starter and install deps.

$ git clone https://github.com/gptsters/marketplace-starter my-marketplace && cd my-marketplace && npm install
2

Create Supabase project

Go to supabase.com, create a project. Copy URL and anon key.

Add to .env.local

NEXT_PUBLIC_SUPABASE_URL=

NEXT_PUBLIC_SUPABASE_ANON_KEY=

3

Run database migrations

Creates listings, profiles, reviews, and messages tables.

$ npx supabase db push
4

Set up Stripe Connect

Enable Stripe Connect in your Stripe dashboard for split payments.

Add to .env.local

STRIPE_SECRET_KEY=

STRIPE_CONNECT_WEBHOOK_SECRET=

5

Deploy to Railway

Deploy your marketplace.

$ npx railway login && npx railway up
Deploy free →

Cursor Prompt

Paste this into Cursor to generate the full codebase

Build a two-sided marketplace:
- Next.js 14 App Router, TypeScript, Supabase
- Supabase Auth for buyers and sellers
- Listings: title, description, images (Supabase Storage), price, category
- Search: full-text search with category and price filters
- Stripe Connect: split payments (platform takes 10%)
- Reviews: star rating + text per transaction
- Messaging: real-time buyer-seller chat via Supabase Realtime

Database tables: profiles, listings, orders, reviews, messages
RLS: sellers see own listings, buyers see all published listings.

Tools You'll Need

Based on this starter's stack

Some links are affiliate links.

Common Issues

Related Starters

Frequently Asked Questions

~45 minutes. The setup guide walks you through every step with copy-paste commands. No guesswork.

Free to start. Railway's free tier includes 500 hours/month.

Yes. The starter kit gives you a working foundation. Use the included Cursor prompt to add features specific to your product.

Check our integration guides at /integrations and prompt library at /prompts for step-by-step instructions on adding any feature.