GyanGrove

Project overview.

Project Overview

My project is a responsive web application that displays upcoming and recommended events. It seamlessly adapts to both desktop and mobile screen sizes to provide users with an optimal viewing experience.

Technologies Used:

• React JS: I chose React JS for its effectiveness in building dynamic and interactive user interfaces. With its component-based architecture, React enables me to create reusable UI components, making development more efficient.

• Material-UI: I utilized Material-UI to ensure that my web application is responsive and visually appealing across various devices and screen sizes. Material-UI provides a set of pre-designed React components with a modern and sleek design, enabling me to rapidly develop a user-friendly interface.

Key Features:

• Upcoming Events: Users can view a list of upcoming events, including details such as event name, date, location, and distance.

• Recommended Events: The application also showcases recommended events based on user preferences or other relevant criteria.

• Responsive Design: My website is designed to seamlessly adapt to different screen sizes, ensuring a consistent and enjoyable user experience on both desktop and mobile devices.

How It Works:

1. The website fetches event data from the provided APIs, ensuring that users have access to the latest information about upcoming and recommended events.

2. Using React JS, I dynamically render the fetched event data to create an intuitive and interactive user interface.

3. Material-UI components are utilized to design and structure the web application, ensuring responsiveness and modern aesthetics.

Overall, my project combines the power of React JS and Material-UI to deliver a user-friendly and visually appealing web application for discovering upcoming and recommended events.

Setup and Local Run Instructions

This project was bootstrapped with Create React App.

Installation

1. Clone the repository:

   git clone <repository-url>

2. Navigate to the project directory:

   cd <project-directory>

3. Open the project in your code editor:

   code .

4. Install dependencies:

   npm install

5. Start the development server:

   npm start

Usage

This website shows upcoming and recommended events. The website is responsive to work in both desktop and mobile screen size. It fetch events from the provided APIs.

Features

• The website work on both Desktop and Mobile browser.
• Effective fetching, usage, and display of data from a REST API.
• Recommended events support horizontal scroll.
• Upcoming events are fetched page by page.

Contributing

1. Fork the repository.
2. Create a new branch: git checkout -b feature-name.
3. Make your changes and commit them: git commit -m 'Add some feature'.
4. Push to the branch: git push origin feature-name.
5. Submit a pull request.

License

This project is licensed under the MIT License.

Acknowledgments

• @GyanGrove Assignment