Getting Started

Deploy Beat Flow in 5 minutes. Everything is already built and configured!

✅ Backend Infrastructure Ready - D1 database migrated, R2 bucket created, Workers configured. Just add Stripe keys and deploy!

Prerequisites

  • Cloudflare account (you already have this)
  • Stripe account (free - sign up here)
  • 5 minutes

Step 1: Enable Stripe Connect (2 minutes)

  1. Go to Stripe Connect Settings
  2. Toggle "Enable Connect" to ON
  3. Done! No additional configuration needed

Step 2: Get Stripe API Keys (1 minute)

  1. Go to Stripe API Keys
  2. Copy your "Secret key" (starts with sk_test_ or sk_live_)
  3. Use test mode for development, live mode for production
⚠️ Keep This Secret! - Never commit your Stripe secret key to Git. Use Wrangler secrets (shown below).

Step 3: Set Stripe Secret in Workers (30 seconds)

cd /tmp/beatflow/workers

# Set your Stripe secret key
npx wrangler secret put STRIPE_SECRET_KEY
# Paste your sk_test_... or sk_live_... key when prompted

Step 4: Deploy Workers Backend (30 seconds)

cd /tmp/beatflow/workers
npm run deploy

Your API will be live at:

https://beatflow-api.terry-c67.workers.dev

Step 5: Configure Stripe Webhook (1 minute)

Now that your Worker is deployed, configure the webhook:

  1. Go to Stripe Webhooks
  2. Click "Add endpoint"
  3. Endpoint URL: https://beatflow-api.terry-c67.workers.dev/api/webhooks/stripe
  4. Select events:
    • checkout.session.completed
    • account.updated
    • payment_intent.payment_failed
  5. Click "Add endpoint"
  6. Copy the "Signing secret" (starts with whsec_)
cd /tmp/beatflow/workers
npx wrangler secret put STRIPE_WEBHOOK_SECRET
# Paste your whsec_... secret when prompted

Step 6: Deploy Frontend (1 minute)

cd /tmp/beatflow

# Create environment file
echo "VITE_API_BASE=https://beatflow-api.terry-c67.workers.dev" > .env.local

# Install dependencies (if not done yet)
npm install

# Build and deploy
npm run build
npx wrangler pages deploy dist --project-name=beatflow

Your site will be live at:

https://beatflow.pages.dev
🎉 Congratulations! - Your beat marketplace is now live! Visit beatflow.pages.dev to see it in action.

What's Next?

  1. Test Seller Onboarding - See testing guide
  2. Upload Sample Beats - Upload test files to R2
  3. Test Purchase Flow - Complete a test transaction
  4. Production Checklist - Before going live

Quick Access URLs

Service URL Purpose
Live Site beatflow.pages.dev Main beat marketplace
API beatflow-api.terry-c67.workers.dev Workers backend
Stripe Dashboard dashboard.stripe.com Payments, sellers, webhooks
Cloudflare Dashboard dash.cloudflare.com Workers, D1, R2, Pages

Need Help?