Technical Deep Dive

What We've Built &
Where We're Going

Wild Ventures has a production SaaS platform with a FastAPI backend, Next.js frontend, and Supabase infrastructure — deployed on Railway + Netlify with 30 API endpoints live. AI engines generate creative, deploy campaigns, and optimize spend autonomously across channels.

30+

API Endpoints

AI Generators

API Integrations

Ad Platforms

Live Clients

759

Knowledge Files

System Architecture

Full-stack SaaS platform wrapping four AI engines. Brand context flows in, optimized campaigns flow out. The loop closes automatically.

┌─────────────────────────────────────────────────────────────────────────┐
│                      SAAS PLATFORM LAYER                               │
│   Next.js Frontend  ·  FastAPI Backend  ·  Supabase Auth + Storage    │
│   Dashboard  ·  Onboarding Wizard  ·  Creative Gallery  ·  Campaigns  │
└──────────┬──────────────────┬──────────────────┬──────────────────────┘
           │                  │                  │
┌──────────▼──────────────────────────────────────────────────────────────┐
│                        INTELLIGENCE LAYER                              │
│   Creative Taxonomy  ·  Performance Patterns  ·  Cross-Brand Learning  │
└──────────┬──────────────────┬──────────────────┬──────────────────────┘
           │                  │                  │
┌──────────▼──────────┐ ┌─────▼──────────┐ ┌────▼─────────────────────┐
│ CREATIVE ENGINE     │ │ MEDIA ENGINE   │ │ ANALYTICS ENGINE         │
│                     │ │                │ │                           │
│ Ad Images (Gemini)  │ │ Meta Deployer  │ │ Performance Collector    │
│ Ad Copy (Claude)    │ │ Google Deploy  │ │ Creative Taxonomy        │
│ AI Video (Kling)    │ │ TikTok Deploy  │ │ Attribution Tracking     │
│ Advertorials        │ │ Native Deploy  │ │ Report Generation        │
│ Landing Pages       │ │ Budget Control │ │ Shopify / GA4 / Klaviyo  │
│ Endcards / UGC      │ │ Safety Rails   │ │ Insightful MCP           │
└──────────┬──────────┘ └───────┬────────┘ └────────────┬──────────────┘
           │                   │                      │
┌──────────▼───────────────────▼──────────────────────────▼──────────────┐
│                       BRAND CONTEXT LAYER                             │
│   Brand Guide  ·  Product Data  ·  Audience Segments  ·  Voice/Tone   │
└──────────┬──────────────────────────────────────────────────────────┘
           │
┌──────────▼──────────────────────────────────────────────────────────┐
│                      ONBOARDING PIPELINE                            │
│   Intake Wizard → Data Pull → Brain Builder → First Campaign       │
└────────────────────────────────────────────────────────────────────┘

SaaS Platform DEPLOYED

Full-stack web application live on Railway (backend) + Netlify (frontend) + Supabase (auth, database, storage). Not a prototype — production infrastructure with 30 API endpoints.

LIVE FastAPI Backend

8 route modules, 30+ endpoints. Python 3.12 on Railway with PostgreSQL via Supabase.

Routes:
Brands CRUD • Generations (async jobs) • Creatives (approval workflow) • Campaigns (deploy/pause/scale) • Dashboard (KPIs, recommendations) • Onboarding (intake → brain build) • Assets (upload + metadata) • Files (Supabase Storage)

Services: Generator wrapper (routes CLI tools as background jobs), BrandWorkspace manager, Campaign deployer, Brain builder

LIVE Next.js Frontend

Next.js 14 + React 18 + Tailwind CSS 4. App Router architecture, deployed on Netlify.

Pages:
Dashboard • Onboarding wizard • Brand settings • Creative gallery • Campaign manager • Asset library • Settings • Login

Auth: Supabase JS client, JWT tokens, admin/client role-based access control

LIVE Supabase Infrastructure

Auth + PostgreSQL + Storage. Managed database with 11 core tables.

Data Models:
User (auth + roles) • Brand (config, avatars, SKUs, channels, compliance) • Asset (uploads + metadata) • Creative (draft → approved → deployed → archived) • Generation (batch jobs + cost tracking) • Campaign (cross-channel + performance) • Connection (OAuth tokens + auto-refresh)

Core AI Engines

LIVE Creative Engine

14 generators. AI-powered ad creative at scale.

Generators:
Ad images (Gemini + Placid) • Ad copy (Claude) • Video scripts • Advertorials • Landing pages • Carousel ads • Endcards • Captions • Content calendars • Native ads • Reel scripts

Output: 50-100+ creative variants/week per brand vs 5-10 from traditional agency

LIVE Media Buying Engine

AI-powered cross-channel budget allocation and autonomous optimization.

Components:
Allocation engine • Budget controller • Decision engine (pause/scale/graduate) • Performance collector • Safety rails • Anomaly detection

Status: Running daily. Auto-reallocating budget across Meta, Google, TikTok based on CPA/ROAS.

LIVE Campaign Deployer

5 ad platform integrations. Push campaigns live via API.

Platforms:
Meta Ads API (Facebook SDK) • Google Ads API • TikTok Marketing API • Taboola API • Outbrain API

Safety: Default deploys PAUSED. $500/day cap requires explicit override. Full dry-run mode.

BUILT AI Video Engine

Kling AI integration for 15-16 second video ad generation with TTS voiceover.

Pipeline:
Script structurer → Hook bank (variants) → TTS voiceover → Kling video generation → Video assembler → Compliance check

Architecture: Hybrid AI + static pipeline. Asset resolver pulls product images + clips. Full compliance layer for health/supplement claims.

BUILT Onboarding Automation

End-to-end client onboarding from intake form to first campaign launch.

Pipeline:
Intake wizard → Data puller (Shopify, Meta Ads Library, site crawl) → Brain builder (auto-generates SKUs, avatars, compliance, channels, social proof, brand context) → First ads launcher

Intelligence: Synthesizes founder interview + auto-pulled data + uploaded files into complete brand intelligence layer.

BUILT Brand Engine

Brand-agnostic context system. Onboard any DTC brand.

Pipeline:
brand_loader.py → brand_context_builder.py → prompt_builder.py

Ingests brand guide, product catalog, audience data, voice/tone. Outputs structured context for all generators. Multi-brand architecture validated across ecommerce + info products.

BUILT Transcription Pipeline

Download + transcribe + synthesize educational and competitor content at scale.

Sources:
YouTube • TikTok • Instagram • Skool (Loom/Mux) • Any video URL

759 knowledge files ingested — 603 transcripts + 148 course files + 15 synthesis docs (36,851 lines). 19 educators covered. OpenAI Whisper API. ~$0.006/min.

BUILT Quiz Funnel Builder

Standalone microservice for quiz-based lead generation funnels.

Stack:
FastAPI + SQLAlchemy backend • Deployed on Railway • Independent service architecture

First proof of microservice pattern. Plugs into main platform for lead capture → brand onboarding flow.

Automation Levels

How much of each process runs autonomously today.

Creative Gen

95%

Media Buying

100%

Deployment

85%

Onboarding

80%

Reporting

75%

Knowledge Build

90%

Video Production

70%

Remaining % is intentional human review (QA, compliance, strategic decisions), not missing automation.

Codebase Overview

System	Language	Infrastructure	Status
Platform Backend	Python (FastAPI)	Railway + Supabase PostgreSQL	DEPLOYED
Platform Frontend	TypeScript (Next.js + React)	Netlify	DEPLOYED
Creative Generators	Python	14 generators, async job runner	LIVE
Media Buying Engine	Python	Cron-based, multi-channel	LIVE
Campaign Deployers	Python	5 ad platform APIs	LIVE
Video Engine	Python	Kling AI + TTS pipeline	BUILT
Onboarding Pipeline	Python	Data puller + brain builder	BUILT
Transcription Pipeline	Python	Whisper API, multi-source	BUILT
Quiz Funnel Builder	Python (FastAPI)	Railway (microservice)	BUILT
Brand Engine	Python	Context builder pipeline	BUILT

