# Instagram Grid

> A responsive photo grid that mirrors an Instagram profile layout with hover overlays for likes and comments. Use it to preview a visual feed on a portfolio.

A shadcn/ui block from the [@shadcn-ui-blocks](https://www.shadcn-ui-blocks.com) registry, listed on [shadcn.exchange](https://shadcn.exchange/r/shadcn-ui-blocks/portfolio-portfolio-social-media-embeds-instagram-grid).

- Page, with a live preview: https://shadcn.exchange/r/shadcn-ui-blocks/portfolio-portfolio-social-media-embeds-instagram-grid
- Screenshot: https://abzjhwgwpdpz7ua5.public.blob.vercel-storage.com/shots/shadcn-ui-blocks/portfolio-portfolio-social-media-embeds-instagram-grid-light-19642a79be3ed2f8.png
- Registry item: https://www.shadcn-ui-blocks.com/r/portfolio-portfolio-social-media-embeds-instagram-grid.json
- Listed: 2026-10-13, source last changed 2026-10-13

## Install

```bash
npx shadcn@latest add https://www.shadcn-ui-blocks.com/r/portfolio-portfolio-social-media-embeds-instagram-grid.json
```

Run it in a project that has shadcn/ui set up. It adds the files below and installs what they depend on.

## Dependencies

- npm packages: `@icons-pack/react-simple-icons`, `class-variance-authority`, `lucide-react`, `radix-ui`

## Files

### `components/blocks/portfolio/portfolio-social-media-embeds/instagram-grid.tsx`

```tsx
import { useState } from 'react';

import { Badge } from '@/components/ui/badge';
import { Button } from '@/components/ui/button';
import { ExternalLink, Heart, MessageCircle } from 'lucide-react';
import { SiInstagram } from '@icons-pack/react-simple-icons';
import { cn } from '@/lib/utils';

// Sample Instagram posts data
const instagramPosts = [
  {
    id: 'post1',
    imageUrl:
      'https://images.unsplash.com/photo-1555066931-4365d14bab8c?q=80&w=1170&auto=format&fit=crop',
    likes: 324,
    comments: 18,
    caption:
      'Building responsive interfaces with React and Tailwind CSS. #webdevelopment #frontend #coding',
    url: '#',
  },
  {
    id: 'post2',
    imageUrl:
      'https://images.unsplash.com/photo-1587620962725-abab7fe55159?q=80&w=1031&auto=format&fit=crop',
    likes: 256,
    comments: 12,
    caption:
      'Late night coding session. The best ideas come after midnight. #programming #developer #techjobs',
    url: '#',
  },
  {
    id: 'post3',
    imageUrl:
      'https://images.unsplash.com/photo-1498050108023-c5249f4df085?q=80&w=1172&auto=format&fit=crop',
    likes: 512,
    comments: 32,
    caption:
      'Just shipped a new feature to production! #softwaredevelopment #deployment #agile',
    url: '#',
  },
  {
    id: 'post4',
    imageUrl:
      'https://images.unsplash.com/photo-1542831371-29b0f74f9713?q=80&w=1170&auto=format&fit=crop',
    likes: 187,
    comments: 14,
    caption:
      'Learning advanced TypeScript concepts today - generics and utility types. #typescript #webdev',
    url: '#',
  },
  {
    id: 'post5',
    imageUrl:
      'https://images.unsplash.com/photo-1453928582365-b6ad33cbcf64?q=80&w=1173&auto=format&fit=crop',
    likes: 423,
    comments: 27,
    caption:
      'My workspace setup for 2023 - productivity maximized! #workfromhome #desksetup #developerlife',
    url: '#',
  },
  {
    id: 'post6',
    imageUrl:
      'https://images.unsplash.com/photo-1552308995-2baac1ad5490?q=80&w=1170&auto=format&fit=crop',
    likes: 301,
    comments: 19,
    caption:
      'Team whiteboarding session - planning our next big project! #teamwork #productdevelopment #agile',
    url: '#',
  },
  {
    id: 'post7',
    imageUrl:
      'https://images.unsplash.com/photo-1607799279861-4dd421887fb3?q=80&w=1170&auto=format&fit=crop',
    likes: 285,
    comments: 21,
    caption:
      'Debugging on a Sunday because I love what I do. #debugging #softwareengineer #passionproject',
    url: '#',
  },
  {
    id: 'post8',
    imageUrl:
      'https://images.unsplash.com/photo-1517694712202-14dd9538aa97?q=80&w=1170&auto=format&fit=crop',
    likes: 342,
    comments: 16,
    caption:
      'Coffee + Code = Perfect Morning. #coffeetime #programming #morningroutine',
    url: '#',
  },
  {
    id: 'post9',
    imageUrl:
      'https://images.unsplash.com/photo-1531482615713-2afd69097998?q=80&w=1170&auto=format&fit=crop',
    likes: 476,
    comments: 31,
    caption:
      'Just completed my latest portfolio project. Check out the link in bio! #webportfolio #freelancer #hireme',
    url: '#',
  },
];

export default function InstagramGrid() {
  const [hoveredPost, setHoveredPost] = useState<string | null>(null);

  return (
    <div className="bg-background py-16 md:py-24">
      <div className="container mx-auto px-4 2xl:max-w-[1400px]">
        <div className="mb-10 text-center">
          <div className="mb-3 inline-flex items-center gap-2">
            <SiInstagram className="h-5 w-5 text-pink-500" />
            <Badge
              variant="outline"
              className="border-pink-200 bg-pink-50 px-3 py-1 text-xs font-medium tracking-wide text-pink-600 uppercase dark:border-pink-500/20 dark:bg-pink-500/10 dark:text-pink-400"
            >
              Instagram
            </Badge>
          </div>
          <h2 className="text-3xl font-bold tracking-tight sm:text-4xl md:text-5xl">
            Recent Updates
          </h2>
          <p className="text-muted-foreground mx-auto mt-4 max-w-2xl">
            Check out my latest posts and snippets from my coding journey and
            project developments
          </p>
        </div>

        {/* Instagram Grid */}
        <div className="grid grid-cols-1 gap-4 sm:grid-cols-2 md:grid-cols-3">
          {instagramPosts.map((post) => (
            <a
              key={post.id}
              href={post.url}
              target="_blank"
              rel="noopener noreferrer"
              className="group relative block aspect-square overflow-hidden rounded-xl"
              onMouseEnter={() => setHoveredPost(post.id)}
              onMouseLeave={() => setHoveredPost(null)}
            >
              {/* Image */}
              <img
                src={post.imageUrl}
                alt={`Instagram post: ${post.caption.substring(0, 30)}...`}
                className={cn(
                  'object-cover transition-transform duration-300',
                  hoveredPost === post.id ? 'scale-105 blur-[1px]' : ''
                )}
              />

              {/* Overlay gradient always visible but more intense on hover */}
              <div
                className={cn(
                  'absolute inset-0 bg-gradient-to-t from-black/60 via-black/10 to-transparent transition-opacity',
                  hoveredPost === post.id ? 'opacity-100' : 'opacity-60'
                )}
              ></div>

              {/* Post info - always visible */}
              <div className="absolute right-3 bottom-3 left-3 flex items-center justify-between text-white">
                <div className="flex items-center gap-3">
                  <div className="flex items-center gap-1">
                    <Heart className="h-4 w-4 text-pink-500" fill="#ec4899" />
                    <span className="text-xs font-medium">{post.likes}</span>
                  </div>
                  <div className="flex items-center gap-1">
                    <MessageCircle className="h-4 w-4" />
                    <span className="text-xs font-medium">{post.comments}</span>
                  </div>
                </div>

                <div className="flex h-8 w-8 items-center justify-center rounded-full bg-black/20 text-white backdrop-blur-sm">
                  <ExternalLink className="h-4 w-4" />
                </div>
              </div>

              {/* Caption - only visible on hover */}
              <div
                className={cn(
                  'absolute inset-0 flex flex-col items-center justify-center bg-black/30 p-6 text-center text-white backdrop-blur-md backdrop-filter transition-opacity',
                  hoveredPost === post.id ? 'opacity-100' : 'opacity-0'
                )}
              >
                <p className="line-clamp-4 text-sm font-medium">
                  {post.caption}
                </p>
              </div>
            </a>
          ))}
        </div>

        {/* Footer with link to Instagram */}
        <div className="mt-8 flex justify-center">
          <Button
            variant="outline"
            className="gap-2 border-pink-200 hover:bg-pink-50 hover:text-pink-600 dark:border-pink-500/20 dark:hover:bg-pink-500/10 dark:hover:text-pink-400"
            asChild
          >
            <a href="#" target="_blank" rel="noopener noreferrer">
              <SiInstagram className="h-4 w-4" />
              <span>Follow me on Instagram</span>
            </a>
          </Button>
        </div>
      </div>
    </div>
  );
}
```

### `components/ui/badge.tsx`

```tsx
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Slot } from "radix-ui"

import { cn } from "@/lib/utils"

const badgeVariants = cva(
  "group/badge inline-flex h-5 w-fit shrink-0 items-center justify-center gap-1 overflow-hidden rounded-4xl border border-transparent px-2 py-0.5 text-xs font-medium whitespace-nowrap transition-all focus-visible:border-ring focus-visible:ring-[3px] focus-visible:ring-ring/50 has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 aria-invalid:border-destructive aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 [&>svg]:pointer-events-none [&>svg]:size-3!",
  {
    variants: {
      variant: {
        default: "bg-primary text-primary-foreground [a]:hover:bg-primary/80",
        secondary:
          "bg-secondary text-secondary-foreground [a]:hover:bg-secondary/80",
        destructive:
          "bg-destructive/10 text-destructive focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:focus-visible:ring-destructive/40 [a]:hover:bg-destructive/20",
        outline:
          "border-border text-foreground [a]:hover:bg-muted [a]:hover:text-muted-foreground",
        ghost:
          "hover:bg-muted hover:text-muted-foreground dark:hover:bg-muted/50",
        link: "text-primary underline-offset-4 hover:underline",
      },
    },
    defaultVariants: {
      variant: "default",
    },
  }
)

function Badge({
  className,
  variant = "default",
  asChild = false,
  ...props
}: React.ComponentProps<"span"> &
  VariantProps<typeof badgeVariants> & { asChild?: boolean }) {
  const Comp = asChild ? Slot.Root : "span"

  return (
    <Comp
      data-slot="badge"
      data-variant={variant}
      className={cn(badgeVariants({ variant }), className)}
      {...props}
    />
  )
}

export { Badge, badgeVariants }
```

### `components/ui/button.tsx`

```tsx
import * as React from "react"
import { cva, type VariantProps } from "class-variance-authority"
import { Slot } from "radix-ui"

import { cn } from "@/lib/utils"

const buttonVariants = cva(
  "group/button inline-flex shrink-0 items-center justify-center rounded-md border border-transparent bg-clip-padding text-sm font-medium whitespace-nowrap transition-all outline-none select-none focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 active:not-aria-[haspopup]:translate-y-px disabled:pointer-events-none disabled:opacity-50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 [&_svg]:pointer-events-none [&_svg]:shrink-0 [&_svg:not([class*='size-'])]:size-4",
  {
    variants: {
      variant: {
        default: "bg-primary text-primary-foreground hover:bg-primary/80",
        outline:
          "border-border bg-background shadow-xs hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:border-input dark:bg-input/30 dark:hover:bg-input/50",
        secondary:
          "bg-secondary text-secondary-foreground hover:bg-secondary/80 aria-expanded:bg-secondary aria-expanded:text-secondary-foreground",
        ghost:
          "hover:bg-muted hover:text-foreground aria-expanded:bg-muted aria-expanded:text-foreground dark:hover:bg-muted/50",
        destructive:
          "bg-destructive/10 text-destructive hover:bg-destructive/20 focus-visible:border-destructive/40 focus-visible:ring-destructive/20 dark:bg-destructive/20 dark:hover:bg-destructive/30 dark:focus-visible:ring-destructive/40",
        link: "text-primary underline-offset-4 hover:underline",
      },
      size: {
        default:
          "h-9 gap-1.5 px-2.5 in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
        xs: "h-6 gap-1 rounded-[min(var(--radius-md),8px)] px-2 text-xs in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5 [&_svg:not([class*='size-'])]:size-3",
        sm: "h-8 gap-1 rounded-[min(var(--radius-md),10px)] px-2.5 in-data-[slot=button-group]:rounded-md has-data-[icon=inline-end]:pr-1.5 has-data-[icon=inline-start]:pl-1.5",
        lg: "h-10 gap-1.5 px-2.5 has-data-[icon=inline-end]:pr-2 has-data-[icon=inline-start]:pl-2",
        icon: "size-9",
        "icon-xs":
          "size-6 rounded-[min(var(--radius-md),8px)] in-data-[slot=button-group]:rounded-md [&_svg:not([class*='size-'])]:size-3",
        "icon-sm":
          "size-8 rounded-[min(var(--radius-md),10px)] in-data-[slot=button-group]:rounded-md",
        "icon-lg": "size-10",
      },
    },
    defaultVariants: {
      variant: "default",
      size: "default",
    },
  }
)

function Button({
  className,
  variant = "default",
  size = "default",
  asChild = false,
  ...props
}: React.ComponentProps<"button"> &
  VariantProps<typeof buttonVariants> & {
    asChild?: boolean
  }) {
  const Comp = asChild ? Slot.Root : "button"

  return (
    <Comp
      data-slot="button"
      data-variant={variant}
      data-size={size}
      className={cn(buttonVariants({ variant, size, className }))}
      {...props}
    />
  )
}

export { Button, buttonVariants }
```