Skip to content

A Next.js image gallery showcasing high-quality photos with Cloudinary integration, modal lightbox functionality, and optimized image loading using blur placeholders.

Notifications You must be signed in to change notification settings

DigitalHerencia/SouthwestMediasServices

Repository files navigation

πŸ“Έ Next.js Image Gallery with Cloudinary

Next.js TypeScript Cloudinary License

A modern, responsive image gallery built with Next.js, Cloudinary, and TypeScript, featuring modal lightbox functionality, optimized image loading with blur placeholders, and seamless state management for user navigation.

πŸ–ΌοΈ Features

  • Optimized Images: Integrated with Cloudinary for automatic image optimization.
  • Blur Placeholders: Enhance UX with blurred image placeholders during image loading.
  • Responsive Gallery: Fully responsive grid layout for displaying images.
  • Modal Lightbox: View images in a modal popup for full-screen mode.
  • State Preservation: Scroll back to the last viewed photo with persistent state.

πŸš€ Demo

Check out a live demo of the project:
Live Demo


βš™οΈ Installation

  1. Clone the repository:

    git clone https://github.com/DigitalHerencia/southwestmediaservices
    cd southwestmediaservices
    
  2. Install dependencies:

    npm install
    
     or
    
    yarn install
    
  3. Set up environment variables:

    Create a .env.local file in the root directory and add your Cloudinary credentials:

    NEXT_PUBLIC_CLOUDINARY_CLOUD_NAME=your-cloudinary-name
    CLOUDINARY_API_KEY=your-api-key
    CLOUDINARY_API_SECRET=your-api-secret
    CLOUDINARY_FOLDER=your-folder-name
    
  4. Run the development server:

    npm run dev
    

Open http://localhost:3000 to view the application in your browser.

πŸ› οΈ Usage

To add images, simply upload them to your Cloudinary account in the folder defined by CLOUDINARY_FOLDER.

The application will fetch these images automatically from Cloudinary using their API. Images will display in a responsive grid and can be viewed in full-screen via the modal.

πŸ“¦ Deployment

To deploy the project to Vercel, follow these steps:

  1. Push your repository to GitHub.

  2. Sign in to Vercel, and import your repository.

  3. Vercel will automatically set up your project and deploy it.

πŸ“š Technologies

  • Next.js - React framework with hybrid static & server rendering
  • TypeScript - Type-safe JavaScript
  • Cloudinary - Cloud-based image and video management
  • Tailwind CSS - Utility-first CSS framework

πŸ’» Local Development

To start the app in development mode, run the following:

npm run dev

This will start the development server on http://localhost:3000.

πŸ“ License

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

πŸ™Œ Contributing

Contributions are welcome! Please follow these steps:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/your-feature).
  3. Commit your changes (git commit -m 'Add your feature').
  4. Push to the branch (git push origin feature/your-feature).
  5. Open a pull request.

πŸ‘ Acknowledgments

  • Thanks to Vercel for hosting the demo.
  • Thanks to Cloudinary for image optimization services.

πŸ“§ Contact

For any inquiries, feel free to reach out at DigitalHerencia@Outlook.com.

About

A Next.js image gallery showcasing high-quality photos with Cloudinary integration, modal lightbox functionality, and optimized image loading using blur placeholders.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published