Skip to content

Welcome to Ministry Mapper

What is Ministry Mapper?

Ministry Mapper is a modern, open-source web application that helps congregations manage their field ministry territories efficiently. Instead of using paper territory slips, Ministry Mapper provides a comprehensive digital solution for organizing, tracking, and managing field service work from any device with an internet connection.

Our Story

We started Ministry Mapper in 2022 as a simple project to help our local congregation manage territories more effectively. As more congregations discovered the benefits of digital territory management, we continued to enhance the platform. Today, Ministry Mapper is used by congregations in Singapore and Malaysia, helping publishers stay organized in their ministry work with features like real-time synchronization, interactive mapping, and multi-language support.

What Ministry Mapper Does

Ministry Mapper provides comprehensive territory management capabilities:

Core Features

  • 🗺️ Territory Management: Organize geographic regions into territories with automatic completion tracking
  • 🏢 Interactive Mapping: Leaflet-based maps with OpenStreetMap integration, directions, and geolocation
  • 📱 Real-time Collaboration: Live data synchronization across all devices via SSE (Server-Sent Events)
  • 🌍 Multi-language Support: 8 languages (English, Spanish, Indonesian, Japanese, Korean, Malay, Chinese, Tamil)
  • 👥 Role-based Access: Three congregation roles (Read-Only, Conductor, Administrator) with fine-grained permissions, plus link-based access for publishers who never need an account
  • 🔗 Assignment Links: Secure, time-limited sharing links for territory access without user accounts
  • 📊 Progress Tracking: Automatic completion status with visual indicators and statistics
  • ✉️ Email Notifications: HTML email templates for messages, notes, and monthly reports
  • 📈 Excel Reporting: Monthly congregation reports with detailed statistics
  • 🔐 Multi-factor Authentication: OTP, MFA, and OAuth2 (Google) support
  • 🌙 Themes: Light, dark, and system modes plus five colour themes (Classic, Tangerine, Perpetuity, Cosmic Night, Mocha Mousse)
  • 📲 Progressive Web App: Installable on mobile and desktop with offline asset caching

For Different Users

  • Territory Servants: Manage all territory records digitally with comprehensive statistics and reporting
  • Field Service Conductors: Quickly assign territories with intelligent algorithms and track publisher activity
  • Publishers: Access assigned maps via simple links, update address status in real-time, and collaborate effectively
  • Administrators: Full system control with user management, congregation settings, and audit trails

Problems Ministry Mapper Solves

Going Paperless

Traditional paper territory slips get lost, damaged, or become hard to read over time. Ministry Mapper keeps everything digital and safe in the cloud. You can access your territories from your phone, tablet, or computer anytime.

Better Organization

When territories are shared between multiple publishers, it's easy to accidentally work the same addresses. Ministry Mapper helps everyone see what's happening in real-time, so you don't waste time covering the same ground.

Instant Updates

When someone updates a territory, everyone sees the changes right away. No waiting for papers to be passed around or meetings to share updates.

Easier Record Keeping

Instead of manually writing down every change on paper slips, Ministry Mapper automatically tracks everything. This saves hours of work and prevents mistakes.

How Ministry Mapper Works

Modern Technology Stack

Ministry Mapper leverages cutting-edge web technologies for optimal performance:

Frontend (ministry-mapper-v2):

  • React 19.2.8: Latest UI library, compiled with the React Compiler for automatic optimization
  • TypeScript 6.0.3: Type-safe development for fewer bugs
  • Vite 8.2.0: Rolldown-based build tool and dev server
  • Tailwind CSS 4: Utility-first styling, configured directly in CSS
  • shadcn/ui on Base UI: Accessible component layer for dialogs, menus, and forms
  • Leaflet 1.9.4: Interactive mapping with OpenStreetMap tiles
  • wouter 3.10.0: Lightweight routing (3KB vs 40KB alternatives)

Backend (ministry-mapper-be):

  • Go 1.27: High-performance compiled language
  • PocketBase v0.40.0: Self-hosted backend-as-a-service with SQLite
  • modernc.org/sqlite v1.57.0: Pure-Go SQLite driver, so no C toolchain is needed to build
  • Sentry v0.48.0: Real-time error tracking and monitoring
  • MailerSend v1.6.6: Transactional email service
  • LaunchDarkly v7.15.6: Feature flag management
  • Excelize v2.11.0: Excel report generation
  • OpenAI (gpt-5.4-mini): AI-powered summaries for reports and message digests

Architecture Highlights

  • Self-Hosted: No vendor lock-in, complete control over your data
  • Multi-Tenant: Congregation-level data isolation for security
  • Real-Time Sync: SSE-based live updates across all clients
  • Progressive Web App: Installable on all devices with offline asset support
  • Docker Containerization: Easy deployment and scaling
  • API-First Design: RESTful API with comprehensive PocketBase SDK support
  • AI-Powered Insights: Optional OpenAI (gpt-5.4-mini) integration for intelligent report summaries and message digests

Important Considerations

Privacy First

Ministry Mapper tracks residential addresses, which means you need to follow privacy laws in your area. Different countries have different rules (like GDPR in Europe or CCPA in California). Make sure you understand and follow your local regulations before using Ministry Mapper.

Internet Required

Ministry Mapper works over the internet, so you'll need a connection to use it. If your area has unreliable internet, this might cause challenges. The app does work well on mobile data if WiFi isn't available. Publishers get some tolerance for patchy coverage: a map you have already opened can be read from a local cache, and address updates made offline are queued and sent as soon as the connection returns. Administrator actions always need a live connection.

Learning Curve

Moving from paper to digital is a change, especially for those less comfortable with technology. We provide help and support to make the transition easier for everyone in your congregation.

Getting Started

For Users

The easiest way to use Ministry Mapper is through our hosted service:

ministry-mapper.com

Simply:

  1. Visit ministry-mapper.com
  2. Create an account using the sign-up page
  3. Verify your email address
  4. Contact your congregation's administrator for proper permissions

Quick Links:

For Administrators

If you're considering Ministry Mapper for your congregation:

  • Recommended: Use our hosted service at ministry-mapper.com

  • No technical setup required

  • Professional support available
  • Automatic updates and maintenance

  • Better reliability and security

  • Alternative: Review the Deployment Guide (advanced users only)

We don't encourage self-hosting due to the technical complexity and ongoing maintenance requirements. The hosted service at ministry-mapper.com provides a simpler, more reliable solution.

Administrator Resources:

For Developers

If you're interested in the technical aspects or contributing:

Technical Documentation:

Development: