# GIGA.FORA

> GIGA.FORA is an open, anonymous forum platform where ideas connect. No login required. Users can share thoughts, spark discussions, and discover connections between ideas through linked posts and trending tags.

## Overview

GIGA.FORA is a modern web forum built for open discourse. Key features:

- **Anonymous posting**: No account required, users get auto-generated pseudonyms
- **Rich text posts**: Markdown-style formatting with titles, bodies, and tags
- **Voting system**: Upvote/downvote posts and comments
- **Linked posts**: Connect related ideas across discussions
- **Trending tags**: Discover popular topics
- **Multiple sort options**: Hot, New, Top

GIGA also includes a multi-tenant comments platform for external blogs:
- Publisher dashboard: `https://giga.mobile/publishers`
- Embed loader: `https://giga.mobile/embed.js`
- Agent install guide: `https://giga.mobile/ai/comments-install`
- Agent OpenAPI spec: `https://giga.mobile/openapi-agent.json`

## Technical Stack

- Frontend: Vanilla JavaScript, HTML5, CSS3
- Backend: Cloudflare Workers with D1 (SQLite) database
- Editor: Quill rich text editor with Markdown conversion
- Hosting: Cloudflare Pages

## API

The platform exposes a REST API at `/api/` for:

- `GET /api/posts` - List posts (supports sort, tag, search params)
- `GET /api/posts/:id` - Get single post with comments
- `POST /api/posts` - Create new post
- `POST /api/posts/:id/vote` - Vote on a post
- `POST /api/posts/:id/comments` - Add comment
- `GET /api/tags` - Get trending tags

Multi-tenant embed + publisher APIs include:
- `POST /api/embed/bootstrap` (returns short-lived signed `ctx`)
- `GET /embed/frame?ctx=...`
- `GET /api/embed/threads/:threadId/comments?ctx=...`
- `POST /api/embed/threads/:threadId/comments` (`ctx` in body)
- `GET /api/embed/threads/:threadId/post?ctx=...`
- `POST|DELETE /api/embed/threads/:threadId/post/vote`
- `POST|DELETE /api/embed/threads/:threadId/post/reactions`
- `POST /api/embed/threads/:threadId/post/share`
- `POST /api/auth/magic-link/request`
- `GET /api/auth/magic-link/verify`
- `GET /api/auth/google/start`
- `GET /api/auth/google/callback`
- `GET /api/auth/me`
- `POST /api/auth/logout`
- `GET|POST /api/tenant/sites`
- `GET /api/tenant/billing-accounts`
- `POST /api/tenant/billing-accounts/merge`
- `GET /api/tenant/sites/:siteId`
- `GET /api/tenant/sites/:siteId/analytics?range=7|30|90`
- `POST /api/tenant/sites/:siteId/transfer-request`
- `POST /api/tenant/site-transfers/accept`
- `PATCH /api/tenant/sites/:siteId/features`
- `PATCH /api/tenant/sites/:siteId/theme`
- `PATCH /api/tenant/sites/:siteId/domains`
- `POST /api/tenant/sites/:siteId/agent-tokens`
- `DELETE /api/tenant/sites/:siteId/agent-tokens/:tokenId`
- `POST /api/agent/embed/install`
- `POST /api/agent/embed/validate`
- `POST /api/billing/checkout-session`
- `POST /api/billing/customer-portal`
- `POST /api/billing/stripe-webhook`

Billing add-ons:
- `feature_pack`: unlocks premium interaction features on free plan
- `analytics_pack`: unlocks full analytics modules on free plan (Pro/Business include analytics by default)

## Content Guidelines

GIGA.FORA is designed for open discussion of ideas. Users can report content for:
- Spam or advertising
- Harassment or bullying
- Misinformation
- Hate speech
- Violence or threats

## Docs

- [Main Site](https://giga.fora/): The main forum interface
- [About](https://giga.fora/about.md): About GIGA.FORA and its mission

## Optional

- [API Documentation](https://giga.fora/api-docs.md): Full API reference for developers