An open API service indexing awesome lists of open source software.

https://github.com/pintu544/catalogviewers

Implement a catalog viewer for a collection of images. Frontend Tech: React, Typescript, Material UI
https://github.com/pintu544/catalogviewers

material-ui react typescript

Last synced: about 2 months ago
JSON representation

Implement a catalog viewer for a collection of images. Frontend Tech: React, Typescript, Material UI

Awesome Lists containing this project

README

        

Catalog Viewer


Hosted Urlcatalogviewers


catalog

This is a React app that displays a collection of images in a carousel format. The user can navigate between images using previous and next buttons or by clicking on a thumbnail image. There is also a play/pause button that starts or stops the automatic display of images in the carousel.


Technologies Used



  • React - A JavaScript library for building user interfaces.

  • Typescript - A statically typed superset of JavaScript that adds type annotations to the language.

  • Material UI - A popular React UI framework that provides pre-built components and styles.


Getting Started


To run this app on your local machine, follow these steps:



  1. Clone the repository to your local machine using git clone https://github.com/pintu544/CatalogViewers.git.

  2. Navigate to the project directory using cd catalogviewer.

  3. Install the necessary dependencies using npm install.

  4. Run the app in development mode using npm start.

  5. Open http://localhost:3000 to view it in the browser.


Usage


When you open the app, it will display the first image in the collection along with its title and description on the right side of the screen. You can navigate between images using the previous and next buttons underneath the image, or by clicking on a thumbnail image below the main image.


If you click on the next button when the last image is showing, it will cycle back to the first image. Similarly, if you click on the previous button when the first image is showing, it will cycle back to the last image.


There is also a play/pause button that alternately starts and stops the automatic display of images in the carousel. When the slideshow is active, images are displayed for a 3 second interval before automatically switching to the next image. If you click on any carousel indicator or the previous or next button while the slideshow is active, it will load the appropriate image and continue the slideshow from that image.


When you click on a thumbnail image, it will display that image along with its title and description on the right side of the screen. The currently selected thumbnail image will be highlighted, and others will be shown in grayscale.


Contributing


If you would like to contribute to this project, please follow these steps:



  1. Fork the repository to your own GitHub account.

  2. Clone the repository to your local machine using git clone https://github.com/pintu544/CatalogViewers.git.

  3. Create a new branch using git checkout -b feature/your-feature-name.

  4. Make your changes and commit them using git commit -m "Your commit message".

  5. Push your changes to your forked repository using git push origin feature/your-feature-name.

  6. Create a Pull Request to merge your changes into the main branch of the original repository.


License


This project is licensed under the MIT License - see the LICENSE.md file for details.


Acknowledgements



  • Images used in this app are sourced from Unsplash.


#� �C�a�t�a�l�o�g�V�i�e�w�e�r