🎓 College-Event-Manager

Transforming Events, Empowering Connections Instantly

---

🛠 Built With

• JavaScript
• React Native
• Expo
• npm
• JSON

---

📚 Table of Contents

• Overview

• Getting Started

  • Prerequisites
  • Installation

• Usage

• Testing

---

📖 Overview

College-Event-Manager is a versatile, open-source framework built with React Native and Expo, designed to facilitate seamless event management across web, iOS, and Android platforms.

Its modular architecture and reusable components enable rapid development of feature-rich, user-friendly applications for managing college events efficiently.

❓ Why College-Event-Manager?

This project simplifies multi-platform development while offering robust tools for handling users, events, and data.

Core features include:

• 🧩 Modular Architecture – Centralized contexts and reusable components for scalable development
• 🚀 Cross-Platform Deployment – Runs smoothly on web, iOS, and Android using Expo
• 🛠 Utility Functions – Validation and date utilities for consistent data handling
• 🎨 Rich UI Components – Event cards, badges, filters, and empty states
• 🔗 Backend Integration Ready – Designed for easy service and API integration
• 🧭 Intuitive Navigation – Structured routing for smooth user experience

---

🚀 Getting Started

✅ Prerequisites

Make sure you have the following installed:

• Programming Language: JavaScript
• Package Manager: npm

---

📦 Installation

Follow these steps to set up the project locally:

1. Clone the repository

   git clone https://github.com/ST4RKJR/College-Event-Manager

2. Navigate to the project directory

   cd College-Event-Manager

3. Install dependencies

   npm install

---

▶ Usage

Run the project using:

npm start

This will start the Expo development server.

---

🧪 Testing

Run the test suite with:

npm test

---

⬆️ Return