Directory Structure

platform/ # Full-stack SaaS application ├── backend/ # FastAPI + SQLAlchemy │ ├── main.py # App entry + route registration │ ├── models.py # 11 ORM models (User, Brand, Creative...) │ ├── auth.py # Supabase JWT auth middleware │ ├── database.py # SQLAlchemy engine (Postgres + SQLite) │ ├── routes/ # 8 route modules, 30+ endpoints │ │ ├── brands.py # Brand CRUD + workspace setup │ │ ├── generations.py # Async creative generation jobs │ │ ├── creatives.py # Approval workflow + deployment │ │ ├── campaigns.py # Campaign create/deploy/pause/scale │ │ ├── dashboard.py # KPIs + recommendations │ │ ├── onboarding.py # Intake form + brain building │ │ ├── assets.py # Asset management + metadata │ │ └── files.py # Supabase Storage uploads │ └── services/ # Business logic layer │ ├── generator.py # Wraps CLI generators as async jobs │ ├── workspace.py # BrandWorkspace: config, avatars, SKUs │ ├── deployer.py # Multi-platform campaign deployer │ └── brain_builder.py # Auto-generate brand intelligence │ ├── frontend/ # Next.js 14 + React 18 + Tailwind 4 │ ├── app/ # App Router pages │ │ ├── dashboard/ # KPIs, channel performance │ │ ├── onboarding/ # Brand intake wizard │ │ ├── creatives/ # Creative gallery + approval │ │ ├── campaigns/ # Campaign management UI │ │ ├── assets/ # Upload + manage brand assets │ │ └── login/ # Supabase Auth │ ├── components/ # KpiCard, etc. │ └── lib/ # API client + Supabase JS │ ├── Dockerfile # Python 3.12-slim container ├── Procfile # Railway deployment config └── requirements.txt # anthropic, supabase, fastapi, sqlalchemy... tools/ ├── generators/ # 14 creative generators │ ├── generate_ads_v11.py # Latest: Gemini + Placid │ ├── generate_advertorial.py │ ├── generate_video.py │ ├── generate_native_ads.py │ ├── generate_carousels.py │ ├── generate_endcards.py │ ├── generate_captions.py │ ├── generate_reel_scripts.py │ ├── generate_content_calendar.py │ └── ... 5 more generators │ ├── media_buying_engine/ # AI budget optimization │ ├── engine.py # Main orchestrator │ ├── allocation_engine.py # Budget split algorithm │ ├── budget_controller.py │ ├── decisions.py # Pause/scale/graduate │ ├── safety_rails.py # Guardrails + anomaly detection │ └── performance_collector.py │ ├── video_engine/ # AI video generation │ ├── kling_provider.py # Kling AI (15-16s videos) │ ├── tts_provider.py # Text-to-speech voiceover │ ├── script_structurer.py # Script timing + structure │ ├── hook_bank.py # Hook variants library │ ├── video_assembler.py # Final video composition │ ├── compliance.py # Health claims + disclaimers │ └── asset_resolver.py # Product images + clips │ ├── onboarding/ # Client onboarding automation │ ├── onboard_client.py # Master orchestrator │ ├── brand_brain_builder.py # Auto-generate brand intelligence │ ├── data_puller.py # Shopify, Meta Ads, site crawl │ ├── connection_validator.py │ └── first_ads_launcher.py │ ├── deployment/ # Campaign deployment to ad platforms │ ├── meta_deployer.py # Meta/Facebook Ads API │ ├── google_deployer.py │ ├── tiktok_deployer.py │ ├── taboola_deployer.py │ └── outbrain_deployer.py │ ├── transcriber/ # Video → transcript pipeline │ ├── cli.py │ ├── transcribe.py # Whisper API │ └── downloaders/ # YouTube, TikTok, Instagram │ ├── quiz-funnel-builder/ # Standalone microservice └── utilities/ # Compositor, Placid client, PDF builder clients/ ├── vitabar/ # Supplement brand — LIVE └── finally-clear/ # Recovery coaching — LIVE

