Documentation Index

Fetch the complete documentation index at: https://docs.thefaithapp.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Settings, Branding, and App Customization

This guide covers the settings and customization areas used to manage church details, public branding, technical app setup, and the mobile app experience in TheFaithApp. These tools include:

• Church profile
• Social media links
• Email settings
• Developer tools and Firebase setup
• White-label branding
• Custom domains
• Custom branding for public pages
• Brand & theme
• Navigation builder
• Page builder
• Component library
• Customization releases

​

Before You Start

• Sign in to your admin account.
• Open Settings for church profile, social media, email, developer tools, and branding.
• Open App Customization for brand theme, navigation, custom pages, reusable components, and releases.
• Some setup steps, especially SMTP and Firebase, may require help from your technical team or provider.

​

Church Profile

Use church profile settings to keep your church identity, contact details, and general organization information up to date.

​

What You Can Do

• Update the church name
• Update the main church email address
• Update location and website details
• Choose the correct timezone
• Update the church description
• Upload or replace the church logo

​

Steps

1. Open Settings.
2. Stay on Church Profile.
3. Update the church information you want to change.
4. Upload a new logo if needed.
5. Click Save Changes.

​

Notes

• Keep this page current because the same church details can appear across other parts of the platform.

​

Social Media

Use social media settings to share your public church links with members and visitors.

​

What You Can Do

• Add or update Facebook
• Add or update Instagram
• Add or update X
• Add or update YouTube
• Add or update TikTok

​

Steps

1. Open Settings.
2. Click Social Media.
3. Paste the links you want to publish.
4. Click Save Changes.

​

Notes

• Use full public profile links so members are sent to the right page.

​

Email Settings

Use email settings to control the sending address and delivery provider used for church emails.

​

What You Can Do

• Enter the SMTP host
• Set the port and encryption method
• Add the email username and password
• Set the sending email address
• Set the sender name
• Adjust the timeout when needed

​

Steps

1. Open Settings.
2. Click Email Settings.
3. Enter the SMTP details from your email provider.
4. Set the From Email Address and From Name.
5. Click Save Configuration.

​

Notes

• This page is usually completed with details supplied by your email provider or technical team.

​

Developer Tools and Firebase Setup

Use developer tools when setting up the mobile app connection, Firebase notifications, and public-page authentication support.

​

What You Can Do

• Upload the Firebase service account file
• Configure Firebase Web SDK values
• Review whether setup steps are complete
• Test the Firebase connection
• Copy or revoke the generated API key

​

Steps

1. Open Settings.
2. Click Developer Tools.
3. Complete Step 1 by uploading the Firebase service account JSON file.
4. Complete Step 2 by entering the Firebase Web SDK details.
5. Review Step 3 after the earlier setup steps are complete.
6. Use Test Connection, Copy Key, or Revoke Key when needed.

​

Notes

• This area is usually handled together with a technical owner.
• Keep Firebase credentials and API access details private.

​

White-Label Branding and Domains

Use white-label branding to replace default app branding with your church identity and connect a public domain.

​

What You Can Do

• Turn white-label branding on or off
• Review the branding preview
• Add a custom domain
• Remove a domain when it is no longer needed

​

Steps

1. Open Settings.
2. Click Branding.
3. Stay on White-Label Branding.
4. Turn white-label branding on when you are ready to show your own identity.
5. Review the preview area.
6. Click Add Domain when you want the app served from your own church URL.

​

Notes

• The page currently supports one custom domain per account.
• Domain setup may still require DNS or provider-side work outside TheFaithApp.

​

Custom Branding by Page

Use custom branding when you want specific public pages to have their own colors and visual styling.

​

What You Can Do

• Choose a page type to customize
• Change the page color palette
• Add custom CSS
• Preview the public page look
• Copy branding from another page type
• Turn custom branding on or off

​

Available Page Types

• Donations page
• Devotionals
• Outreach campaigns

​

Steps

1. Open Settings.
2. Click Branding.
3. Open the Custom Branding tab.
4. Choose the page type you want to style.
5. Update colors or custom CSS.
6. Use Preview to review the result.
7. Click Save Changes.

​

Notes

• This section affects public pages, not the main admin dashboard.
• Each supported page type can have its own visual treatment.

​

Brand and Theme

Use Brand & Theme to control the global design language for the app customization workspace.

​

What You Can Do

• Set the global color palette
• Choose the main typography style
• Adjust the default corner radius
• Choose the interface theme behavior
• Save a draft
• Restore the default design settings
• Preview the published app structure

​

Steps

1. Open App Customization.
2. Click Brand & Theme.
3. Update the colors, typography, radius, or theme settings.
4. Click Save Draft.
5. Use the preview panel to review how the current design feels.
6. Publish when you are ready for the design to become part of the next release.

​

Notes

• These settings act as the shared visual base for navigation, custom pages, and reusable components.

​

Navigation Builder

Use the navigation builder to control the app tabs members can see and where each tab should go.

​

What You Can Do

• Rename navigation items
• Change navigation icons
• Reorder items
• Point items to system pages or custom pages
• Hide or show individual items
• Save a draft navigation setup
• Publish navigation changes

​

Steps

1. Open App Customization.
2. Click Navigation.
3. Select the item you want to edit.
4. Update its label, icon, target, or visibility.
5. Reorder items when needed.
6. Click Save Draft.
7. Click Publish Navigation when you are ready to use the updated structure.

​

Notes

• Published navigation is used by other app customization previews.

​

Page Builder

Use the page builder to create and update custom mobile app pages.

​

What You Can Do

• Create or select a custom page
• Add text, images, cards, buttons, spacers, dividers, sections, and reusable components
• Edit page details and route information
• Inspect and update individual blocks
• Upload an app bar logo for the page
• Save draft changes
• Publish a page
• Duplicate or delete a page

​

Steps

1. Open App Customization.
2. Click Page Builder.
3. Select the page you want to edit.
4. Add or update blocks in the canvas.
5. Use the right-side inspector to change content and styling.
6. Click Save Draft.
7. Click Publish when the page is ready.

​

Notes

• Published reusable components can be inserted into custom pages from this builder.
• Use the preview mode to check the page before publishing.

​

Component Library

Use the component library to create reusable content blocks that can be placed in custom pages later.

​

What You Can Do

• Create reusable carousels
• Use manual content or a data source
• Review published components
• Open and configure existing components
• Publish reusable components for page-builder use

​

Steps

1. Open App Customization.
2. Click Component Library.
3. Review the existing components or click Add a component.
4. Choose a template or data source.
5. Configure the component content and behavior.
6. Save and publish the component.

​

Notes

• Reusable components help keep shared layouts consistent across custom pages.

​

Customization Releases

Use releases to decide when published customization changes should become the live app experience.

​

What You Can Do

• Review recent release history
• See which release is live
• Turn Use custom design on or off
• Publish a new release

​

Steps

1. Open App Customization.
2. Click the Releases button in the top bar.
3. Review the recent release list.
4. Turn Use custom design on when you want the app to use your released customization.
5. Click Publish a release when the currently published design, navigation, pages, and components are ready to go live.

​

Notes

• A release is a snapshot of the customization that has already been published inside the editor.
• Releases help your team control when customization changes reach the live app.

​

Current Product Notes

• Settings > Branding controls white-label and public-page branding, while App Customization controls the mobile app design workspace.
• Saving or publishing inside Brand & Theme, Navigation, Page Builder, or Component Library prepares customization content, but the live mobile app reads the latest release from the Releases dialog when Use custom design is turned on.