Traders Marketplace — Directory & Listings Platform
About this MVP
A production-oriented directory and listings marketplace built with Next.js 16, React 19, TypeScript, Tailwind CSS, Prisma, and PostgreSQL. It ships complete buyer, seller, and administrator journeys: category-led discovery, text and map search, listing detail pages, seller profiles, favourites, saved searches, enquiries, messaging, review moderation, listing management, onboarding, reporting, account privacy controls, audit logs, and installable PWA support. Authentication uses secure cookie sessions with refresh rotation, same-origin mutation protection, rate limiting, email verification, password recovery, and role-aware authorization. The database includes migrations and realistic seed data; Vitest and Playwright cover the core API and browser journeys. Docker targets separate migrations, workers, build, and runtime services, while the CI workflows run type, unit, browser, dependency, and security checks. Stripe billing, S3-compatible media storage, Mapbox maps, email delivery, and web push are integrated but require the buyer's own production credentials. Ideal for agencies, local-business networks, trade directories, service marketplaces, and founders launching a niche classifieds or discovery platform.
Includes database migrations and realistic seed data, authenticated buyer/seller/admin flows, automated unit and browser coverage, Docker migration/worker/runtime targets, and CI security checks. Stripe, S3-compatible storage, Mapbox, email, and web-push features are ready to configure with production credentials.
Tech stack
Features
What's included
Details, reviews & discussion
Fit and launch readiness
Review the product stage, ownership terms and launch evidence before choosing your build.
- Type
- MVP Kit
- MVP level
- Launch-ready
- Ownership
- Non-exclusive license
Who it's for
Agencies, trade associations, local-business networks, and founders launching a niche directory, classifieds site, or service marketplace.
Problem solved
Provides the difficult marketplace foundation—three role-specific products, searchable listings, enquiries, reviews, moderation, commercial workflows, and production operations—so a team can focus on its niche, supply, and brand.
Readiness evidence
Includes database migrations and realistic seed data, authenticated buyer/seller/admin flows, automated unit and browser coverage, Docker migration/worker/runtime targets, and CI security checks. Stripe, S3-compatible storage, Mapbox, email, and web-push features are ready to configure with production credentials.
Traders Marketplace — a Full-Stack Directory and Listings Platform
Traders Marketplace is a polished foundation for launching a niche business directory, local-services marketplace, trade network, or classifieds product. It combines the public discovery experience with complete buyer, seller, and administrator workspaces in one Next.js application.
What is included
- Public marketplace: category discovery, full-text and location search, map results, filters, listing detail pages, seller profiles, reviews, and enquiry actions.
- Buyer account: profile and privacy controls, favourites, saved searches, enquiries, messages, and review management.
- Seller workspace: guided onboarding, company profile, listing management, leads, messages, analytics, subscription visibility, and account settings.
- Admin operations: marketplace metrics, listing and seller moderation, users, categories, plans, audit logs, and system settings.
- Platform foundation: secure cookie authentication, refresh rotation, role-based access control, same-origin mutation protection, request throttling, email verification, password recovery, PWA installation, web push, structured metadata, sitemap, and robots routes.
- Data and operations: Prisma/PostgreSQL migrations, realistic demo seed, Docker services for migrations, workers, and the web runtime, plus CI workflows and Vitest/Playwright coverage.
Built for honest demos
The included screenshots were captured from the running application using its real seeded database and authenticated demo accounts. Ratings, seller totals, review distributions, listing analytics, and admin metrics come from stored records rather than presentation-only constants. This marketplace listing starts without seeded MVPHub reviews or popularity activity and earns those independently.
Integrations
Stripe billing, S3-compatible media storage, Mapbox maps/geocoding, transactional email, and standards-based web push are implemented. They are intentionally credential-gated: bring your own production accounts and secrets before enabling those services in a live deployment. Local development remains usable with the documented demo configuration.
Tech stack
- Next.js 16 App Router, React 19, TypeScript, Tailwind CSS
- Prisma ORM and PostgreSQL
- Stripe, Amazon S3-compatible storage, Mapbox, Nodemailer, web-push
- Vitest unit/integration tests and Playwright browser tests
- Multi-stage Docker image with dedicated migration, worker, builder, and non-root runtime targets
Demo access
Live demo: https://traders-marketplace.mvp.sale
The demo ships seeded buyer, seller, and admin accounts so each role can be evaluated end to end. Production deployments should replace all demo credentials and configure the required integration secrets.