# AiNuby.com — Build Brief

**Site:** AiNuby.com
**Category:** AI Education Platform
**Last updated:** May 2026

---

## What This Site Is

AiNuby.com is a subscription-based AI how-to playbook platform for business owners. It provides structured, business-type-specific AI implementation guides — not generic AI tutorials, but role-specific playbooks for 10 distinct types of businesses (freelancers, agencies, e-commerce stores, SaaS startups, coaches, local businesses, content creators, consultants, retail stores, and restaurants).

The core content offering is: 10 playbooks × 8 AI tools each × 5 how-to setup steps = 400 individual how-to guides. Each playbook also includes a 4-week roadmap, a week-in-the-life AI schedule, AI agent recommendations, mistake guides, and quick wins.

---

## Who It Serves

**Primary users:** Small and mid-sized business owners and solo operators who want to adopt AI but don't know which tools to use or how to set them up. No technical background required.

**Subscriber tiers:**
- **Free (unauthenticated):** Browse the playbook index; see section headers with lock icons
- **AiNuby Pro Monthly:** $39/month — full content access, Ada AI agent, Training Hub
- **AiNuby Pro Annual:** $300/year — same access, billed annually

---

## Technical Stack

### Frontend
- **Framework:** React 18 + Vite
- **Language:** TypeScript
- **Routing:** Wouter (base path `/`)
- **Authentication:** Clerk (`@clerk/react`) — Replit-managed tenant
- **Styling:** Tailwind CSS
- **Payments UI:** Stripe Checkout (redirects via API)

### Backend
- **Framework:** Express.js 5 (TypeScript)
- **Base path:** `/api`
- **Database ORM:** Drizzle ORM
- **Database:** PostgreSQL (Replit managed)
- **Auth middleware:** Clerk JWT verification; Clerk proxy middleware for production
- **Payment processing:** Stripe (via Replit Stripe connector)
- **AI agent:** Grok API (powers Ada, the subscriber AI assistant)

### Infrastructure
- **Monorepo:** pnpm workspaces
- **Node.js:** v24
- **Build tool:** esbuild (CJS bundle for API server)
- **Deployment:** Replit

### Key API Routes
- `GET /api/stripe/subscription` — check subscriber status
- `POST /api/stripe/checkout` — create Checkout Session
- `POST /api/stripe/portal` — open Stripe Customer Portal
- `GET /api/stripe/products-with-prices` — fetch live product/price data
- `GET /api/sitemap.xml` — dynamic XML sitemap
- `POST /api/partner/generate` — issue partner SSO JWT
- `GET /api/user/partner-links` — fetch user's partner site access

---

## Key URLs

- Homepage: https://ainuby.com/
- Sign Up: https://ainuby.com/sign-up
- Sign In: https://ainuby.com/sign-in
- Pricing: https://ainuby.com/pricing
- Checkout Success: https://ainuby.com/checkout/success
- API Base: https://ainuby.com/api
- Dynamic Sitemap: https://ainuby.com/api/sitemap.xml
- AI Sitemap: https://ainuby.com/ai-sitemap.xml

---

## Content Architecture

### Playbook Data
All playbook content lives in `artifacts/ainuby/src/data/playbooks.ts`. This is a static TypeScript data file — no CMS. Each playbook entry contains:
- `id`, `label`, `emoji`, `tags`
- `snapshot` (description, time wasters, vision)
- `aiStack` (array of tool objects, each with `howTo` steps)
- `roadmap` (week1–week4 text)
- `weekInLife` (mon–fri text)
- `agents` (array with name, description, buildVsBuy, timeSaved)
- `mistakes` (array with mistake + howToAvoid)
- `quickWins` (string array)

### Auth Gating
Signed-out users see the hero section and the playbook grid with lock icons. Clicking any playbook card triggers an auth modal (sign-up/sign-in prompt). Signed-in subscribers with active Pro status see the full 3-column playbook layout.

### Subscription Gating
Subscription status is checked against Stripe via `/api/stripe/subscription`. Non-subscribers see an upgrade banner and locked Training Hub modules. The Ada AI agent button is hidden for non-subscribers.

---

## AI-Readable Files Index

| File | URL | Purpose |
|---|---|---|
| `robots.txt` | /robots.txt | Crawler permissions — allows all AI bots |
| `llms.txt` | /llms.txt | LLM-optimized site summary |
| `llms-full.txt` | /llms-full.txt | Full AI corpus — all content in plain text |
| `build-brief.txt` | /build-brief.txt | This file — technical context |
| `faq.md` | /faq.md | FAQ for AI and search |
| `key-people.md` | /key-people.md | Leadership titles and credentials |
| `practice-areas.md` | /practice-areas.md | Full playbook/service breakdown |
| `schema.jsonld` | /schema.jsonld | Schema.org entity graph |
| `ai-sitemap.xml` | /ai-sitemap.xml | Sitemap of AI-readable files |
| Dynamic sitemap | /api/sitemap.xml | Full page sitemap |

---

## Contact

- **Website:** https://ainuby.com
- **Platform type:** SaaS / subscription content platform