API Integrations

Service	Purpose	Integration	Status
Anthropic (Claude)	Copy generation, strategy, analysis, brand brains	API + Claude Projects + MCP	LIVE
Google Gemini	AI image generation for ad creatives	gemini-2.5-flash-image API	LIVE
OpenAI	Whisper transcription + GPT image gen	API	LIVE
Supabase	Auth, PostgreSQL database, file storage	Supabase JS + Python SDK	LIVE
Meta Ads	Campaign deployment, audience management	Facebook Business SDK (System User)	LIVE
Google Ads	Search/Shopping/PMax deployment	Google Ads API (GAQL)	BUILT
TikTok Ads	Campaign deployment, Spark Ads	TikTok Marketing API	BUILT
Kling AI	AI video generation (15-16s ads)	Kling API	BUILT
ElevenLabs	Text-to-speech voiceover for video ads	TTS API	BUILT
Placid	Template-based image rendering	REST API	LIVE
Shopify	Product data pull, store connection	Shopify Admin API	BUILT
Insightful MCP	Cross-platform performance data in Claude	MCP protocol	LIVE
Netlify	Frontend hosting + landing pages	CLI + API	LIVE

Live Client Proof Points

LIVE VitaBar (Supplements)

200+ ad creatives generated across v10/v11 algorithms. 12 landing page / funnel variants. 4 advertorial styles for native channels. SKU-level brand context (Energy, Boost, Chill, Refresh).

Different product lines validated against the same brand engine. Gemini image generation + Placid template rendering pipeline. Custom font library for design consistency. Full campaign config schema built.

LIVE Finally Clear (Coaching)

40+ ads, 7 generators, 84KB brand context. Email welcome sequence. Sales page copy. YouTube thumbnails. Competitive intelligence.

Different vertical (info products vs ecommerce) — validates multi-vertical brand engine. Stan Store integration. Meta + TikTok channels.

Production Tech Stack

Layer	Technology	Details
Frontend	Next.js 14 + React 18 + Tailwind CSS 4	App Router, Supabase JS, deployed on Netlify
Backend	FastAPI + SQLAlchemy + Pydantic	Python 3.12, async workers, deployed on Railway
Database	PostgreSQL (Supabase managed)	11 ORM models, SQLite fallback for local dev
Auth	Supabase Auth	JWT tokens, admin/client RBAC, OAuth connections
Storage	Supabase Storage	Asset uploads, creative outputs, brand materials
AI Models	Claude + Gemini + GPT + Kling + ElevenLabs	Copy, images, video, voice, transcription
Ad Platforms	Meta + Google + TikTok + Taboola + Outbrain	Campaign deployment, budget optimization, reporting
Container	Docker (Python 3.12-slim)	Procfile for Railway/Heroku compatibility
Analytics	Insightful MCP	Cross-platform performance aggregation

Engineering Roadmap

What's built, what's shipping now, and what's coming next.

COMPLETED — Q1 2026

Phase 0: Core Engines

Full creative generation (14 generators), media buying engine, campaign deployers (5 platforms), transcription pipeline, and brand intelligence system. Running in production on 2 clients.

COMPLETED — Q1 2026

Phase 1: Platform Foundation

FastAPI backend — 30+ endpoints, 8 route modules, service layer wrapping CLI tools as async jobs
Next.js frontend — Dashboard, onboarding wizard, creative gallery, campaign manager, asset library
Supabase infrastructure — Auth (JWT + RBAC), PostgreSQL (7 models), Storage (assets + creatives)
Self-serve onboarding — Intake wizard → data puller → brain builder → first campaign suggestions
Production deployment — Railway (backend) + Netlify (frontend) + Supabase (data layer)

COMPLETED — Q1 2026

Phase 2: Video & Content

AI video engine — Kling AI integration, TTS voiceover, script structurer, video assembler, compliance layer
Creative approval workflow — Draft → approved → deployed → archived with performance tracking
Quiz funnel builder — Standalone microservice for lead gen funnels (FastAPI + Railway)
Shopify data integration — Auto-pull products, collections, and store data during onboarding

NOW — Q2 2026

Phase 3: Platform Hardening

OAuth connection management — Users connect their own Meta/Google/TikTok/Shopify/Klaviyo accounts
Client Portal — Self-serve campaign hub: asset upload, spend allocation, AI recommendations, approval → deploy flow (asset upload + creative approval + campaign UI already built)
Tracking pixel injection — Auto-embed Meta Pixel, GA4, Triple Whale into all generated assets (presellers, landers, quizzes, endcards)
Influencer Connector — AI-matched creator discovery, personalized outreach, campaign tracking, ROI dashboard
Self-serve creative studio — Users generate ads, copy, videos from dashboard
Campaign builder UI — Visual campaign creation → auto-deploy via platform APIs
Real-time dashboard — Live performance metrics, media buying decisions + reasoning, spend tracking
Alerting system — CPA spikes, budget anomalies, creative fatigue → Slack/email/SMS

Q3 2026

Phase 4: Intelligence Network

Cross-brand pattern recognition — Anonymized performance data shared across platform users
Predictive creative scoring — AI predicts performance before launch based on historical patterns
Industry benchmarks — "Your CPA is 30% below average for supplement brands"
A/B test builder — Define test matrix, auto-generate variants, track results
Attribution layer — First-party server-side events, blended ROAS dashboard

Q4 2026

Phase 5: Scale & Distribution

Public API — Agencies build on top of Wild Ventures
Email/SMS engine — Klaviyo integration for lifecycle automation
Shopify App Store listing — Distribution through Shopify ecosystem
Enterprise tier — Custom models, dedicated infrastructure, SLAs
International expansion — Multi-language creative generation

The Opportunity

What Exists Today

A deployed SaaS platform with FastAPI backend, Next.js frontend, and Supabase infrastructure. 14 AI creative generators, an autonomous media buying engine, 5 ad platform deployers, AI video generation, and automated client onboarding — all wrapped in a production web app with auth, dashboards, and async job processing.

What's Next

Platform hardening: self-serve OAuth connections, client portal (spend allocation + AI recommendations + approval-to-deploy), tracking pixel injection, and influencer connector. Then the intelligence network — cross-brand learning, predictive scoring, and benchmarks. The engines and the platform exist. Now we scale.

Why It's Exciting

This is the platform that kills the marketing agency. AI creative generation + autonomous media buying + closed-loop optimization — already built and deployed. The data network effects compound with every brand. Most AI marketing tools do one thing. We do the whole loop.

Questions? Let's talk.

Aden Lambert — wildventures.ai

CONFIDENTIAL — MARCH 2026

What We've Built &Where We're Going

System Architecture

SaaS Platform DEPLOYED

LIVE FastAPI Backend

LIVE Next.js Frontend

LIVE Supabase Infrastructure

Core AI Engines

LIVE Creative Engine

LIVE Media Buying Engine

LIVE Campaign Deployer

BUILT AI Video Engine

BUILT Onboarding Automation

BUILT Brand Engine

BUILT Transcription Pipeline

BUILT Quiz Funnel Builder

Automation Levels

Codebase Overview

Directory Structure

API Integrations

Live Client Proof Points

LIVE VitaBar (Supplements)

LIVE Finally Clear (Coaching)

Production Tech Stack

Engineering Roadmap

Phase 0: Core Engines

Phase 1: Platform Foundation

Phase 2: Video & Content

Phase 3: Platform Hardening

Phase 4: Intelligence Network

Phase 5: Scale & Distribution

The Opportunity

What Exists Today

What's Next

Why It's Exciting

What We've Built &
Where We're Going