All changes synced
My Wedding
Vendors
Profile
Feature Index
REAL BRIDES
COMPLETE FEATURE INDEX
Every feature across the planning suite, vendor platform, magazine, tools, guest experience, and infrastructure — documented for reference.
35 Planner Screens
49 Admin Screens
7 Tools
13 Add-on Packs
5 Vendor Tiers
AI Concierge
Gamification
Community Q&A
1 · ACCOUNTS
Identity & Access
Three-layer role model — auth role, profile type, per-wedding role.
Authentication
Email + password sign-up and login (Supabase Auth)
Session persistence across app restarts
Account deletion and data export
User Profiles
Auth Role: user | vendor | admin (database-level RLS enforcement)
Profile Type: bride | groom | bridesmaid | groomsman | wedding_planner | family | guest | vendor
Per-Wedding Role: 19 distinct roles assigned per wedding (MOH, best person, MC, coordinator, photographer, DJ, caterer, florist, officiant, and more)
Avatar upload, display name, bio, province, city
Onboarding completion tracker
Multi-Wedding
One account can belong to multiple weddings simultaneously
Wedding Switcher — change active wedding from any screen
Each wedding has fully independent data (tasks, guests, budget, members)
Referral System
Every user gets a unique shareable referral code
Referral link pre-fills code on signup (?ref=CODE)
Server-side attribution via claim_referral_code RPC
Referral credits unlock premium discount
Summary: total referrals, credited rewards, referred-by code
2 · PLANNING SUITE
15 Integrated Modules
Built ground-up for the South African wedding market.
Checklist Templates — 4-Tap Build Flow
1 Base Plan + 13 Add-on packs applied in 4 taps. Tasks auto-dated relative to wedding date. Deduplication when stacking add-ons.
White Wedding
Traditional African
Indian–SA Fusion
Winelands
Bushveld/Safari
Beach/Coastal
Intimate/Micro
Elopement
Destination
Same-Sex/LGBTQ+
Budget-Friendly
Bridal Beauty Countdown
Task Management
Title, description, category, priority (high/medium/low), due date, status. Filter, search, bulk-apply from templates.
Task Detail: inline editing, file attachments, voice memos, threaded comments
Task calendar view — monthly calendar with task indicators
Role-restricted: only authorised roles can create/edit tasks
Budget Management
16 SA wedding categories. Estimated vs actual tracking. Payment recording with method, status, and vendor linkage.
Budget category breakdown chart — planned vs actual horizontal bar chart per category, colour-coded over/under budget
Budget Split — divide total spend between bride family, groom family, couple
Budget Payments tracker — EFT, card, cash; mark paid; running balance
CSV export of full budget breakdown (Premium)
Guest Management
Add/edit/delete guests with full profile: RSVP status, dietary, +1, age group, table assignment, side (bride/groom/mutual).
RSVP statuses: pending, attending, declined, maybe
Dietary options: vegetarian, vegan, halaal, kosher, gluten-free, other
CSV Import — upload spreadsheet with intelligent column auto-mapping
RSVP portal — guests RSVP via web link (no app required)
RSVP deadline enforcement — set a cutoff date; guest portal auto-shows closed state; countdown banner for the couple
Pending RSVP nudge — amber banner when guests haven't responded; taps to filter the list
Guest-count summary: total invited, attending, declined, pending
Wedding Team (Members)
Invite team members by email or wedding code. 19 roles with 9 fine-grained permissions per role, fully configurable by the couple.
Role Settings screen — couple toggles access per feature per role
Broadcast — send message to all wedding members (push + in-app); 6 pre-written templates (RSVP reminder, ceremony time, running late, day before, parking, we're married!)
Planner Manage — professional planners manage multiple weddings from one view
Seating Plan
Create tables (round, rectangular, square) with capacity. Assign guests by drag/dropdown. Unassigned counter. Export via PDF.
Day-of Timeline
Minute-by-minute schedule from hair & makeup to send-off. 22-event SA template. Shareable with vendors and wedding party. Guest view via RSVP portal.
Conflict detection — inline warning badge when two events share the same start time
Songs & Playlist
Ceremony (processional, signing, recessional) + reception (cocktail, dinner, first dance, parent dances, cake cut, party, last dance). Guest song requests via portal.
Request inbox — couple approves, declines, or marks must-play
Share Playlist with DJ — native share sheet sends formatted Must Play + Approved list as text
Spotify/YouTube link per song. Export brief for DJ (Premium)
Photo / Shot List
Three built-in template sets: Classic (~60 shots), Iconic (timeless poses), Viral (TikTok/Instagram trending). Custom shots. Reorder. Mark captured.
12 categories: getting ready, first look, ceremony, family, wedding party, couple, details, reception, dancing, send-off, iconic, viral
Priority flags: must / want / nice. Duration estimate per shot.
Send to Photographer — printable PDF (Premium)
Florist Brief
Structured brief for bouquets, buttonholes, ceremony arch/aisle/altar, centrepieces. Colour palette, flower prefs, style notes, reference images per item.
Share with Florist — public link, WhatsApp, email (Premium)
Final Countdown (T-72h)
Role-grouped 72-hour pre-wedding checklist across 11 vendor/team groups. SA-specific action copy throughout.
The Couple
Person of Honour
Wedding Party
MC
Parents
Coordinator
Photographer
DJ/Band
Caterer & Venue
Florist
Officiant
Exportable per role — send each person their personalised checklist
Bulk-apply countdown items into main wedding tasks
Honeymoon Planner
Destination, travel dates, accommodation, day-by-day itinerary, packing list, flight/transfer details.
Notes
Freeform notes with title, body, category (ideas, vendor notes, budget notes, ceremony, venue, logistics, personal). Full-text search. File attachments.
Export Suite (Premium)
PDF: full wedding plan — tasks, guests, timeline, seating chart, budget summary, songs, florals. CSV: guest manifest, task list, budget. Florist brief PDF. Shot list PDF.
Gamification & Achievements
XP awarded for every planner action. XP accumulates into Levels 1–30. Each level above 1 earns 1% discount toward Premium (max 30%). Reward codes at milestone levels.
XP actions: module_opened, module_tasks, module_budget, module_guests, module_seating, module_timeline, module_songs, module_members, module_florist, module_photography, module_export, vendor_added_to_plan
Gamification runs server-side (RPC) — never blocks UI
3 · PREMIUM
Couple Premium Upgrade
Once-off per wedding. No subscription. No caps on creation.
R249 once-off per wedding
Free tier has zero creation caps — unlimited tasks, guests, budget items, notes, florals, photos. Premium unlocks sharing and export only.
PDF export — full branded wedding plan
CSV export — guest manifest for caterer, task list, budget breakdown
Florist brief share — public link + WhatsApp + email
Shot list send to photographer — printable A4/A5 PDF
Gift registry share — public link for guests
Send-to-vendor capability (any exported document)
Weekend special pricing (configurable: e.g. R175 on selected weekends)
Achievement discount: up to 30% off based on planner level
Referral credits: discount via referred signup rewards
Promo code redemption: apply admin-issued discount code at checkout (percentage or fixed amount)
Guest Selfie Verification: require guests to submit a photo post-RSVP (toggle on invite page)
Payment via PayFast (SA's leading payment gateway)
4 · VENDORS
Vendor Platform
Profile, discovery, leads, analytics, availability, and advertising.
Discovery & Directory
20+ vendor categories: photographer, venue, florist, DJ, caterer, hair & makeup, cake, entertainment, transport, videographer, jewellery, decor, stationery, officiant, planner, honeymoon, and more
Filter: province, city, price range, average rating, listing tier
Full-text search by name and keyword
Save/favourite vendors (persisted, per-user)
View count tracking per vendor (server-side RPC, not double-countable)
Vendor Profile
Business name, tagline, description, logo, cover image, gallery
Category, province, city, address, min/max pricing (ZAR)
Website, Instagram, Facebook links
Verified badge (awarded by admin on document verification)
Average star rating + review count
Response time badge: '\u26a1 Replies quickly' or '\u23f1 Replies in ~Xh' computed from last-90-days conversation data (min 3 conversations); shown on directory cards
Availability
Calendar mode: per-day availability calendar; couples see live availability for their wedding date
Contact mode: hide calendar; show custom 'Contact for availability' note
Toggle via switch in vendor dashboard — change takes effect immediately
Enquiries & Leads
Enquiry inbox: full threaded message conversations with couples
Enquiry includes: couple name, wedding date, guest count, location, message
Reply directly in-app; mark as replied/archived
Response rate metric shown on vendor analytics
Zero commission on leads — vendor keeps 100%
Analytics (Bronze+)
Profile view count trend (30-day, weekly breakdown)
Enquiry count and funnel conversion
Save count (couples who favourited)
Review average trend
Ad campaign impressions + clicks (when running advertising)
Subscription Tiers
Feature
Free
Bronze
Silver
Gold
Platinum
Price/mo
R0
R299
R599
R999
R1,999
Gallery photos
3
15
25
40
∞
Verified badge
✓
✓
✓
✓
✓
Analytics
✓
✓
✓
✓
✓
Enquiry alerts
✓
✓
✓
✓
✓
Priority search
—
✓
✓
✓
✓
Category featured
—
—
✓
✓
✓
Homepage rotation
—
—
—
✓
✓
Newsletter feature
—
—
—
—
✓
Top placement
—
—
—
—
✓
Dedicated support
—
—
—
—
✓
Shot Lists (Vendor Side)
View and review shot lists shared by couples or photographers
Three built-in templates: Classic, Iconic, Viral
Printable PDF generation
Vendor Verification
Upload verification documents (business registration, ID, portfolio)
Admin reviews and grants verified badge
Vendor Application / Onboarding
Structured application form reviewed and approved by admin
On approval, profiles.role set to 'vendor'
5 · ADVERTISING
In-App Advertising Platform
Impression tracking, click tracking, regional targeting, tier-weighted delivery.
Ad Infrastructure
Named placement slots on specific pages (planner_bottom, vendors_top, article_inline, etc.)
Placement config: page, position (top/bottom/inline/full), dimensions, max ads per slot
Ad serving via server-side RPC (get_ads_for_placement)
Delivery multiplier by vendor tier: Free=1×, Bronze=3×, Silver=4.5×, Gold=6×, Platinum=10×
Google AdSense fallback when no in-house ad fills the slot
Ad Types
Category Banner
Featured Listing
Homepage Spotlight
Newsletter Feature
Inline Content Ad
Full-Screen Interstitial
Regional Targeting
All 9 SA provinces individually selectable
Bronze included: Gauteng + KZN + Western Cape
Additional provinces: R99/month each
National delivery (all provinces) at no extra cost if no regions specified
Ad Analytics
Impression tracking: ad_id, user_id, device, timestamp
Click tracking: ad_id, user_id, destination URL, timestamp
CTR per ad, campaign-level reporting
Vendor-facing ad analytics dashboard
Admin ad analytics dashboard
Self-Serve Order Builder
Pick ad spaces, size, regions, duration — live pricing calculator
Submit request → admin reviews → campaign created
6 · CONTENT
Magazine & Editorial
Digital issues, articles, real weddings, and editorial submissions.
Digital Magazine Issues
Cover image, title, month/year, status (draft/published). PDF attachment (system viewer on mobile, browser on web). View count. Reverse-chronological grid.
Articles
Rich articles with category, cover, body, inline images, article gallery. Likes, threaded comments, share count, view count. Sponsored badge. Filter by category.
Real Weddings
Real South African weddings with story, photos, venue, province, style. Filter by location and season. Links to vendors featured in the wedding.
Wedding Submission Flow
Couples submit: bride/groom names, date, venue, province, story, photo gallery link
Admin review workflow: submitted → reviewing → approved → published / declined
Admin can reply by email to the submitting couple
Approved submissions published in Real Weddings section
7 · REGISTRY
Gift Registry
Products, cash funds, and experiences. Guest claims. Public share link.
One registry per wedding. Title, welcome message, cover image, theme.
Item types: Product (retailer/URL/SKU/brand/price/qty), Cash Fund (goal amount, bank details), Experience (activity + link)
Item priorities: low / normal / high. Group gifting flag per item.
Bank details stored: account name, number, branch code, reference hint
Guest Claims: authenticated guests claim items — qty, contribution amount, message
Cash fund progress bar: X% funded badge shown to guests when a goal is set
Thank-you tracking: couple marks each claim as thanked directly from the registry manager
Claim tracking: qty claimed, total contributions (ZAR), items remaining
Affiliate UTM links: Takealot, Yuppiechef and @home URLs auto-tagged on save for traffic attribution
Public share URL: /r/[share_token]. is_public flag (couple controls)
Registry share via link, WhatsApp, email (Premium)
8 · INSPIRATION
Mood Board / Vision Board
Create, curate, and organise wedding inspiration.
Create and name multiple boards
Pin images from the inspiration feed or upload custom images
Inspiration categories: dresses, venues, flowers, décor, cakes, hair & makeup, and more
View board as a curated collage
Cover image and theme per board
9 · GUEST PORTAL
Zero-Install Guest Experience
RSVP, timeline, song requests — no app, no account.
Accessed via /r/[code] — no download, no signup
Shareable link or QR code distributed via WhatsApp, SMS, or email.
Guest enters name → fuzzy-match against couple's guest list (portal_find_guest RPC)
Submit RSVP: attendance, dietary requirement, +1 details (portal_submit_rsvp RPC)
RSVP deadline: if a deadline is set and has passed, portal shows a 'RSVP is now closed' lockout message
Our Story card: couple writes an origin/engagement story displayed on the Details tab
Venue contact details: address, tappable phone number, and website link shown in the details grid
View wedding day timeline (portal_get_timeline RPC)
Request a song (portal_request_song RPC) — appears in couple's songs module
View previously submitted song requests
link_guest_to_user RPC — optionally links RSVP to an authenticated account
Real-time sync — RSVP data updates couple's guest list instantly
Guest Selfie Verification (Premium)
selfie_required flag on weddings — couple toggles from invite-page (Premium-gated with UpgradeModal for free tier)
Post-RSVP selfie step: camera-first file input (capture='user'), uploads to Supabase guest-selfies bucket
portal_update_selfie RPC — atomic update verified against wedding code (SECURITY DEFINER, anon-safe)
Anon RLS INSERT policy on storage.objects — guests upload without any authentication token
Selfie thumbnail in couple's guest list: 44×44 circular preview, rose border, fullscreen modal viewer
Count stat in guest info bar: 'X/N selfies' (only shown when selfie_required = true)
10 · TOOLS
7 Purpose-Built Calculators
No account required. SA industry data baked in.
Budget Split
Divide total spend across bride family, groom family, and couple. SA industry % defaults.
Cake Calculator
Portions per tier shape and size. Guest count → tiers needed.
Drinks Calculator
Bottles/cases for wine, beer, spirits, and soft drinks by guest count and duration.
Stationery Calculator
Invites, order of service, menus, place cards, thank-you notes — print quantities.
Timeline Builder
Standalone day-of schedule builder. 22-event SA wedding template with offset times.
Seating Planner
Standalone table builder. Assign guests, track capacity per table.
Vow Builder
Guided prompts to write personal vows. Print-ready output.
11 · COMMS
Notifications & Messaging
Push, in-app, threaded conversations, broadcasts.
Push Notifications (Expo Push)
Opt-in device token registration
Triggers: new enquiry, enquiry reply, broadcast, task reminder, RSVP received, new review
Admin broadcast: push to all users or specific segments
Notification log with read status (notifications table)
In-App Notification Centre
Bell icon with unread badge count
Mark individual or all notifications as read
Types: system, vendor_enquiry, task, rsvp, review, broadcast, admin
Messaging
Threaded conversations between couples and vendors (conversations + messages tables)
Message attachments: images and documents via AttachmentPanel
Realtime delivery via Supabase realtime subscription
Conversation list with unread indicator
Newsletter
Email capture for newsletter (newsletter_subscribers table)
Opt-out / re-subscribe management
Used for vendor newsletter ad placement package
12 · PLATFORM
Infrastructure & Architecture
Cross-platform. Real-time. Enterprise-grade security.
Multi-Platform Delivery
iOS (App Store — Expo-built native app, bundle za.co.realbrides.magazine)
Android (Play Store — React Native, same codebase)
Web (Firebase Hosting, Progressive Web App — www.realbridesmagazine.co.za)
Single codebase via Expo + expo-router for all three targets
Backend (Supabase)
PostgreSQL database with 50+ tables
Row-Level Security (RLS) on every table — no client-side security reliance
25+ stored procedures (RPCs) for atomic multi-step operations
Supabase Storage buckets: vendor images, gallery, PDFs, attachments, article images
Supabase Realtime: live sync for tasks, guests, messages, notifications
Supabase Auth: email/password, session management, JWT tokens
Realtime & Performance
useRealtime hook — live sync hooks subscribed per-wedding, per-vendor
usePaginatedQuery — cursor-based pagination for large lists
Skeleton loading states throughout (no blank screens)
ErrorBoundary — graceful recovery, no full crashes
LoadingBar — global progress indicator
ToastHost — non-blocking success/error feedback
Security
Three-tier role model enforced at database level (RLS + RPCs)
has_wedding_permission RPC — server-side permission check before every mutation
Input validation library: required, email, phone, maxLength helpers
No raw SQL constructed client-side — all queries via typed Supabase client
POPIA-aligned data protection
Analytics & Event Tracking
analytics_events table — custom event tracking (page views, feature opens, button clicks, conversions)
wedding_milestones table — key planning milestones tracked automatically
vendor_activity_log — vendor action history
Guided Tours & Onboarding
TourPlayer component — multi-step spotlight walkthroughs with screen anchoring
5 tour groups: getting-started, planner, tools, guests, vendors
Audience-gated (couple sees couple tour; vendor sees vendor tour)
Tour completion stored locally — never shown twice
Help hub — browse all available tours by group
Upgrade & Monetisation UX
UpgradeModal component — contextual premium upsell at point of locked feature
PremiumFeaturePanel — inline teaser for locked features
PayFast payment gateway integration (SA-native)
WeddingSwitcher — multi-wedding picker component (header / profile)
Advertising Components
AdBanner — slot-based banner with auto impression + click tracking
InlineAd — inline between content blocks
Both auto-call get_ads_for_placement RPC and fire analytics events
AdSense fallback when no in-house ad available
Voice & Attachments
VoiceRecorder component — record and attach audio memos to tasks
AttachmentPanel — reusable file picker + upload + list (images, PDFs, documents)
wedding_attachments table — files attached to tasks, notes, or wedding
13 · ADMIN
22-Screen Admin Panel
Full editorial, vendor, advertising, and platform management.
Dashboard
Platform health: users, vendors, revenue, pending items
Analytics
User growth, vendor metrics, content performance, revenue, enquiries, submissions
Users
Manage all profiles: role assignment, name, email, delete
Vendors
Full CRUD: create, edit, delete, tier, status, pricing, images
Subscriptions
Tier management, revenue banner, bulk update, quick ↑/↓ per vendor
Pricing & Promos
4-tab screen: Pricing Config, Promo Code CRUD (create/edit/toggle/uses), Referral Tiers, Credit Ledger (paginated, type-filtered)
Settings
Platform config via app_settings table: announcement text, maintenance mode, dynamic key-value config
Articles
CMS: create, edit, publish, delete articles, categories, cover images
Issues
Magazine issue management: cover image, PDF upload, draft/publish
Submissions
Real wedding review workflow: view, approve, decline, reply by email
Reviews
Vendor review moderation: approve, flag, delete; filter by rating/status
Advertising
Campaign management: create/edit/delete ads, assign to placements, schedule
Ad Analytics
Per-campaign impressions, clicks, CTR
Partnership Requests
Review vendor subscription and advertising requests
Payments
PayFast payment log and status tracking
Campaigns
Promotional campaign creation and management
Brides
Dedicated bride/couple account oversight
Notifications
Push notification send + history + segments
Alerts
Internal system alert management
Audit Log
Full action trail: who, what, when, on which record
System Health
Database, storage, and auth health indicators
Ops Queue
Operational task queue for manual admin workflows
Ecosystem
Platform ecosystem and partner overview
Reports
Custom report generation
15 · GROWTH
Promo Codes & Incentive System
Admin-managed codes, credit ledger, app settings, and smart pricing infrastructure.
Promo Code Engine
Admin creates promo codes: percentage or fixed-amount discount, active toggle
applies_to: vendor_subscription | premium | all
max_uses cap with atomic increment (redeem_promo_code RPC prevents over-redemption)
valid_from / valid_until date windows
validate_promo_code RPC — returns discount type + amount without consuming a use
Applied at checkout: vendor subscription and couple Premium upgrade flows
Admin Pricing screen: Promo Codes tab — create, edit, toggle active, view uses_count / max_uses
Credit Ledger
credit_ledger table: transparent transaction log for all rewards and discounts
Entry types: referral_reward | promo_discount | premium_purchase | vendor_subscription
Every promo redemption logged before PayFast redirect via logPromoDiscount() helper
Admin Ledger tab: paginated view with type filter, ZAR amount display
Foundation for future: voucher issuance, loyalty credits, partner integrations
App Settings
app_settings table: key-value store for dynamic platform configuration (jsonb values)
Announcement banner: couples see real-time platform updates on home screen (rose, high-contrast, Megaphone icon)
Admin Settings screen: update announcement text, toggle maintenance mode
Extendable without schema changes — add any config key at any time
Referral Tiers (builds on §1 referral system)
Tiered discount percentages at milestone referral counts (Admin → Pricing → Referral Tiers tab)
Credit ledger integrates referral rewards alongside promo discounts for unified reporting
claim_referral_code RPC attributes signups server-side; rewards logged to credit_ledger
14 · REVENUE
Monetisation Streams
Five parallel revenue channels — no single point of dependency.
Stream
Model
Price
Vendor Subscriptions
Monthly recurring
R0 / R299 / R599 / R999 / R1,999
Premium Couple Upgrade
Once-off per wedding
R249 (discounts available)
Advertising — Banner
Per campaign
Custom
Advertising — Featured
Per campaign
Custom
Advertising — Homepage
Per campaign
Custom
Advertising — Newsletter
Per send
Custom
Regional Targeting Add-on
Monthly per province
R99/province
Sponsored Editorial
Per article
Custom
15 · INTELLIGENCE
AI Concierge & Smart Search
Context-aware assistance for couples, vendors, and admins.
AI Wedding Concierge
Premium planning assistant with wedding context: budget, tasks, venue, date, and progress. Supports budget advice, task prioritisation, week-ahead briefs, and war-room summaries.
3 free messages to try, then Premium-gated with daily rate limits
Actionable responses can suggest planner changes without sending PII to the model
AI Vendor Search
Natural-language vendor discovery across categories, budget hints, province, style, and occasion. Returns ranked matches with a reason for each result.
Examples: 'boho photographer in Cape Town under R15k' or 'luxury florist for a Winelands wedding'
Works alongside the normal vendor directory and filter system
AI Admin Console
A dedicated admin console for AI conversations, usage, rate limits, and quality control. Supports moderation and prompt analysis.
16 · GAMIFICATION
XP, Levels & Rewards
Progress loops for brides, vendors, referrals, and real-wedding contributions.
Planner Achievements
Planner actions award XP through the gamification engine. Levels climb from 1 to 30, with milestone rewards, badges, and shareable discount codes.
Module actions include tasks, budget, guests, seating, timeline, songs, members, export, notes, florist, photography, registry, and more
Real Bride milestone actions include community-facing planning tasks and special reward tiers
Referral Rewards
Shareable referral codes feed the discount ledger. Milestone tiers stack with planner levels to unlock meaningful savings.
Referral summary shows total referrals, credited rewards, and the referred-by code
Promo discounts and referral credits share one transparent ledger
Vendor Gamification
Vendor actions award XP too: subscriptions, ad bookings, referrals, profile completion, and listing updates. Milestones unlock ad credits and retention rewards.
Vendor rewards are tracked in a separate gamification state and event log
Vendor dashboard surfaces a rewards/achievements experience for retention
17 · ROI
Vendor ROI Dashboard
Proves the value of the marketplace to vendors in ZAR, not vanity metrics.
ROI Analysis
Vendors see the ZAR value of profile views, saves, enquiries, and wedding associations versus their subscription cost. Built to improve retention and upgrades.
All-time ROI and 30/90-day performance windows
Category-aware booking value assumptions for wedding market benchmarks
Marketplace Value Model
Turns engagement into an understandable business metric: views, saves, enquiries, and wedding conversions all translate into equivalent advertising value.
Shareable ROI summary helps vendors justify listing tiers and ad spend
REAL BRIDES
Magazine & Platform — Feature Index
© 2026 Real Brides Magazine. All rights reserved.
Johannesburg, South Africa · POPIA Compliant