Skip to content

# 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)