Self-Hosting

Deploy your own MyClaude marketplace instance. This guide covers every service dependency, environment variable, and verification step.

Architecture overview

Browser  -->  Next.js 16 (Vercel / Node.js)
                |         |         |
                v         v         v
          Firebase    Stripe     Cloudflare R2
          (Auth +     Connect    (product files)
          Firestore + (payments)
          Storage)

Prerequisites

Before you begin, create accounts and projects for:

1. Firebase -- Create a project at console.firebase.google.com
2. Stripe -- Create an account at dashboard.stripe.com with Connect enabled
3. Cloudflare -- Create an R2 bucket at dash.cloudflare.com
4. Vercel (recommended) or a server running Node.js 20+

Environment variables

Your deployment requires 17 environment variables. Never commit actual values to version control.

Firebase Client (exposed to browser)

Firebase Admin (server-only)

Stripe

Cloudflare R2

Platform

Firebase setup

1. Enable authentication

In Firebase Console > Authentication > Sign-in method, enable:

• Email/Password
• Google (recommended)

2. Create Firestore database

Create a Cloud Firestore database in production mode. Deploy the security rules:

$ npx firebase deploy --only firestore:rules

The rules file (firestore.rules) ships with the repository. It enforces:

• Authenticated reads for most collections
• Server-only writes for orders (webhook creates these)
• Owner-only writes for user profiles

3. Deploy storage rules

$ npx firebase deploy --only storage

The storage rules (storage.rules) enforce:

• allow read: if false for product files (signed URLs bypass rules)
• Authenticated uploads for avatars and thumbnails with size limits

4. Create Firestore indexes

Composite indexes are required for queries. Deploy them:

$ npx firebase deploy --only firestore:indexes

Stripe Connect setup

1. Enable Connect

In Stripe Dashboard > Connect > Settings:

• Account type: Express
• Platform profile: Marketplace

2. Configure webhook

Create a webhook endpoint pointing to your deployment:

https://your-domain.com/api/stripe/webhooks

Subscribe to these events:

• checkout.session.completed -- creates orders after payment
• charge.refunded -- processes refunds, updates stats
• account.updated -- tracks seller onboarding status

Copy the webhook signing secret to STRIPE_WEBHOOK_SECRET.

3. Platform fee

The platform fee is hardcoded at 8% on the server side (in the webhook handler). The NEXT_PUBLIC_PLATFORM_FEE_PERCENT variable controls the display value shown to users. To change the actual fee, modify the PLATFORM_FEE_PERCENT constant in src/app/api/stripe/webhooks/route.ts.

R2 storage setup

1. Create a bucket

In Cloudflare Dashboard > R2 > Create bucket. Name it (e.g., myclaude-marketplace).

2. Create API token

In R2 > Manage R2 API Tokens > Create API token:

• Permissions: Object Read & Write
• Scope: Apply to the specific bucket

Copy the Access Key ID and Secret Access Key.

3. Configure CORS (if needed)

If your deployment domain differs from the R2 endpoint, add a CORS policy to the bucket:

[
  {
    "AllowedOrigins": ["https://your-domain.com"],
    "AllowedMethods": ["GET", "PUT"],
    "AllowedHeaders": ["*"],
    "MaxAgeSeconds": 3600
  }
]

Deploying

Option A: Vercel (recommended)

$ npm install -g vercel
$ vercel --prod

Add all 17 environment variables in Vercel Dashboard > Settings > Environment Variables. The next.config.ts and build scripts are pre-configured for Vercel.

Key Vercel settings:

• Framework Preset: Next.js
• Node.js Version: 20.x
• Build Command: npm run build (runs prebuild script automatically)
• Output Directory: .next

Option B: Self-hosted Node.js

$ npm install
$ npm run build
$ npm start

The server starts on port 3000 by default. Use a reverse proxy (nginx, Caddy) for TLS termination. Ensure all 17 environment variables are set in the process environment.

Minimum server requirements:

• Node.js 20+
• 1 GB RAM
• Outbound HTTPS access to Firebase, Stripe, and Cloudflare APIs

Post-deploy verification

Run through this checklist after your first deployment.

Related pages

• Contributing -- Local development setup
• Security Model -- Security architecture details
• Webhooks & Integration -- Webhook events and rate limits
• API Overview -- Endpoint groups and authentication