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.
Screenshots
Related Apps
MVP ForSale Promo Storefront
MVP ForSale (mvp.forsale) is a server-rendered promotional listing storefront for an MVP Hub-style marketplace, built on Next.js 16 (App Router) and React 19 with plain JavaScript and zero UI-framework dependencies. It is a read-only catalog frontend: every page fetches the marketplace catalog server-side from MVP Hub's public API, so crawlers and link previews receive full HTML, and every buy action deep-links back to the marketplace with UTM attribution. SEO is the core feature set — per-listing metadata and Open Graph tags, schema.org Product JSON-LD with offer price and aggregate rating, canonical URLs, a live sitemap.xml generated from the catalog, robots.txt, and noindexed search results. The catalog UX covers category landing pages with data-derived subcategory chips, faceted search (category, tech stack, capability, price slider), client-side sort, listing detail pages with gallery, seller-provided markdown body (rendered with raw HTML stripped), readiness badges, verified-review counts, and multi-variant "from" price ranges. Data-integrity guards are built in: reviews are never fabricated, unpriced listings never show $0, demo buttons only render for real demo links, and sold-out or coming-soon sale statuses are respected. The visual theme is a distinctive hand-drawn wireframe aesthetic (Kalam handwriting font, sketch-style browser chrome) that is deliberately easy to re-skin: one CSS file, design tokens at the top. Easy to set up — clone, set three env vars (API origin, public marketplace origin, canonical site origin), pnpm install, pnpm dev; ships with a BuildKit-secret Dockerfile producing a Next.js standalone image with a liveness health route for blue/green deploys. Pluggable against any backend exposing the /api/mvps list + detail contract. Ideal for marketplace operators who want a second themed storefront or SEO promo surface for the same catalog, agencies white-labelling listing sites, and developers who want a clean reference for server-rendered catalog SEO on the App Router.
$19900
Hireloop Self-Hosted Job Board
Hireloop is a self-hostable, production-grade job board built on Next.js 15 (App Router), Postgres 16, and Drizzle ORM. Candidates browse, filter, and bookmark roles; employers create a free account, post a job, and manage their listings from any device; admins moderate the board. The auth layer uses bcryptjs work-factor-12 password hashes and opaque session tokens (raw bytes in an HttpOnly cookie, only sha256(token) stored server-side) with a 30-day sliding expiry. Email verification and password reset use atomic UPDATE ... RETURNING tokens so replay is impossible, with Resend in production and Mailpit/SMTP in dev/CI. Self-serve account deletion soft-deletes the user, scrubs PII, and closes every owned posting (GDPR-aligned). Every /api/auth/* and /api/me/* endpoint sits behind in-memory rate limits and is wrapped in a top-level handler that emits structured JSON logs (request id, route, method, ip, status, ms) and returns a sanitised 500 so Drizzle internals never leak through. Security headers (HSTS, CSP, X-Frame-Options: DENY, X-Content-Type-Options, Referrer-Policy, Permissions-Policy) are set in next.config.ts and apply to every route. /api/health and /api/ready expose liveness + readiness probes for any load balancer or orchestrator. Sentry integration is one env var (SENTRY_DSN) away; the SDK is dynamically imported so a deploy without it pays zero cost. Tests: 80 unit (Vitest), integration suite against an ephemeral Postgres (testcontainers), and Playwright E2E that round-trips the verify-email and password-reset flows through Mailpit in CI. SEO: per-listing schema.org JobPosting JSON-LD (Google for Jobs ready), canonical URLs, OG image, sitemap, robots disallow on every gated route, and a bundle-size budget enforced in CI. Ideal for indie founders launching a niche job board, agencies building white-label boards for clients, internal hiring portals at companies that want first-party data, and developers learning a modern Next.js + Postgres + auth-from-scratch stack.
Free