Skip to content

A simple Image search app with uses the unsplash api.

Notifications You must be signed in to change notification settings

Aditya2361/Image-Search

Folders and files

NameName
Last commit message
Last commit date

Latest commit

author
Aditya Mehta
Aug 7, 2025
1df3b67 · · Aug 7, 2025

History

3 Commits
Aug 7, 2025
Aug 7, 2025
Aug 7, 2025
Aug 7, 2025
Aug 7, 2025

Repository files navigation

Image Search Engine

A modern, responsive web-based image search engine that uses the Unsplash API to search and display high-quality images with multiple viewing options.

Features

  • Advanced Search: Search for images using keywords with real-time results
  • Dual View Modes: Switch between Grid View and List View for different browsing experiences
  • Infinite Scroll: Load more results with "Show more" button
  • Image Attribution: Automatic photographer attribution with links to Unsplash profiles
  • Responsive Design: Optimized for desktop, tablet, and mobile devices
  • Modern UI: Clean, dark-themed interface with smooth animations
  • API Integration: Secure proxy server for Unsplash API calls

Tech Stack

  • Frontend: HTML5, CSS3, JavaScript (ES6+)
  • API: Unsplash REST API
  • Backend: Node.js proxy server for secure API calls
  • Styling: Custom CSS with responsive design
  • Deployment: Vercel/Node.js compatible

Files Structure

├── index.html          # Main application structure
├── styles.css          # Responsive styling with dark theme
├── script.js           # Search functionality and view controls
├── api/
│   └── proxy.js        # Secure Unsplash API proxy server
└── README.md           # Project documentation
tion

API Configuration

The application uses a secure proxy server (api/proxy.js) to handle Unsplash API requests. To configure:

  1. Get your Unsplash API key from Unsplash Developers
  2. Set environment variable: API_KEY=your_unsplash_api_key
  3. The proxy automatically handles rate limiting and secure API calls

Usage

  1. Search Images: Enter keywords in the search box and click "Search"
  2. View Modes: Toggle between Grid View (3 columns) and List View (single column)
  3. Load More: Click "Show more" to load additional images
  4. Image Details: Click any image to view it on Unsplash with photographer attribution

Responsive Design

  • Desktop: 3-column grid view or detailed list view
  • Tablet: 2-column grid view optimized for medium screens
  • Mobile: Single column layout with touch-friendly controls

Browser Support

  • Chrome (latest)
  • Firefox (latest)
  • Safari (latest)
  • Edge (latest)

Local Development

  1. Clone the repository
  2. Install dependencies: npm install (if using Node.js server)
  3. Set up environment variables:
    export API_KEY=your_unsplash_api_key
  4. Start the development server
  5. Open index.html in your browser

Environment Variables

  • API_KEY: Your Unsplash API access key (required)
  • Optional: Configure port and other server settings as needed

License

This project uses the Unsplash API and follows their API Guidelines.

About

A simple Image search app with uses the unsplash api.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published