{"id":18794364,"url":"https://github.com/agnii555/eventshare","last_synced_at":"2026-04-01T19:18:11.529Z","repository":{"id":214442288,"uuid":"736165972","full_name":"Agnii555/eventshare","owner":"Agnii555","description":"EventShare is a web application designed to streamline event management and discovery within Northeastern University. This platform allows users to explore, share, and engage with various events on campus.","archived":false,"fork":false,"pushed_at":"2023-12-28T07:37:42.000Z","size":92167,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-03-28T00:43:09.628Z","etag":null,"topics":["api","css","express","google-maps-api","html","javascript","material-ui","mongodb","nextjs","nodejs","reactjs","redux","rest-api"],"latest_commit_sha":null,"homepage":"https://event-share.netlify.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Agnii555.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-12-27T06:50:59.000Z","updated_at":"2023-12-28T07:34:26.000Z","dependencies_parsed_at":"2023-12-28T08:40:27.633Z","dependency_job_id":null,"html_url":"https://github.com/Agnii555/eventshare","commit_stats":null,"previous_names":["agnii555/eventshare"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Agnii555/eventshare","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agnii555%2Feventshare","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agnii555%2Feventshare/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agnii555%2Feventshare/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agnii555%2Feventshare/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Agnii555","download_url":"https://codeload.github.com/Agnii555/eventshare/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Agnii555%2Feventshare/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291117,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","css","express","google-maps-api","html","javascript","material-ui","mongodb","nextjs","nodejs","reactjs","redux","rest-api"],"created_at":"2024-11-07T21:29:16.941Z","updated_at":"2026-04-01T19:18:11.507Z","avatar_url":"https://github.com/Agnii555.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# EventShare Web App\n\nEventShare is a web application designed to streamline event management and discovery within Northeastern University. This platform allows users to explore, share, and engage with various events on campus. Whether you're a student, faculty member, or staff, EventShare has features tailored to enhance your event experience.\n## Features\n### User Features\n#### 1 View All Events\nSearch and view through a comprehensive list of all upcoming events at Northeastern University.\n#### 2 View on Maps\nVisualize event locations on an interactive map for better navigation.\n#### 3 Share Event\nEasily share events with friends and colleagues through various social media platforms or email.\n#### 4 Buy Tickets\nPurchase tickets for events directly through the app for a seamless experience.\n#### 5 Rate Events\nProvide feedback on events by rating them, contributing to a dynamic and user-driven event community.\n#### 6 Add to Favorites\nSave your favorite events for quick access and personalized event recommendations.\n\n## Admin Features\n### CRUD Operations\n#### Perform Create, Read, Update, and Delete operations for events to manage and curate the event calendar.\n\n### Admin Screen\nAdmin wil be able to manage the events (CRUD operation)\n\n- **Create Event:**\n  Admin has the rights to create a new event and enter the details of the event\n\n- **View Event:**\n  Admin can view the event and see its details\n\n- **Update Event:**\n  Admin can update an event to change any specific details related to an event, like change in time, location, date, etc.\n\n- **Delete Event:**\n  Admin can delete an event if a event has been cancelled or it no longer exists.\n\n\n## Technical Features\n### 1) Internationalization (i18n)\nSupport for English and French languages to cater to a diverse user base.\n### 2) Redux Integration\nUtilize Redux for state management, ensuring a scalable and maintainable application architecture.\n### 3) Progressive Web App (PWA)\nEnjoy a responsive and reliable experience with PWA capabilities, allowing users to access the app even when offline.\n### 4) Responsive Design\nA user-friendly interface that adapts seamlessly to various screen sizes and devices.\n### 5) Secure Access\nAccessible only by Northeastern University credentials, ensuring the safety and privacy of user data.\n### 6) React Router DOM and Page Not Found\nEventShare uses react-router-dom for client-side routing. If a user navigates to a non-existent route, they will be redirected to a \"Page Not Found\" component. The routing configuration can be found in the src/App.js file.\n\n# Getting Started\n\n```\ngit clone https://github.com/your-username/eventshare.git\n\n```\n# Install dependencies:\n\n```\ncd eventshare\nnpm install\n\n```\n# Configure environment variables:\n\n## Set up environment variables for authentication and other sensitive information.\n```\nnpm start\n\n```\n## Open your browser and navigate to http://localhost:3000 to access EventShare locally.\n\n\n## Scheme for Event Table\nEvent_Name (String, required)     : Name of the event.\n\nTarget_Audience (String, required): Type of Audience.\n\nDate (String, required)           : Date of the event (YYYY-MM-DD).\n\nEvent_Start_Time (String)         : Start Time of the event (HH:mm).\n\nEvent_End_Time (String)           : End Time of the event (HH:mm).\n\nLocation (String)                 : Location where the event will take place.\n\nDescription (String)              : Description about the event\n\nCategory (String)                 : Event Category\n\nOrganizer (String)                : Event Organizers\n\nEvent_Link (String)               : Registration Link\n\nPrice (string)                    : Event ticket Price\n\n## Structure\nThe project is structured into the following layers:\n\nController Layer: Handles incoming HTTP requests, processes them, and returns appropriate responses. Controllers are responsible for routing and request handling.\n\nService Layer: Contains business logic and acts as an intermediary between the controllers and the models. It handles the core functionality of the application, such as processing data and interacting with the database.\n\nModels Layer: Defines the data structure and schema for events. In this case, the Event model consists of fields like EventName, Target_Audience, Date, Event_startTime, Event_endTime, and location.\n\n\n## API Endpoints\nThe API provides the following endpoints to interact with events:\n\nGET /events: Retrieve a list of all events.\n\nGET /events/:id: Retrieve details of a specific event.\n\nPOST /events: Create a new event.\n\nPUT /events/:id: Update details of a specific event.\n\nDELETE /events/:id: Delete a specific event.\n\n\n## API Examples\n#### 1. Get All Events\nEndpoint: GET /events\n\nDescription: Get a list of all events in the university\n\nResponse: (example in json format)\n\n          [\n            {\n              \"EventName\": \"Example Event\",\n              \"Targer_audience\": \"UnderGrad Students\",\n              \"Location\": \"MaEll Hall Auditorium\",\n              \"Date\": \"2023-12-01\",\n              \"Start_Time\": \"18:00\"\n              \"End_Time\": \"18:00\"\n            },\n            // ... other events\n          ]\n\n#### 2. Get Event by ID\nEndpoint: GET /events/:id\n\nDescription: Get details of a specific event by its ID.\n\nResponse: (example in json format)\n\n            {\n              \"EventName\": \"Diwali Celebration\",\n              \"Targer_audience\": \"All\",\n              \"Location\": \"Ell Hall Auditorium\",\n              \"Date\": \"2023-12-01\",\n              \"Start_Time\": \"15:00\"\n              \"End_Time\": \"20:00\"\n            },\n\n#### 3. Create New Event\nEndpoint: POST /events\n\nDescription: Create a new event.\n\nRequest: (example in json format)\n\n          {\n              \"EventName\": \"Thanks Giving\",\n              \"Targer_audience\": \"All\",\n              \"Location\": \"Curry Centre\",\n              \"Date\": \"2023-12-01\",\n              \"Start_Time\": \"17:00\"\n              \"End_Time\": \"20:00\"\n            },\n\n#### 4. Update Event\nEndpoint: PUT /events/:id\n\nDescription: Update details of a specific event by its ID.\n\nRequest: (example in json format)\n\n          {\n              \"EventName\": \"Thanks Giving\",\n              \"Targer_audience\": \"All\",\n              \"Location\": \"Snell Engg.\",\n              \"Date\": \"2023-12-01\",\n              \"Start_Time\": \"17:00\"\n              \"End_Time\": \"20:00\"\n            },\n\n#### 5. Delete Event\nEndpoint: DELETE /events/:id\n\nDescription: Delete a specific event by its ID.\n\nResponse:\n\n          {\n            \"message\": \"Event deleted successfully.\"\n          }\n\n\n\n\n\n## Object Model Diagram\n\n![Alt Assignment 8 page design](/images/ObjectModelDiagram.png)\n\n### Google Maps Integration:\n\nThe website leverages the Google Maps API to provide a dynamic map view for users.\nReal-time location tracking allows users to visualize event venues, enhancing their understanding of event locations.\n\n\n### User-Friendly Interface:\n\nUser-friendly design for the frontend, ensuring a positive experience for Users.\nEvents are presented in an organized manner, allowing Users to quickly find relevant information.\n\n### Real-Time Location Tracking:\n\nIntegration of Google Maps API for dynamic event location representation.\nUsers can track event locations in real-time, enhancing their ability to attend events with ease.\n\n## Technical Stack:\n\n### Backend: \n\nNode.js (Express), MongoDB for database storage.\n\n### Frontend: \n\nNext.js for dynamic and HTML, SCSS, Javascript for responsive UI.\n\n### Maps Integration: \n\nGoogle Maps API for real-time location tracking.\n\n### Authentication: \n\nSecure login system for Admin and User access using Northeastern credentials.\n\n## Login Credentials:\n\n### Admin Login\n- Username: admin@northeastern.edu\n- Password: admin\n\n### User Login\n- Username: user@northeastern.edu\n- Password: user\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagnii555%2Feventshare","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fagnii555%2Feventshare","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fagnii555%2Feventshare/lists"}