Skip to Content
Introduction

Introduction

ShipMore is self-hosted infrastructure for turning structured data into a sellable, searchable, agent-operated product. One spine — Payload collections, Orama search, Stripe monetization — renders as a directory, database, API, feed, or AI asset library. Multi-tenant by default: one deploy, one Stripe account, unlimited niches.

The five-stage loop the platform implements end to end:

Ingest → Present → Earn → Monitor → Operate

You bring a CSV, JSON file, or generation pipeline. ShipMore maps it to a per-tenant schema, presents it via the ExploreBlock + per-record detail pages, monetizes it with all four Stripe product types, observes it via the /operate dashboard, and lets agents drive the freshness loop through the shipmore CLI and the MCP plugin.

Tech stack

  • Next.js 15 (App Router)
  • Payload CMS 3.x — admin, Local API, REST, MCP, GraphQL, jobs
  • MongoDB via the Payload mongoose adapter
  • Better Auth (Google OAuth, passkeys) for customer sessions
  • Stripe — credit packs, subscription credits, single purchases, subscriptions
  • Orama — per-tenant in-memory search index
  • Tailwind CSS 4 / shadcn/ui
  • Replicate (optional) for the generation pipeline
  • shipmore CLI — tsup-built, served from the box at /cli/install.sh
  • MCP plugin — currently enabled for pages + tenants

What you get

  • 15 page-builder blocks with live business logic (Pricing block fires real Stripe checkout; ExploreBlock browses live records)
  • All four Stripe monetization types pre-wired with paywall enforcement
  • Per-tenant Orama index over the records collection — facets, filters, typo tolerance
  • shipmore CLI for operators and agents (tenant, schema infer/apply, import, page build, product, monitor)
  • SKILL.md so any MCP-capable agent (Claude, GPT, Gemini) can operate the box
  • /operate monitoring dashboard backed by the observations engine
  • Multi-tenant routing, per-tenant branding/legal/analytics
  • Better Auth + Payload admin auth (separate user pools)
  • React Email templates, Resend or SMTP adapter
  • S3 storage adapter (auto-activates when env vars are set)
  • SEO: meta, OG, JSON-LD per record, sitemap, robots, Pagefind
  • Vitest integration tests + Playwright E2E

Prerequisites

Reading order

  • Getting Started — clone the repo, set env vars, run, create your first tenant
  • Architecture — service layer, domain map, three-level access model
  • Data Layer — Records, DataSchema, the infer → apply → import flow, Orama/Explore
  • Features — content/blocks, monetization, auth, email, storage, leads, monitoring, generation
  • Agents & CLI — shipmore CLI, MCP plugin, SKILL.md
  • Security — Local API rules, hooks, secrets
  • Deployment — Railway, Vercel, custom domains, operational sizing
Overview