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

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.

• 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

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

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

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

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

cd /path/to/blog-AI
bun dev

Open http://localhost:3000.

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

Key references:

• docs/DEPLOYMENT.md
• docs/DEPLOYMENT_VERCEL_RAILWAY_NEON.md
• docs/ENVIRONMENT.md
• CONTRIBUTING.md

blog-AI/
├── apps/
│   ├── api/         FastAPI backend
│   ├── extension/   Browser extension
│   └── web/         Next.js app
├── db/              SQL migrations
├── docs/            Operational and technical docs
├── scripts/         Build, audit, and release helpers
└── package.json     Bun-first workspace shell

• bun run build passes
• bun run audit:runtime passes
• Lighthouse on /: 100 / 100 / 100 / 100
• React Doctor: 100 / 100

• The landing page is served from apps/web/public/home.html through a rewrite in apps/web/next.config.mjs to keep / extremely fast.
• Dependabot still uses the GitHub npm ecosystem for apps/web, but day-to-day development and CI now run through Bun.