Skip to content

PicLens is an immersive photo gallery website where users can explore stunning images across various categories using the Unsplash API.

License

Notifications You must be signed in to change notification settings

Abdur-Rahman-Apu/PicLens

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

πŸ“Έ PicLens - Photo Gallery Website

Website JavaScript HTML CSS Unsplash API Netlify Status Responsive Star

Welcome to PicLens - an immersive photo gallery website where users can explore stunning images across various categories using the Unsplash API. 🌟

🌐 Live Demo

Check out the live demo of PicLens here πŸš€.

πŸš€ Features

  • πŸ” Category-Based Photo Selection: Users can search 9 categories photos: Animals, Nature, Experimental, Technology, Food, Travel, Rising Stars, and Films.
  • πŸ”„ Dynamic Photo Fetching: Photos are fetched dynamically from the Unsplash API.
  • πŸ–ΌοΈ Paginated Gallery: Each page displays 12 photos, and users can navigate up to five pages.
  • πŸ” Search Functionality: Users can search for any photo using relevant keywords.
  • πŸ’» Fully Responsive: The gallery adapts to different screen sizes for a flawless experience across devices.

πŸ“· Categories Available

Category Description
Animals Photos of animals in their natural habitat
Nature Stunning landscapes and natural elements
Experimental Creative and unique experimental photography
Technology Images of technology, gadgets, and more
Food Mouthwatering shots of food and beverages
Travel Explore the beauty of the world through travel photography
Rising Stars Featuring the work of rising photography stars
Films Cinematic shots and film photography

πŸ› οΈ Technologies Used

  • HTML5: For the structure of the web pages.
  • CSS3: For styling and making the website responsive.
  • JavaScript: For dynamic content and API integration.
  • Unsplash API: To fetch high-quality photos for the gallery.

πŸ“‚ Project Structure

πŸ“ PicLens
└── πŸ“ assets
   └── πŸ“ JS
      └── πŸ“ modules
         └── πŸ“ ajax          # API request
         └── πŸ“ config        # Configuration
         └── πŸ“ db            # Storage
         └── πŸ“ elements      # HTML elements
         └── πŸ“ handlers      # Event Handlers
         └── πŸ“ init          # Initial function
         └── πŸ“ listeners     # Event listeners
         └── πŸ“ photo         # Photo related
         └── πŸ“ ui            # DOM update
         └── πŸ“ utilities     # Utility functions
      β”œβ”€β”€ πŸ“„ app.js           # Main js file
└── πŸ“ Styles                 # css files
└── πŸ“„ index.html             # HTML file

πŸ–ΌοΈ Screenshots

Here are a few snapshots of PicLens in action:

πŸ–₯️ Desktop View

Desktop View

πŸ“± Mobile View

Mobile View

πŸ“ Setup Instructions

To run this project locally, follow these steps:

  1. Clone the repository:

    git clone https://github.com/Abdur-Rahman-Apu/PicLens.git
  2. Navigate to the project folder:

    cd PicLens
  3. Open index.html in your browser to view the gallery.

🎯 Project Overview

  • Project Name: PicLens
  • Version: 1.0
  • Languages: HTML, CSS, JavaScript
  • API: Unsplash API
  • Features: Photo search, category-based photo fetch, pagination, and responsive design.

πŸ™ Acknowledgements

A big thank you to the amazing community at Unsplash for providing high-quality images via their API and to MDN Web Docs for excellent documentation on HTML, CSS, and JavaScript.

⭐ Request for Star

If you find this project useful, please consider giving it a ⭐ on GitHub! Your support will encourage me to continue improving the project and developing more exciting web applications.

Star

πŸ›‘οΈ License

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


🌍 Connect with Me

LinkedIn GitHub


About

PicLens is an immersive photo gallery website where users can explore stunning images across various categories using the Unsplash API.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published