Platform Settings¶
Centralized configuration for organization identity, theming, email delivery, feature modules, and automated notifications.
Settings Tabs¶
Organization¶
Configure your organization's public identity:
- Organization Name — displayed in the admin sidebar, public pages, and emails
- Short Name — shown when the admin sidebar is collapsed (max 10 characters)
- Logo URL — displayed on the login page, homepage hero, and public navigation
- Favicon URL — browser tab icon
- Footer Text — shown in public page footers
- Login Subtitle — displayed below the organization name on the login page
Theme Colors¶
Customize the look of admin and public interfaces:
Admin theme:
- Primary color (accent color for buttons, links, active states)
- Background color (page background)
Public theme:
- Primary color
- Background color
- Container color (card and section backgrounds)
- Header gradient (CSS gradient string for the public navigation bar)
A live preview panel shows color swatches and a gradient preview as you configure.
Email¶
Configure how the platform sends emails:
- Sender — from name and from address for all outgoing emails
- Active SMTP provider — toggle between MailHog (testing) and Production SMTP with a single click
- Production SMTP — host, port, username, and password (collapsible panel, disabled when MailHog is active)
- Test mode — when enabled, all emails redirect to a single test recipient address
- Test actions — "Test Connection" verifies SMTP connectivity; "Send Test Email" delivers a test message through the active provider
A configuration summary card at the top displays the current provider, server, authentication status, and test mode state.
Feature Toggles¶
Enable or disable platform modules. Disabling a module hides it from navigation but does not delete data.
| Category | Flag | Description |
|---|---|---|
| Core Platform | enableInfluence |
Advocacy campaigns, email sending, response wall |
enableMap |
Map, locations, canvassing, volunteer shifts | |
enableNewsletter |
Listmonk newsletter sync | |
enableLandingPages |
GrapesJS landing page builder | |
| Media & Content | enableMediaFeatures |
Video library, public gallery, analytics |
enableGalleryAds |
Promotional cards in the video gallery | |
enableEvents |
Gancio event calendar integration | |
| Communication | enableChat |
Rocket.Chat team coordination |
enableMeet |
Jitsi video meetings (integrates with Rocket.Chat) | |
enableSms |
Termux Android SMS campaigns | |
| People & Engagement | enablePeople |
Unified contacts CRM |
enableSocial |
Volunteer social connections and activity feeds | |
autoSyncPeopleToMap |
Auto-create map locations from contact addresses | |
| Commerce | enablePayments |
Stripe subscriptions, products, and donations |
Notifications¶
Control which automated email notifications the platform sends. Disabling a notification stops future emails but does not affect already-queued jobs.
Admin alerts:
- New shift signup
- Response wall submission
- Yard sign request (from canvassing)
- Shift cancellation
Volunteer emails:
- Canvass session summary (sent after completing a session)
- Signup cancellation confirmation
- 24-hour pre-shift reminder
- Post-shift thank-you (sent 2 hours after shift ends)
Re-engagement:
- Re-engagement emails for inactive volunteers
- Configurable inactivity threshold (days without activity)
- Configurable cooldown period (minimum days between re-engagement emails)
Admin Routes¶
/app/settings— multi-tab settings page (supports deep-linking to a specific tab via router state)