Sharing & Links
GospeLib makes sharing beautiful and frictionless — from visual scripture cards for social media to deep links that open directly to a passage, plus smart clipboard detection that recognizes scripture references.
Share Options
When sharing a passage (via action ring → Share or verse context menu):
| Format | Description | Destination |
|---|---|---|
| Scripture Card | Beautiful visual card image | Instagram, Twitter, Messages, any image-accepting app |
| Deep Link | gospelib.com/read/<bookId>/<chapter>/<verse> | Any app — opens in GospeLib or web reader |
| Plain Text | Nicely formatted text with reference | Messages, email, notes |
Scripture Card Generator
The signature sharing format — a visual card that makes scripture text look beautiful in any social context.
Card Anatomy
| Element | Details |
|---|---|
| Background | Warm paper texture (tan-50) or user-selected from 6 options |
| Scripture text | Gentium Plus, balanced line breaks, centered |
| Reference | Below text, small-caps, corpus identity color |
| Attribution | "GospeLib" watermark, bottom-right, very subtle |
| Border | Thin decorative border in corpus color (optional) |
Background Options
| Option | Visual |
|---|---|
| Paper (default) | Warm tan texture — matches the app's paper surface |
| Dark | Navy-800 with light text — elegant for social media |
| Color | Solid corpus identity color with white text |
| Minimal | Pure white-200 with black text — clean and simple |
| Photo | User's camera roll photo with text overlay (semi-transparent paper band) |
| Seasonal | Rotating seasonal design (Christmas, Easter) |
Typography Rules
| Property | Value |
|---|---|
| Font | Gentium Plus (always — brand consistency) |
| Size | Auto-scales based on text length: short verses get large type, long passages get smaller |
| Max lines | 8 for standard card. Longer passages use "…" with "read more" indicator |
| Alignment | Centered for ≤4 lines, left-aligned for >4 lines |
| Red-letter | Christ's words render in #A83232 on light backgrounds, #E87070 on dark |
Aspect Ratios
| Preset | Ratio | Optimized For |
|---|---|---|
| Square | 1:1 | Instagram feed |
| Story | 9:16 | Instagram/TikTok stories |
| Wide | 16:9 | Twitter, presentations |
| Card | 4:5 | General social media |
Deep Links
Canonical URL Schema
https://gospelib.com/read/<bookId>/<chapter>/<verse>
https://gospelib.com/read/<bookId>/<chapter>/<startVerse>-<endVerse>
https://gospelib.com/topic/<topicSlug>
https://gospelib.com/word/<strongsNumber>
https://gospelib.com/graph/<passageId>
Examples:
https://gospelib.com/read/gen/1/1→ Genesis 1:1https://gospelib.com/read/1-ne/3/7→ 1 Nephi 3:7https://gospelib.com/read/dc/121/1-6→ D&C 121:1–6https://gospelib.com/topic/faith→ Topical Guide: Faithhttps://gospelib.com/word/H0430→ Hebrew word entry (Elohim)
Universal Links
| Platform | Behavior |
|---|---|
| iOS (app installed) | Opens directly in GospeLib app to the exact passage |
| Android (app installed) | Opens in GospeLib via App Links |
| Any platform (no app) | Opens web reader with passage + app install banner |
Web Reader (Non-Users)
Deep links for users without the app installed open in a web reader:
| Feature | Details |
|---|---|
| Content | Full passage text with basic formatting |
| Styling | Matches GospeLib's paper aesthetic (Gentium Plus, warm tones) |
| Install prompt | Subtle floating banner: "Read in GospeLib" with app store links |
| No gate | Content is always visible — never behind an install wall |
Clipboard Detection
When the user copies text from outside the app that contains a scripture reference:
Detection
| Trigger | Behavior |
|---|---|
| App foreground | Check clipboard for scripture patterns |
| Detected pattern | e.g., "John 3:16", "1 Nephi 3:7", "D&C 121" |
| Prompt | Subtle banner at top: "Open John 3:16?" |
| Action | Tap banner → opens passage in reader |
| Dismiss | Banner fades after 5 seconds or on swipe |
Reference Patterns Recognized
- Standard: "Genesis 1:1", "Gen 1:1", "Gen. 1:1"
- Abbreviated: "Mosiah 2:17", "Mos. 2:17"
- Numbered books: "1 Nephi 3:7", "1 Ne. 3:7", "1Ne 3:7"
- D&C: "D&C 121:1", "Doctrine and Covenants 121"
- Ranges: "John 3:16–17", "Gen 1:1-3"
Scripture Reference Auto-Linking
In any text input field within the app (notes, journal entries), scripture references are automatically detected and converted to tappable links:
| State | Visual |
|---|---|
| Detected | Blue underline (standard link styling) |
| Tap | Opens passage in reader (new navigation stack) |
| Long-press | Preview popup with verse text |
PDF Export
For users who want to print or share study notes:
| Property | Value |
|---|---|
| Content | Selected passages + user's highlights, notes, and annotations |
| Typography | Gentium Plus for scripture, Inter for notes |
| Layout | Print-optimized margins, proper page breaks |
| Colors | Highlight colors preserved in color printing; outlines used for B&W |
| Header/Footer | Passage range + "Generated from GospeLib" + date |
Brand Consistency
All shared content maintains brand identity:
| Element | Rule |
|---|---|
| Font | Always Gentium Plus for scripture text |
| Colors | Corpus colors and brand palette preserved |
| Attribution | Subtle "GospeLib" watermark — never intrusive |
| Quality | Cards export at 2× resolution for retina displays |
Related Pages
- Colors — corpus identity colors in cards
- Typography — Gentium Plus rendering rules
- Reader Experience — share gesture from action ring
- Subscriptions — premium card templates