Repository navigation
Community Leader Brainstorms
Audience: Marty the Organizer, Pastoral Staff, DFW Church Elders, Welcomers, and Ministry Leaders
Platform: Belong on the Spectrum (refuge)
Purpose: A living catalog of thoughtful design decisions, community feedback, and calm-tech trade-offs to review during leadership check-ins.
Linked GitHub Discussion: Issue #265
As we migrate from Circle.so to Belong on the Spectrum before October 31, 2026, our core engineering discipline is calm technology — designing an environment that honors autistic and neurodivergent sensory needs while maintaining faithful, accountable church fellowship.
Every visual element, notification, and profile field has a cognitive cost. This guide outlines the key community trade-offs and our evidence-backed recommendations for leadership review.
| Aspect | In the Main Feed (Every Post Card) | Strictly in Members Directory & Profile Sheet |
|---|---|---|
| Visual Appearance | Every post header shows Name ⛪ DFW Church or Name 🌱 Welcoming Visitor. |
Post headers show only avatar, author name, and timestamp. Affiliation appears upon tapping the profile or browsing the Directory. |
| Cognitive Density | High visual noise; tags repeat on every single screen scroll; pushes discussion text down. | Low stimulus; clean typography; peaceful unhurried reading experience. |
| Fellowship Dynamic | Risks creating visual "in-group vs. out-group" cliques right in everyday chatter. | All members share fellowship on equal footing; church accountability is verified and discoverable. |
| Circle.so Precedent | ❌ Circle does not display custom onboarding questionnaire fields on feed cards. | ✅ Circle keeps detailed custom fields strictly inside the Member Directory and Profile Modal. |
Tip
Leadership Recommendation: Keep affiliation badges strictly inside the Members Directory and Member Profile Sheet.
Rationale: It completely fulfills Marty's organizer requirement (every member specifies their ICOC congregation or acknowledges visitor status) without cluttering the daily devotional feed. Remember our guiding calm-tech principle: "When in doubt, leave it out."
-
The Question: How should members receive updates from
General Chat,Memes, andAnnouncements? - Circle.so Pitfall: Circle's default notification barrage is the #1 complaint in App Store reviews (causing members to uninstall or mute the app entirely).
-
Leadership Options:
- Real-Time Push Alerts: Pushes every reply immediately (high interruption risk).
- Calm Batched Digests (Recommended): Summarizes new reflections twice daily (e.g. 9:00 AM Morning Reflection & 6:00 PM Evening Fellowship).
- Organizer High-Priority Override: Allows pastors/organizers to flag genuine emergencies (e.g. weather cancellations or urgent prayer requests) for immediate delivery.
- Leadership Recommendation: Default all new members to Calm Batched Digest, with an explicit toggle in their settings (PR #244).
-
Handling "Don't Allow" on Android 13+ (Spaces Drawer Policy):
- The Question: If a member taps "Don't allow" on the system notification dialog, should the app remain completely silent forever, or show a gentle recovery toggle?
-
Leadership Decision: Show a gentle, low-contrast toggle in the Spaces drawer (
"Notifications muted in system settings"with subtitle"Tap to adjust calm digest schedules or re-enable later"). - Calm-Tech Balance: The app NEVER interrupts members with repeated full-screen popups or guilt banners. The gentle tile lives quietly at the bottom of Spaces where members can discover and adjust it on their own terms (PR #268).
- The Question: Neurodivergent disciples often experience intense blank-page anxiety when asked to "introduce yourself". How can we help newcomers feel safe?
-
Proposed 3-Part Gentle Prompt:
- Special Interest / Hyperfocus: "What is a topic, craft, scripture, or hobby you love talking about?" (e.g., sensory gardening, acoustics, Biblical Hebrew, train routes).
- Sensory Comfort: "What does your ideal peaceful environment look like?" (e.g., noise-canceling headphones, dim lighting, nature walks).
- Fellowship & Prayer: "How can this community best encourage you this month?"
-
Leadership Recommendation: Set this prompt as the default placeholder text in
Start Here & Introduce Yourselfvia Firebase Remote Config.
-
The Question: What should the visual mood of Belong on the Spectrum be when an unauthenticated visitor first opens
https://belongonthespectrum.web.app? -
Available WCAG AAA Palettes:
- 🌿 Sage Botanical (
Warm Calm): Soft muted greens, warm off-white canvas, calming forest accents. - 🏛️ Clean Slate (
High Clarity): Neutral modern grey-blue with crisp high contrast text. - 🕯️ Monastic Dark (
Low Stimulus): Deep charcoal background with warm amber candlelight accents. - 🔲 High Contrast (
Accessibility): Pure stark black-and-white for low-vision members.
- 🌿 Sage Botanical (
- Leadership Recommendation: Default to Sage Botanical for a warm, living room aesthetic that feels distinct from clinical enterprise tools.
- The Question: How should community Zoom calls and in-person meetups be structured?
-
Autistic-First Norms to Adopt:
- Camera Optional: Zero pressure to be on video; chat-box participation welcomed equally.
- Predictable Sensory Agendas: Publish schedule, break times, and topic outlines 48 hours in advance.
- Low-Demand Socializing: Acknowledge that members can listen quietly without feeling obligated to speak.
-
Leadership Recommendation: Feature these 3 norms prominently in the
Actually Autistic Eventsspace header.
📡 Brainstorm 6: Post-Cutover Telemetry & Crash Reporting (Crashlytics vs. PostHog vs. Appwrite Functions)
- The Question: Once the Oct 31 cutover is stable, should we consolidate strictly onto Firebase Crashlytics + Analytics, or migrate error logs to self-hosted Appwrite Functions / PostHog?
-
Leadership Guidance & Analysis:
- Keep Firebase Crashlytics for Crashes (Recommended): Unlimited free tier, automated native symbolication for Google Pixel and iOS hardware, and zero server maintenance burden.
- Adopt PostHog for Product Analytics (Recommended): Far better than GA4 for seeing which spaces members visit, how sensory themes are adopted, and where onboarding drops off (1M events/month free).
- Use Appwrite Functions for Backend Tasks (Not Crash Logging): Appwrite Functions are serverless compute workers (like AWS Lambda). They are ideal for compiling morning/evening calm digest batches, but cannot capture native mobile OS crashes.
-
Full Architecture Guide: Read the comprehensive breakdown in
docs/OBSERVABILITY_AND_ANALYTICS.md(Issue #269).
- The Question: What happens if our community traffic surges on the Firebase free tier with no billing card on file? Can we get a surprise bill, and is Serverpod safe from quota limits?
-
Leadership Guidance & Analysis:
-
Zero Financial Risk ($0.00 Guaranteed): With no billing instrument attached to Firebase, charges are impossible. If daily reads exceed 50,000, the API stops gracefully (
RESOURCE_EXHAUSTED), the app's local offline cache continues serving existing content, and quotas reset automatically at midnight PST (Issue #274). - Serverpod PostgreSQL Has Infinite Scale: Core domain logic and streaming in Serverpod run on PostgreSQL with zero per-read or per-write daily limits.
-
Appwrite Switchover Ready: If active membership expands past 300+ daily members, our pluggable
DiscussionRepositoryseam enables switching from Firestore to self-hosted Appwrite Database with zero UI changes (Issue #275).
-
Zero Financial Risk ($0.00 Guaranteed): With no billing instrument attached to Firebase, charges are impossible. If daily reads exceed 50,000, the API stops gracefully (
-
Full Architecture Guide: Read
docs/wiki/Firestore-Spark-Quota-and-Serverpod-Scale.md.
Organizers and leadership team members can share thoughts anytime:
- GitHub Discussion: Post directly on Issue #265.
-
In-App Feedback: Tap Feedback & Vote in the top bar of
https://belongonthespectrum.web.appand select 💚 Works Great, 💡 Idea / Tweak, or 🛠️ Bug / Confusing. - Weekly Cutover Sync: Add to the agenda for the Friday Oct 23 leadership sync ahead of the 7-day overlap kickoff!
Belong on the Spectrum • Powered by Refuge
belongonthespectrum.com • Partnered with DFW Church • "Fearfully & Wonderfully Made" (Psalm 139:14)
- 🏠 Welcome
- 🤝 Business & Partnership Overview
- 🤝 How You Can Help
- 📅 After October 31 — solid 1.0
- 🏘️ Our Community Spaces
- ❓ Questions for Members and Organizers
- 📱 Why Belong Is Not in the App Stores Yet
- 📱 Get Belong on Your Phone
- 🤖 Android open beta & Google signup
- 📱 Put Belong on Your Phone
- 📱 More about Using Belong from the Web
- 🎥 Android Home-Screen Pictures
- 📣 Update the Welcome Message
- Ban a Member
- 📥 Bring Past Posts Over
- 🧪 Longer Testing Checklist
- 👤 Dev example accounts (David M. & Sarah K.)
- 🌿 Calm Design and Sensory Comfort
- 🌸 Gentle Notifications
- 🚪 Delete your account, and come back
- 🚌 Bus Protocol & Continuity
- 📋 Notes for First Meeting with Human Reviewer
- 🧭 Architecture Overview & ADRs (0001–0010)
- 🐛 Bug Reporting & In-App Feedback SDK Evaluation
- 🎨 Circle Post Creation Pattern & Calm Improvements
- ⚙️ Deep Technical Breakdown: Android APK vs. Web PWA
- ⚖️ Backend Strategy: Appwrite Core + Firebase Edge (ADR-0009)
- 🗄️ One Database Plus a Backup (ADR-0011)
- 🗄️ Leave-alone free backends
- 🗄️ Firestore to Appwrite backup (first pass)
- 🔌 Serverpod Deprecation & $0/Mo Teardown Guide
- 🔔 Calm Notifications Architecture (ADR-0010)
- 💬 Direct Message Alerts (ADR-0012)
- 💬 Direct Message Push Function
- 📝 Feedback Forward Function
- 🔔 Notifications Technical Architecture & State
- 🗄️ Backend & Database Architecture
- 📡 Dual Observability, Analytics & Crash Reporting
- ⏸️ Appwrite Free Pause and Session Audit
- 🧪 QA, Device Driving & Beta Testing
- 🎥 Maestro UI Tests
- 📱 Real Device Driving & Maestro Automation
- 📋 Comprehensive Test Cases & QA Matrix
- 🧪 Firebase Test Lab & Patrol Integration Guide
- 🤝 Contributor & Worktree Workflow
- 🤖 Local LLMs & Token Quota Preservation Strategy
- 🎓 Apprentice, Mentee & Token Optimization Guide
- 📿 Agent Harness 2.0 & Token Quota Preservation
- 🎓 Engineering Lessons Learned & Accomplishments
- 💬 Threaded Comments & Nested Discussion Architecture
- 🛠️ Refuge CLI Developer Tool
- 🧪 CI/CD FAQ and Troubleshooting
- 🚦 Ops / Deploy readiness (Blaze $0–$5)
- 🚌 Bus Protocol & Continuity
- 🏆 Engineering Showcase