v1.0.0 — Initial Release

First stable release of the Meta Ads + Claude Code starter.

What's included

• Dashboard (Next.js 15 + FastAPI on Vercel) — genericized, driven by env vars, ready to use as App Review demo
• 3 skills for Claude Code:
  • meta-ads-compliance — anti-ban rules, error codes, business hours warnings
  • meta-ads-warmup — accumulate API calls while waiting for App Review
  • meta-app-review-approval — full submission workflow with screencast captions
• MCP meta-ads-mcp pre-configured
• Docs — 5 markdown files covering setup → deploy → App Review → operation → troubleshooting
• Templates — App Review description + analyst instructions in pt-BR
• Scripts — interactive setup.sh, post-approval verify-tier.sh, warmup.py

Quickstart

git clone https://github.com/thaleslaray/meta-ads-claude-starter
cd meta-ads-claude-starter
./scripts/setup.sh
cd dashboard && vercel deploy --prod

Then claude from the repo root to start using.

Battle-tested

This formula approved by Meta App Review in 2 hours on first try for meta.escoladeautomacao.com.br (Apr 24, 2026).

Requirements

• Meta Business Manager (verified)
• App created at developers.facebook.com
• Node.js 20+
• Python 3.11+
• Vercel account (free tier OK)
• Claude Code installed