# GIGA.FORA

> The fastest embeddable comment system, built on Cloudflare's edge.

## Overview

Fora is a comments platform that loads in 50ms from 300+ edge locations. Add to any site in 60 seconds.

**Forum platform:** Anonymous posting with pseudonyms, threaded comments, voting, reactions, linked posts, and trending tags.

**Embeddable comments:** Drop-in comment widgets for blogs, docs, and content sites. Works with any framework.

## Quick Start

```bash
npx create-fora
```

No login. No signup. Creates an anonymous site, generates a siteKey, and outputs a framework-specific snippet. ~15 seconds. Use `--login` for authenticated sites.

Supports: Astro, Hugo, Jekyll, 11ty, Hakyll, HTML.

## Framework Adapters

| Framework | Package | Install |
|-----------|---------|---------|
| Astro | `astro-fora` | `npm install astro-fora` |
| Eleventy (11ty) | `fora-eleventy-plugin` | `npm install fora-eleventy-plugin` |
| Jekyll | `jekyll-fora` | `gem install jekyll-fora` |
| Hakyll | template + Haskell module | see `/docs/hakyll` |
| Any HTML | `<script>` tag | No install — 2 lines of HTML |

**Plain HTML embed:**
```html
<div id="fora-comments"></div>
<script src="https://giga.mobile/embed.js" data-site-key="YOUR_KEY"></script>
```

## Architecture

- **Direct-render mode** (default): Shadow DOM, no iframe, zero layout shift
- **Iframe mode** (legacy): available via `data-mode="iframe"`
- **SSR-safe**: Comment count available at build time for static sites
- **Webhooks**: `comment.created` events with HMAC-SHA256 signatures
- **JSON-LD**: Structured data for SEO (`DiscussionForumPosting`)
- **Public JS API**: `Fora.mount()`, `Fora.update()`, `Fora.unmount()`, `Fora.count()`

## API

### Embed API (public, no auth)

- `GET /api/embed/count?site_key=X&page_id=Y` — Comment count (cacheable, SSR-safe)
- `GET /api/embed/structured-data?site_key=X&page_id=Y` — JSON-LD for SEO
- `POST /api/embed/config` — Direct-render configuration
- `POST /api/embed/bootstrap` — Iframe mode configuration (legacy)

### Quickstart API

- `POST /api/embed/quickstart-anon` — Create anonymous site + get snippet. No auth required. Rate limited: 3/hour/IP. Body: `{ name, domain, framework }`. **Recommended.**
- `POST /api/embed/quickstart` — Create site under authenticated account. Requires tenant session. Body: `{ name, domain, framework }`

### Agent API (requires agent token)

- `POST /api/agent/embed/install` — Generate install snippet
- `POST /api/agent/embed/validate` — Validate integration

### Tenant API (requires session)

- `GET|POST /api/tenant/sites` — List/create sites
- `GET /api/tenant/sites/:siteId` — Site details
- `GET /api/tenant/sites/:siteId/analytics` — Analytics data
- `PATCH /api/tenant/sites/:siteId/features` — Feature flags
- `PATCH /api/tenant/sites/:siteId/theme` — Theme settings
- `PATCH /api/tenant/sites/:siteId/domains` — Allowed domains
- `GET|POST|DELETE /api/tenant/sites/:siteId/webhooks` — Webhook management
- `POST /api/tenant/sites/:siteId/agent-tokens` — Create agent tokens

### Auth

- `POST /api/auth/magic-link/request` — Request login link
- `GET /api/auth/magic-link/verify` — Verify login link
- `GET /api/auth/google/start` — Google OAuth
- `GET /api/auth/me` — Current session
- `POST /api/auth/logout` — Logout

### Billing

- `POST /api/billing/checkout-session` — Stripe checkout
- `POST /api/billing/customer-portal` — Stripe customer portal
- `POST /api/billing/stripe-webhook` — Stripe webhook handler

## Technical Stack

- **Frontend:** Vanilla JavaScript, HTML5, CSS3
- **Backend:** Cloudflare Workers + D1 (SQLite)
- **Embed:** Shadow DOM direct-render (default), iframe (legacy)
- **Hosting:** Cloudflare Pages + Workers
- **Auth:** Magic link + Google OAuth

## Links

- Main site: https://giga.mobile
- Publisher dashboard: https://giga.mobile/publishers
- AI docs: https://giga.mobile/ai
- Agent install guide: https://giga.mobile/ai/comments-install
- OpenAPI spec: https://giga.mobile/openapi-agent.json
- Terms: https://giga.mobile/terms/
- Privacy: https://giga.mobile/privacy/
- Comparison: Fora vs Disqus — https://giga.mobile/vs/disqus.html
- Comparison: Fora vs Commento — https://giga.mobile/vs/commento.html
- Comparison: Fora vs Isso — https://giga.mobile/vs/isso.html
- Comparison: Fora vs giscus — https://giga.mobile/vs/giscus.html
- Comparison: Fora vs Cusdis — https://giga.mobile/vs/cusdis.html
- Comparison: Fora vs utterances — https://giga.mobile/vs/utterances.html
- Comparison: Fora vs Elfsight — https://giga.mobile/vs/elfsight.html
- Comparison: Fora vs Coral by Vox Media — https://giga.mobile/vs/coral.html