"I praise you because I am fearfully and wonderfully made." — Psalm 139:14
As of November 1, 2026: soft launch is open. A fresh non-DEV production deploy (aim 0.9.7, 0.9.8, or a named 1.0.0) is still ahead — issue #765.
Production:https://belongonthespectrum.web.app/· Dev:https://dev-belongonthespectrum.web.app/
First Community: Belong on the Spectrum (partnered with DFW Church)
Not a Belong host:https://onthespectrum.web.app/(Firebase Site Not Found). The October 24–31 overlap window is past.
- 📱 Real Device Driving & Maestro Automation (
docs/real_device_driving_and_automation.md): Real hardware fleet (Pixel 9a, Pixel 8, emulator), Maestro MCP Server, live screen viewer (http://127.0.0.1:9999/), and Patrol BDD tests. - 🧠 Community Leader & Pastoral Brainstorms (
docs/wiki/Community-Leader-Brainstorms.md): Thoughtful calm-tech design trade-offs, church affiliation badge placement (Feed vs. Directory), notification cadence, and autistic-first norms (Issue #265). - 🚀 Release Readiness Gate & Progress Dashboard (
#261): Real-time and async launch gate covering Web, PWA (WebAPK), Android APK, and documentation synchronization. - 📣 Circle overlap invitation (
docs/circle_migration_invitation_post.md): Archived copy of the October 24–31 welcome post (Issue #249). It is not the current plan. - 📊 Circle App Store Review Learnings (
docs/benchmarks/circle_app_store_review_learnings.md): Competitive sentiment audit, pitfalls to avoid (notification spam, webview latency, back-stack bugs), and beloved patterns to replicate. - 🧭 Careful Maestro Driving Guide (
docs/benchmarks/circle_maestro_driving_guide.md): Non-destructive, read-only device discovery on Google Pixel 9a (so.circle.circle) with Zero-PII clean-framing protocol. - 🎨 Golden Testing & Visual Regression Guide (
docs/wiki/Golden-Testing-and-Visual-Regression-Guide.md): Headless font loading (TestFontLoader), Martin Fowler sociable widget goldens, and pixel-fidelity regression verification. - 📋 Maintainer Review After Session (
docs/archive/human_to_review_after_session.md): Executive breakdown of Milestones, Live Releases, ADRs (0001–0010), and verified device metrics. - 📡 Observability & Analytics (
docs/OBSERVABILITY_AND_ANALYTICS.md): Dual/Triple-observability across Firebase Crashlytics/Analytics & local Serverpod/Talker diagnostics. - 🗄️ Backend & Database Architecture (
docs/DATABASE_ARCHITECTURE.md): Under-the-hood map, Firestore collection schemas (users,posts,feedback), indexes, security rules, and Serverpod RPC mapping. - 🎓 Engineering Lessons Learned & Accomplishments: Mentee reference covering real device testing, MCP tooling, and zero-PII architecture.
- 🌙 Unattended Session Execution Plan & LLM Troubleshooting (
docs/archive/unattended_session_908pm.md): Live Mini-Milestones tracker, FAQ, and zero-stall troubleshooting guide for lighter LLMs. - 🚀 Deployment & Release Runbook (
DEPLOYMENT.md): 1-command pure-Dart release pipeline (tool/deploy_release.dart) forbelongonthespectrum.web.app, Firebase Hosting Preview Channels, and GitHub Releases. - 📿 Agent Harness 2.0 & Token Quota Preservation (
docs/AGENT_HARNESS_AND_ORCHESTRATION.md): Multi-model quota routing, orchestrator-subagent topology, beads state DAG, and local 48GB Mac fallback. - ⚖️ ADR-0009: Serverpod → Appwrite Core + Firebase Edge Hybrid Strategy: Graded comparison (A+ /
9.7/10) of Piece-by-Piece vs. One-Shot migration and permanent Firebase Hosting/FCM/Audiences coexistence.
Refuge is an open, white-labelable, calm-technology community platform built with Flutter, Riverpod (hooks_riverpod), Serverpod (default post backend), Cloud Firestore (second copy), and Firebase edge services. Appwrite is on main (PR #412, fc71fd4) and stays off unless both APPWRITE_ENDPOINT and APPWRITE_PROJECT_ID are set. It has not replaced Serverpod. #384 is not closed. The Flutter package name is still refuge4serverpod (#233).
Its flagship community is Belong on the Spectrum — a welcoming Christian & neurodivergent/autistic fellowship community.
- Familiar Circle.so-Style Navigation:
- Top Bar: Official Belong cross & gold neurodiversity infinity (
∞) logo in the upper-left, "Feedback & Vote" pill + Sensory Theme switcher + Member Profile Avatar in the upper-right, andFeed|Spacesselector below the logo. - Spaces Hierarchy:
- 📌 Pinned:
General Chat - 👋 Welcome:
Start Here & Introduce Yourself,Announcements - 🤝 Community:
General Chat,Memes,Online Resources / Videos,Actually Autistic Chat,Friends Chat,Family Chat - 📅 Actually Autistic:
Actually Autistic Events - 🔗 Links:
Community Guidelines,DFW Church(dfwchurch.org),Download the Android App,Download the iOS App
- 📌 Pinned:
- 4-Tab Bottom Navigation Bar:
Feed,Spaces,Search, andMsgs.
- Top Bar: Official Belong cross & gold neurodiversity infinity (
- Neurodivergent-First Feedback & 1-Tap Feature Voting (
ADR-0007):- Literal 3-Intent Cards (💚 Works Great, 💡 Idea / Tweak, 🛠️ Bug / Confusing) + 1-Tap Feature Voting Board backed by pluggable
InMemory,Serverpod,Appwrite, andFirebaserepository adapters (ADR-0009).
- Literal 3-Intent Cards (💚 Works Great, 💡 Idea / Tweak, 🛠️ Bug / Confusing) + 1-Tap Feature Voting Board backed by pluggable
- Non-Technical Organizer Control (
Firebase Remote Config):- Community organizers can update the "Message from the Organizer" welcome card, announcements, and store links anytime from the Firebase Console without code changes.
- 4 Neurodivergent-Affirming Sensory Themes (WCAG AAA):
- High Clarity, Warm Calm, Low Stimulus Dark, and Low Motion (zero surprise pop-ups or auto-playing media).
| Guide | Audience | Description |
|---|---|---|
| 🧠 Leadership & Pastoral Brainstorms | Pastors & Organizers | Open design questions: church badge placement (Feed vs. Directory), calm notification digests, and icebreaker prompts. |
| 📅 After October 31 — solid 1.0 | Organizers & Pastors | Short list still open after the overlap week. Engineering detail: docs/solid_1.0_checklist.md and #765. |
| ⚖️ Backend Migration & Hybrid Grading (ADR-0009) | Engineers & Architects | Why Appwrite Core (Auth/DB/Realtime) + Firebase Edge (Hosting/FCM/Audiences) scores A+ (9.7/10), and Piece-by-Piece vs. One-Shot grading. |
🛠️ Refuge CLI (tool/refuge_cli.dart) |
Engineers & Mentees | ship-pr (CodeRabbit-gated merges), privacy-scan, sync-wiki, exit codes & FAQ. Run dart run tool/refuge_cli.dart help. |
| 🚀 Deployment & Release Runbook | Engineers & Release Ops | Pure-Dart deployment script (tool/deploy_release.dart) + week1 Audio MP3 Release Notes roadmap. |
| 📣 Organizer Remote Config Guide | Organizers & Leaders | How to edit the "Message from the Organizer" banner without needing a developer. |
| 📱 PWA & App Store Guide | Members & Organizers | How members install Belong to their iPhone/Android Home Screen in 10 seconds. |
| 🗄️ Backend & Database Architecture | Engineers & Organizers | Under-the-hood map, Firestore collection schemas (users, posts, feedback), indexes, security rules, and Serverpod RPC mapping. |
| 🤝 Contributor Guide | Volunteers & Developers | How to contribute via Ticket-Driven Development (1 Issue = 1 Worktree = 1 PR). |
| 🎓 Student, Mentee & Apprentice Guide | Students & Mentees | Clean architecture walkthrough, BDD testing, pure-Dart CLI tools (tool/refuge_cli.dart), and Free-Tier AI Token Optimization. |
| 🤖 Local LLMs & Token Quota Preservation Strategy | Engineers & AI Agents | Hardware benchmarks (48GB Apple Silicon unified RAM), Ollama + Qwen 2.5 Coder 32B/14B setup, and mechanical task delegation taxonomy. |
| 📿 Agent Harness 2.0 & Token Quota Preservation | Engineers & Mentees | Preserving Gemini Pro weekly caps, Flash subagent delegation, beads execution DAG, and local 48GB Mac Ollama fallback. |
# 1. Fetch dependencies
flutter pub get
# 2. Run static analysis & BDD/widget test suite
dart analyze
flutter test
# 3. Deploy to Firebase Preview Channel + Live Production (https://belongonthespectrum.web.app)
dart run tool/deploy_release.dart --version v0.8.0-alpha --channel v0-8-0-alpha --prod --github-release