Empowering Faith Communities Worldwide
FaithSphere is a comprehensive multi-tenant SaaS platform designed for faith-based organizations of all traditions—churches, mosques, temples, spiritual centers, and African spiritual organizations. Built with modern web technologies, FaithSphere provides the tools needed to manage, connect, and grow faith communities from a single branch to global operations.
- Member Management: Complete profiles, family relations, membership status, and attendance tracking
- Multi-Tenant Architecture: Hierarchical structure supporting 7 organizational levels (International → Continental → Country → State/Province → Municipality → Branch → Location)
- Role-Based Access Control: Customizable permissions at every level with secure data isolation
- Unified Communication: Messaging and notifications across all organizational levels
- Event Management: Schedule, track, and manage events, meetings, and activities
- Insights & Reporting: Customized dashboards and analytics for data-driven decisions
- Mobile-first responsive design
- Real-time data synchronization
- Secure cloud-based infrastructure
- API-first architecture for seamless integrations
- Dark mode support
- Scalable from single branch to global operations
FaithSphere implements a sophisticated multi-tenant architecture with complete data isolation:
International
└── Continental
└── Country
└── State/Province
└── Municipality
└── Branch
└── Location
Each level has appropriate access controls and oversight capabilities while maintaining security and privacy.
- Node.js 18+
- npm, yarn, pnpm, or bun package manager
- PostgreSQL database (Neon recommended)
- Clone the repository:
git clone https://github.com/yourusername/faithsphere.git
cd faithsphere- Install dependencies:
npm install
# or
yarn install
# or
pnpm install- Set up environment variables:
cp .env.example .envEdit .env and add your configuration:
- Database connection (Neon/PostgreSQL)
- Stack Auth credentials
- Other required API keys
- Run database migrations:
npx prisma migrate dev- Start the development server:
npm run dev
# or
yarn dev
# or
pnpm devOpen http://localhost:3000 to see the application.
- Framework: Next.js 15 with App Router
- Language: TypeScript
- Styling: Tailwind CSS
- Database: Neon (PostgreSQL)
- ORM: Prisma
- Authentication: Stack Auth
- Icons: Lucide React
- Fonts: Crimson Text (serif) & Lato (sans-serif)
faithsphere/
├── app/
│ ├── (public)/ # Public landing pages
│ ├── (secured)/ # Protected dashboard pages
│ │ └── dashboard/ # Main dashboard
│ ├── handler/ # Auth handlers
│ ├── layout.tsx # Root layout
│ └── globals.css # Global styles
├── prisma/
│ └── schema.prisma # Database schema
├── stack/ # Stack Auth configuration
├── docs/ # Project documentation
└── public/ # Static assets
FaithSphere is designed to support organizations of all sizes:
- Single Branch: Perfect for individual churches or spiritual centers
- Regional: Manage multiple locations within a city or state
- National: Coordinate activities across an entire country
- International: Global oversight with continental and country-level management
- Role-based access control (RBAC) at all levels
- Data isolation between tenants
- Secure authentication with Stack Auth
- GDPR and data privacy compliant
- Regular security audits and updates
For detailed documentation, see the docs directory:
- System Architecture
- API Documentation (coming soon)
- Deployment Guide (coming soon)
We welcome contributions! Please see our contributing guidelines (coming soon).
This project is licensed under the MIT License - see the LICENSE file for details.
FaithSphere welcomes all faith traditions:
- Christianity (all denominations)
- Islam
- Hinduism
- Buddhism
- Judaism
- African spiritual traditions
- Indigenous faiths
- And more
Our platform adapts to your unique needs while respecting your sacred practices.
For support, email support@faithsphere.com or join our community Discord.
The easiest way to deploy FaithSphere is using Vercel:
For detailed deployment instructions, see our deployment documentation.
Built with ❤️ for faith communities worldwide