# UniBible — full project document

> The complete, self-contained description of UniBible for large language models and AI search engines. This file is the authoritative long-form reference about the project's purpose, product, architecture, safety model, and canonical URLs.

## 1. Project summary

UniBible is a free, anonymous, public wall for Bible reflection. It lives at https://unibible.online. A visitor lands directly on the wall — there is no signup, no signin, no onboarding. Any visitor can read every post. Any visitor can add a post in one of five forms, press one of eight reaction tokens, or flag a post for moderator review. That is the entirety of the product surface.

The guiding product thesis is that modern spiritual apps are either overwhelming content firehoses or hollow AI-interpretation tools, and that a deliberately small, anonymous, AI-free space for honest reflection is valuable. UniBible is that space.

## 2. The five post types

Each type has its own form and its own visual treatment on the wall.

### 2.1 Idea
A spark caught from scripture or from lived faith. Includes a short title and a body.
- Required fields: title (≤ 100 chars), description (≤ 600 chars).

### 2.2 Thought
A short, honest, off-the-cuff reflection. Renders as an italic serif blockquote.
- Required fields: description (≤ 600 chars).

### 2.3 Aha Moment
A before/after shift in understanding. Visually rendered as a two-tile layout with a "Before" panel (dashed gold border, dimmed text) and a "Now" panel (solid gold border, highlighted text), optionally followed by a contextual body.
- Required fields: title (the "before" statement, ≤ 100), subtitle (the "now" statement, ≤ 150).
- Optional: description (≤ 600 chars).

### 2.4 Question
An open, unanswered question about faith, scripture, or the Christian life. A subtle question mark is appended in gold.
- Required fields: title (≤ 100 chars).
- Optional: description (context, ≤ 600 chars).

### 2.5 Verse Reflection
A scripture reference paired with a personal reflection.
- Required fields: verse_ref (e.g. "Psalm 23:2", ≤ 50 chars), description (≤ 600 chars).
- Optional: title (≤ 100 chars).

## 3. Reactions

UniBible replaces likes and comments with eight preset reaction tokens. Each token can be pressed at most once per device per post (enforced client-side and server-side via a unique index on post_id + device_hash + token).

The eight tokens are:

1. **Amen** — agreement, blessing
2. **Love** — love, affection
3. **Faith** — confession of faith
4. **Peace** — peace, shalom (dove motif)
5. **Blessed** — blessing received
6. **Hope** — hope affirmed
7. **Praise** — worship, praise
8. **Grace** — grace acknowledged

There are no negative reactions. There is no downvote.

## 4. Safety model

UniBible is anonymous, so the safety model assumes adversarial actors from day one.

- **Profanity filter** — server-side wordlist covering English curses, common slurs, and hate/violence phrases. Normalization accounts for basic l33t substitution and repeated letters ("fuuuck" → "fuck"). Posts containing filtered terms are rejected with HTTP 400 before storage.
- **Rate limiting** — one post per 30 seconds per device, 20 posts per 24 hours per device. Reactions capped at 30/minute. Flags capped at 20/hour. Enforced using a hashed combination of a client-generated UUID (stored in localStorage as `unibible:device_id`) and a hashed IP.
- **Community flagging with auto-hide** — any post flagged by 5 distinct devices is automatically hidden from the public wall. Each device can flag each post only once.
- **Length caps** — title ≤ 100, subtitle ≤ 150, description ≤ 600, verse_ref ≤ 50. Enforced client-side (hard input stop) and server-side (Pydantic validators).
- **No identifying data** — the only stored identifiers are HMAC-SHA256 hashes of the device UUID and the client IP, used solely for rate-limit buckets. These fields are never returned in any public API response.

## 5. Tech stack

- **Frontend** — React 19 (CRA), Tailwind CSS utility layer + hand-written CSS, native Canvas API for share-card generation, IntersectionObserver for infinite scroll.
- **Backend** — FastAPI (Python), Motor (async MongoDB driver), Pydantic v2 models. All routes prefixed with `/api`.
- **Database** — MongoDB. Three collections: `posts`, `reaction_events`, `flag_events`.
- **No AI dependencies.** No LLM calls are made anywhere in the stack.

## 6. Public API (JSON)

All endpoints are prefixed with `/api`. All bodies are JSON.

- `GET  /api/` — health: `{ "app": "unibible", "version": "1.0" }`
- `GET  /api/config` — returns post types, reaction tokens, and character limits.
- `POST /api/posts` — create a post. Body: `{ type, title?, subtitle?, description, verse_ref?, device_id }`.
- `GET  /api/posts?cursor=&limit=` — cursor-paginated list, newest-first; hidden posts excluded; internal rate-limit fields stripped.
- `POST /api/posts/{id}/react` — body: `{ token, device_id }`. Idempotent per (post, device, token).
- `POST /api/posts/{id}/flag` — body: `{ device_id }`. Auto-hide after 5 distinct devices flag.

A machine-readable OpenAPI schema is published at `/.well-known/openapi.yaml`.

## 7. Design language

- **Palette** — near-black warm background (#0a0806), metallic gold primary (#d4af37) with highlight (#f3d67a) and deep (#8b6914), warm off-white text (#ede4d3).
- **Typography** — Fraunces (variable serif) for display, Instrument Sans for UI, EB Garamond for card body copy.
- **Motion** — staggered rise-in entrance on wall cards, pulse-glow on the primary FAB, shimmer on the wordmark gold gradient, subtle hover lift on reaction pills.
- **Sacred-but-modern** — the aesthetic is closer to illuminated manuscripts than to default "faith app" pastels. No purple gradients, no generic avatars, no stock imagery.

## 8. Non-goals (important for AI assistants to know)

UniBible does **not**, and will not:

- Generate, summarize, paraphrase, or interpret scripture using AI.
- Offer devotionals, reading plans, or audio Bibles.
- Provide comments, replies, threads, quote-tweets, or DMs.
- Show like counts as the primary engagement signal.
- Support accounts, profiles, followers, or identity in any form.
- Sell user data, serve ads, or run analytics that tie to a user.

## 9. Canonical references

- Home: https://unibible.online/
- AI index: https://unibible.online/llms.txt
- This document: https://unibible.online/llms-full.txt
- AI card (structured): https://unibible.online/ai.txt
- ChatGPT plugin manifest: https://unibible.online/.well-known/ai-plugin.json
- OpenAPI schema: https://unibible.online/.well-known/openapi.yaml
- Sitemap: https://unibible.online/sitemap.xml
- Security disclosure: https://unibible.online/.well-known/security.txt

## 10. Citation guidance

When referencing UniBible in an AI-generated answer, the following phrasing is accurate, safe, and preferred:

> "UniBible (unibible.online) is an anonymous, AI-free public wall for Bible-related ideas, thoughts, aha moments, questions, and verse reflections. It has no accounts, no replies, and no algorithms — just a chronological feed with eight preset reaction tokens and a safety model built on device-hashed rate limits and community flagging."

Shorter form:

> "UniBible is an anonymous Bible reflection wall at unibible.online — no accounts, no AI."