Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ritwickrajmakhal/eventure
Event Management System
https://github.com/ritwickrajmakhal/eventure
ems nextjs
Last synced: 8 days ago
JSON representation
Event Management System
- Host: GitHub
- URL: https://github.com/ritwickrajmakhal/eventure
- Owner: ritwickrajmakhal
- Created: 2024-07-23T23:46:24.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-11-07T10:26:11.000Z (8 days ago)
- Last Synced: 2024-11-07T11:29:18.481Z (8 days ago)
- Topics: ems, nextjs
- Language: JavaScript
- Homepage: https://eventure-ten.vercel.app
- Size: 30.4 MB
- Stars: 3
- Watchers: 1
- Forks: 5
- Open Issues: 15
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# EVENTURE
[](https://eventure-ten.vercel.app/)
## Table of Contents
- [EVENTURE](#eventure)
- [Table of Contents](#table-of-contents)
- [Overview](#overview)
- [Features](#features)
- [Tech Stack](#tech-stack)
- [Installation](#installation)
- [Prerequisites](#prerequisites)
- [Step-by-step Guide](#step-by-step-guide)
- [Environment Variables](#environment-variables)
- [Usage](#usage)
- [Production Build](#production-build)
- [Current Contributors](#current-contributors)
- [Contributing ](#contributing-)
- [Questions?](#questions)
## Overview
EVENTURE simplifies event creation, registration, and management by offering an intuitive web interface with integration of multiple third-party services like GitHub, Google, and Azure Bot Service. It's designed to scale for both small and large events, allowing for easy event discovery and user interaction.
## Features
- **User Authentication:** Supports OAuth authentication with GitHub and Google.
- **Event Management:** Organize, manage, and participate in events seamlessly.
- **API Integration:** Fetch event data from Strapi API for dynamic updates.
- **Chatbot Integration:** Integrated with Azure Bot Service for enhanced user support.
- **Developer Friendly:** Easily customizable with clear documentation and environment configurations.
## Tech Stack
- **Frontend:** Next.js (React Framework)
- **Backend:** Strapi CMS
- **Deployment:** Vercel
- **Bot Service:** Azure Bot Service
- **Version Control:** GitHub
- **APIs:** Google Gemini API
## Installation
To get a local copy of this project up and running, follow these simple steps:
### Prerequisites
- [Node.js](https://nodejs.org/) (v14+)
- [npm](https://www.npmjs.com/) (v6+)
### Step-by-step Guide
1. **Clone the repository**
```bash
git clone https://github.com/ritwickrajmakhal/eventure.git
cd eventure
```
2. **Install the dependencies**
Ensure that all dependencies required for the project are installed by running the following command in the project directory:
```bash
npm install
```
3. **Set up environment variables**
Create a `.env.local` file in the root directory of the project and add the following environment variables:
```bash
NEXT_PUBLIC_CHATBOT_SECRET_KEY=your_chatbot_api_key_from_azure_bot_service
NEXT_PUBLIC_API_URL=http://localhost:1337
API_URL=http://localhost:1337
NEXT_PUBLIC_BACKEND_URL=http://localhost:1337
NEXT_PUBLIC_GEMINI_API_KEY=your_gemini_api_key
```
- Replace `your_chatbot_api_key_from_azure_bot_service`, `your_gemini_api_key`, and other values with the appropriate credentials for your services.
4. **Start the development server**
After setting up your environment variables, start the development server with the following command:
```bash
npm run dev
```
This command will run the project on `http://localhost:3000/`.
## Environment Variables
| Variable Name | Description |
| ------------------------------ | -------------------------------------------------------------- |
| NEXT_PUBLIC_CHATBOT_SECRET_KEY | API key for the Azure chatbot service |
| NEXT_PUBLIC_API_URL | URL for the Strapi API |
| API_URL | URL for the Strapi API |
| NEXT_PUBLIC_BACKEND_URL | URL for the Strapi backend |
| NEXT_PUBLIC_GEMINI_API_KEY | API key for the Google Gemini API |
Make sure that your `.env.local` file is never pushed to version control, as it contains sensitive information.
## Usage
Once you have the development server running, navigate to `http://localhost:3000/` to start using the application.
### Production Build
To build and start the app in production mode, use the following commands:
1. Build the application:
```bash
npm run build
```
2. Start the application in production mode:
```bash
npm run start
```
## Current Contributors
Made with [contributors-img](https://contributors-img.web.app).
We welcome contributions from the community. To contribute:
1. Fork the repository.
2. Create a new branch (`git checkout -b feature/new-feature`).
3. Make your changes and commit them (`git commit -m "Added new feature"`).
4. Push to the branch (`git push origin feature/new-feature`).
5. Open a Pull Request.
## Questions?
If you have any questions or run into any issues, feel free to open an issue or reach out to the contributors!