Skip to content

v0.1.0 — From code to cash, open-sourced

Latest
Latest

Choose a tag to compare

View all tags
@ScarletttMoon ScarletttMoon released this 26 May 10:49
· 46 commits to main since this release
v0.1.0
01d01f3

The first public release of Velobase Harness — an open-source SaaS boilerplate that takes your AI app from build to revenue.

Why we built this

We've shipped multiple AI SaaS products over the past two years. One of them now does 8-figure ARR. Along the way we kept rebuilding the same plumbing — Stripe webhooks, attribution, affiliate ledger, anti-abuse, usage-based billing — because no boilerplate covered the part after "user paid".

Every SaaS starter on the market stops at the Stripe webhook. That's where the real work begins.

So we extracted the growth and monetization infrastructure from our 8-figure product, cleaned it up, and open-sourced it. That's Velobase Harness.

What's in v0.1.0

🚀 Monetization & Growth

  • Stripe Subscriptions + Crypto Payments — multi-currency, full subscription lifecycle, dunning & retries
  • Usage-Based Billing — credits lifecycle, metering dashboard, @velobaseai/billing SDK integration
  • Affiliate Engine — financial-grade double-entry ledger, refund clawback, USDT cashout
  • Server-Side Ad Attribution — Google Ads offline conversion upload, X pixel, PropellerAds
  • Email Outreach — A/B testing, scheduled campaigns, Resend + SendGrid dual-provider failover
  • Promo Codes & Referrals — built-in

🛡️ Anti-Abuse Guardrails

  • Redis rate limiting on all critical endpoints
  • Cloudflare Turnstile bot protection
  • Disposable email & Gmail trick detection
  • Signup IP/device fingerprinting
  • Guest chat quotas + credit clawback for free-credit abuse

🤖 AI & Product

  • Multi-LLM AI Chat — OpenAI, Anthropic, Google, custom providers
  • 11 BullMQ Background Workers — production-tested queue patterns
  • Authentication — sessions, magic links, OAuth via better-auth
  • Admin Dashboard — user management, billing operations, analytics
  • PostHog Analytics — event tracking out of the box

🛠️ Architecture

  • Modular by design — every feature is a toggleable module (enable via env vars)
  • Web / API / Worker split — run as one process or scale them independently
  • Pluggable event bus — extend without forking
  • Docker, Kubernetes & GitOps docs — deploy to any cloud

Stack

Layer Tech
Frontend Next.js 16, React 19, TypeScript 5, Tailwind CSS
API tRPC + optional Hono
Database PostgreSQL (Prisma)
Queue Redis + BullMQ (11 workers)
Auth better-auth
Payments Stripe + crypto
Email Resend + SendGrid
Anti-abuse Cloudflare Turnstile

MIT licensed. No vendor lock-in.

Quick Start

pnpm install
cp .env.example .env
pnpm docker:db:up
pnpm db:push
pnpm db:seed
pnpm dev:all

Open http://localhost:3000. Full setup in the README.

Or skip the setup with Velobase Launchpad — describe your product, get a configured repo + provisioned cloud resources in under a minute.

How Velobase Harness compares

Feature Velobase Harness ShipFast Makerkit Open SaaS
License MIT (free) $299 $299+ MIT
Stripe Subscriptions ✅ ✅ ✅ ✅
Usage-Based Billing ✅ ❌ partial ❌
Server-side Ad Attribution ✅ ❌ ❌ ❌
Affiliate Ledger (double-entry) ✅ ❌ ❌ ❌
Anti-abuse (Turnstile + IP/device) ✅ ❌ ❌ ❌
Email A/B + scheduling ✅ ❌ partial ❌
Multi-LLM AI chat ✅ ❌ ❌ partial

Roadmap (what's NOT in v0.1.0 yet)

Open about what's WIP:

  • 📱 Mobile apps — iOS / Android SDK + SwiftUI templates
  • 📈 More growth modules — SEO content generator, social posting automation
  • 🌍 More payment providers — Lemon Squeezy, Paddle adapters
  • 🧪 Experiment framework — built-in A/B for product features

Contributions welcome.

Get involved

Acknowledgments

Built on the shoulders of T3 Stack, Next.js, Prisma, better-auth, BullMQ, Stripe, Resend, PostHog, Cloudflare. Inspired by what ShipFast, Makerkit, and Open SaaS got right — and what they left out.

Full Changelog: https://github.com/velobase/velobase-harness/commits/v0.1.0

Assets 2
Loading