EventSphere is a modern, comprehensive event management platform designed to streamline the experience for both event organizers and participants. It provides a seamless interface for creating, managing, and browsing events, backed by a robust and secure infrastructure.
🚀 Live Demo: eventsphere-ochre.vercel.app
- Dashboard: A centralized hub to view and manage all your events.
- Event Creation: Easy-to-use forms for creating new events with details like date, time, location, and description.
- Management: Edit or delete existing events with ease.
- Real-time Updates: Changes are instantly reflected across the platform.
- Event Browsing: Discover events tailored to your interests.
- Registration: Simple and quick registration process for events.
- Dashboard: View your registered events and upcoming schedule.
- Authentication: Secure login and signup powered by Firebase Authentication.
- Role-Based Access: Distinct features and views for Organizers and Participants.
- Responsive Design: Optimized for all devices using Tailwind CSS.
- Frontend: React (v18), TypeScript
- Build Tool: Vite
- Styling: Tailwind CSS
- Backend / Database: Firebase (Auth, Firestore)
- Routing: React Router (v7)
Follow these steps to set up the project locally on your machine.
- Node.js (v18 or higher)
- npm or yarn
-
Clone the repository
git clone https://github.com/your-username/eventsphere.git cd eventsphere -
Install dependencies
npm install
-
Configure Environment Variables Create a
.envfile in the root directory and add your Firebase configuration: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_messaging_sender_id VITE_FIREBASE_APP_ID=your_app_id
-
Run the development server
npm run dev
Open http://localhost:5173 to view it in the browser.
npm run dev: Starts the development server.npm run build: Builds the app for production.npm run preview: Preview the production build locally.npm run lint: Run linting checks (if configured).
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the project
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
Built with ❤️ by [Your Name]