Blog AI

Brand-safe AI content operations for drafting, SEO, analytics, and repeatable publishing workflows.

Overview

Blog AI is a monorepo with three product surfaces:

• apps/web: Next.js application for content teams
• apps/api: FastAPI backend for generation, quotas, and integrations
• apps/extension: browser extension

The product is positioned around repeatable publishing, not generic prompt-box output: brand voice controls, structured drafting, SEO workflows, history, analytics, and monetization hooks.

Highlights

• Bun-first frontend workflow with a committed bun.lock
• Next.js 16 web app with React 18, Clerk, and Sentry
• FastAPI backend with Neon/Postgres, Stripe, and quota-based product logic
• Static marketing homepage at / for maximum Lighthouse performance
• Verified Lighthouse 100 / 100 / 100 / 100
• Verified React Doctor 100 / 100

Quick Start

Prerequisites

• Bun 1.3+
• Python 3.12+
• Git
• At least one LLM API key

1. Install dependencies

git clone https://github.com/gr8monk3ys/blog-AI.git
cd blog-AI
bun install

2. Configure env files

cp .env.example .env
cp .env.local.example apps/web/.env.local

Minimum local values:

• .env
• OPENAI_API_KEY=...
• ENVIRONMENT=development
• apps/web/.env.local
• NEXT_PUBLIC_API_URL=http://localhost:8000
• NEXT_PUBLIC_WS_URL=ws://localhost:8000

3. Start the backend

cd apps/api
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python server.py

4. Start the web app

cd /path/to/blog-AI
bun dev

Open http://localhost:3000.

Bun Commands

Backend Commands

Deployment

• Web: Vercel
• API: Railway or another container host
• Database: Neon Postgres
• Auth: Clerk
• Billing: Stripe

Key references: