Skip to content

salimdotpy/infotel9ja

Repository files navigation

🏆 Osun State Influential Personalities and Football Diehard Fans Contest

by InfoTel9ja Global Network

A web-based contest platform designed to identify, celebrate, and reward the most influential personalities and diehard football fans in Osun State, Nigeria.
The project promotes community engagement, digital participation, and social recognition through a modern, mobile-friendly interface.


🌐 Live Demo

Deployed on Vercel
🔗 https://infotel9ja.vercel.app


🚀 Features

  • 🗳️ Online Voting System – Users can nominate and vote for their favorite personalities or fans.
  • 🧑‍🤝‍🧑 Community Interaction – Encourages social participation and engagement across Osun State.
  • 🔥 Real-time Updates – Powered by Firebase for dynamic data sync and instant results.
  • 🎨 Modern UI/UX – Styled with Material Tailwind and enhanced with animations via AOS.
  • 🧭 Smooth Navigation – Built using React Router for seamless page transitions.
  • ☁️ Deployed on Vercel – Optimized for speed, scalability, and reliability.
  • 🔐 Secure Authentication – Firebase Authentication and bcrypt for secure user management.
  • 🧾 Rich Text Support – Integrated React Simple WYSIWYG editor for dynamic content creation.
  • 🧠 State Management – Managed globally with Zustand and React Hooks.

🧩 Tech Stack

Category Technology
Frontend Framework Next.js (React + Vite)
Styling Material Tailwind, Tailwind CSS
State Management Zustand
Form Handling React Hook Form + Yup
Backend & Auth Firebase, Firebase Admin, Firebase Functions
API Requests Axios
Routing React Router DOM
Animations AOS (Animate On Scroll)
Icons Heroicons, React Icons
Notifications React Toastify
Deployment Vercel

⚙️ Installation & Setup

  1. Clone the Repository
git clone https://github.com/<your-username>/infotel9ja.git
cd infotel9ja
  1. Install Dependencies

    npm install # or
    yarn install
  2. Configure Firebase Create a Firebase Project and add your configuration in an .env file:

     VITE_FIREBASE_API_KEY=your_api_key
     VITE_FIREBASE_AUTH_DOMAIN=your_auth_domain
     VITE_FIREBASE_PROJECT_ID=your_project_id
     VITE_FIREBASE_STORAGE_BUCKET=your_storage_bucket
     VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
     VITE_FIREBASE_APP_ID=your_app_id
  3. Start Development Server

    npm run dev

    The app will run at http://localhost:5173

  4. Deploy to Vercel

    • Push your code to GitHub or GitLab.
    • Go to https://vercel.com
    • Import the project → select the repo → configure environment variables.
    • Deploy and enjoy 🚀

📦 Dependencies

"@heroicons/react": "^2.2.0",
"@hookform/resolvers": "^4.1.3",
"@material-tailwind/react": "^2.1.10",
"@tailwindcss/vite": "^4.0.8",
"aos": "^2.3.4",
"axios": "^1.7.9",
"bcryptjs": "^3.0.2",
"dayjs": "^1.11.13",
"firebase": "^11.4.0",
"firebase-admin": "^13.4.0",
"firebase-functions": "^6.3.2",
"react": "^19.0.0",
"react-dom": "^19.0.0",
"react-icons": "^5.5.0",
"react-router-dom": "^7.2.0",
"react-simple-wysiwyg": "^3.2.2",
"react-slick": "^0.30.3",
"react-toastify": "^11.0.5",
"slick-carousel": "^1.8.1",
"usehooks-ts": "^3.1.1",
"yup": "^1.6.1",
"zustand": "^5.0.4"

🏁 Contest Objective

To identify and reward the most influential personalities and football diehard fans in Osun State, while promoting community engagement, participation, and social interaction through a digital contest platform.


🤝 Contributing

Contributions, suggestions, and improvements are welcome! Feel free to open an issue or submit a pull request.


👨‍💻 Author

About

InfoTel9ja Global Network, Osun State Influential Personalities and Football Diehard Fans Contest

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages