Skip to content

πŸ™ A modern, responsive digital platform for Wonders of God Church, connecting our community through faith, worship, and fellowship.

Notifications You must be signed in to change notification settings

mwakidenis/Church-Event-Management-System

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

37 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

β›ͺ Wonders of God Church - Digital SanctuaryπŸ’’

React TypeScript Tailwind CSS Vite

πŸ™ A modern, responsive digital platform for Wonders of God Church, connecting our community through faith, worship, and fellowship.

🌟 Features

βœ… Current Features

  • 🏠 Homepage - Welcome visitors with inspiring content and church information
  • πŸ“– About Us - Learn about our church's mission, vision, and values
  • πŸŽ₯ Sermons & Media - Watch and download our latest messages and audio content
  • πŸ“… Events - Stay updated with upcoming church events and activities
  • 🀝 Ministries - Discover various ministry opportunities and get involved
  • πŸ’° Give - Secure online giving platform for tithes and offerings
  • πŸ“ž Contact - Get in touch with church leadership and staff
  • πŸ“š Resources - Access spiritual resources, study materials, and downloads
  • πŸ“± Responsive Design - Fully optimized for mobile, tablet, and desktop
  • 🎨 Modern UI/UX - Clean, intuitive interface with beautiful animations

πŸš€ Upcoming Features

  • πŸ” Member Portal - Secure login for church members
  • πŸ“Š Member Dashboard - Personal spiritual growth tracking
  • πŸ’¬ Prayer Requests - Submit and track prayer requests
  • πŸ“§ Newsletter Subscription - Stay connected with church updates
  • 🎡 Worship Music Library - Access to worship songs and lyrics
  • πŸ“± Mobile App - Native mobile application for iOS and Android
  • πŸ”” Push Notifications - Real-time updates for events and announcements
  • πŸ“– Bible Study Tools - Interactive Bible reading and study features
  • πŸ‘₯ Small Groups - Find and join small group communities
  • πŸŽ“ Online Classes - Virtual Bible study and discipleship courses
  • πŸ’³ Recurring Donations - Set up automatic giving schedules
  • 🌍 Multi-language Support - Swahili and English language options
  • 🎯 Event Registration - Online registration for church events
  • πŸ“Έ Photo Gallery - Church event photos and memories
  • 🎬 Live Streaming - Watch services live online
  • πŸ“Š Analytics Dashboard - Church leadership insights and statistics

πŸ› οΈ Technology Stack

Technology Purpose Version
βš›οΈ React Frontend Framework 18.3.1
πŸ”· TypeScript Type Safety 5.0+
🎨 Tailwind CSS Styling Framework 3.0+
⚑ Vite Build Tool 5.0+
🧩 Shadcn/UI Component Library Latest
πŸ” Lucide React Icon Library 0.462.0
🌐 React Router Navigation 6.26.2
πŸ”„ TanStack Query Data Fetching 5.56.2
πŸ“Š Recharts Data Visualization 2.12.7

πŸš€ Quick Start

Prerequisites

  • πŸ“¦ Node.js (version 18.0 or higher)
  • πŸ“‹ npm or yarn package manager
  • πŸ’» Git for version control

πŸ“₯ Installation

  1. Clone the repository

    git clone https://github.com/mwakidenis/Church-Event-Management-System.git
    cd wonders-of-god-church
  2. Install dependencies

    npm install
    # or
    yarn install
  3. Start development server

    npm run dev
    # or
    yarn dev
  4. Open your browser

    http://localhost:5173
    

πŸ”§ Development Scripts

Command Description Icon
npm run dev Start development server πŸš€
npm run build Build for production πŸ—οΈ
npm run preview Preview production build πŸ‘€
npm run lint Run ESLint 🧹
npm run type-check Run TypeScript checks πŸ”

πŸ”— Custom Domain Setup

  1. Navigate to Project > Settings > Domains
  2. Click Connect Domain
  3. Follow the DNS configuration instructions
  4. Verify domain ownership

πŸ“¦ Deploy to Other Platforms

Vercel πŸ”Ί

npm install -g vercel
vercel --prod

Netlify 🌐

npm run build
# Upload dist/ folder to Netlify

GitHub Pages πŸ“š

npm run build
# Push dist/ folder to gh-pages branch

πŸ“ Project Structure

src/
β”œβ”€β”€ πŸ“‚ components/          # Reusable UI components
β”‚   β”œβ”€β”€ 🧩 ui/             # Shadcn/UI components
β”‚   β”œβ”€β”€ 🧭 Navigation.tsx  # Main navigation component
β”‚   └── ...
β”œβ”€β”€ πŸ“‚ pages/              # Page components
β”‚   β”œβ”€β”€ 🏠 Index.tsx       # Homepage
β”‚   β”œβ”€β”€ πŸ“– About.tsx       # About page
β”‚   β”œβ”€β”€ πŸŽ₯ Sermons.tsx     # Sermons page
β”‚   └── ...
β”œβ”€β”€ πŸ“‚ hooks/              # Custom React hooks
β”œβ”€β”€ πŸ“‚ lib/                # Utility functions
β”œβ”€β”€ πŸ“‚ types/              # TypeScript type definitions
└── πŸ“„ App.tsx             # Main app component

🎨 Customization

🎨 Colors and Branding

Customize the church branding in tailwind.config.ts:

module.exports = {
  theme: {
    extend: {
      colors: {
        primary: '#your-primary-color',
        secondary: '#your-secondary-color',
      }
    }
  }
}

πŸ“ Content Management

Update church information in the respective page components:

  • Church name and details in Navigation.tsx
  • Service times in ServiceTimes.tsx
  • Pastor information in sermon components

🀝 Contributing

We welcome contributions from our church community! πŸ™Œ

πŸ› οΈ How to Contribute

  1. Fork the repository 🍴
  2. Create a feature branch 🌿
    git checkout -b feature/amazing-feature
  3. Commit your changes πŸ’Ύ
    git commit -m 'Add some amazing feature'
  4. Push to the branch πŸ“€
    git push origin feature/amazing-feature
  5. Open a Pull Request πŸ”„

πŸ“‹ Contribution Guidelines

  • βœ… Follow the existing code style
  • βœ… Write meaningful commit messages
  • βœ… Test your changes thoroughly
  • βœ… Update documentation as needed
  • βœ… Respect the church's values and mission

πŸ™ Prayer Requests

If you need prayer or spiritual support:

  • πŸ“§ Prayer Email: [email protected]
  • πŸ“ž Prayer Hotline: +254 XXX XXX XXX (24/7)

πŸ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • πŸ™ God Almighty - For His grace and guidance
  • β›ͺ Wonders of God Church Community - For their support and feedback
  • πŸ‘¨β€πŸ’» Development Team - For their dedication and hard work
  • 🎨 UI/UX Designers - For creating beautiful and intuitive designs
  • πŸ“š Open Source Community - For the amazing tools and libraries

πŸ“Š Project Stats

GitHub last commit GitHub issues GitHub pull requests GitHub stars


🌟 Colossians 3:23-24 (NIV)

"Whatever you do, work at it with all your heart, as working for the Lord, not for human masters, since you know that you will receive an inheritance from the Lord as a reward. It is the Lord Christ you are serving." 🌟

Made with ❀️ by Mwaki Denis and πŸ™ for the Glory of God

Buy Me a Coffee

🌐 Visit Our Website | πŸ“§ Contact Us | πŸ™ Prayer Requests

```

About

πŸ™ A modern, responsive digital platform for Wonders of God Church, connecting our community through faith, worship, and fellowship.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages