Bootstrap 5 Masonry Image Gallery with Filter and Lightbox
A responsive masonry photo gallery with category filter pills, hover captions and a click-to-enlarge lightbox.
<section class="wdw-stage align-items-start">
<div class="container" style="max-width:1100px">
<div class="d-flex flex-wrap justify-content-between align-items-end gap-3 mb-4">
<div><span class="wdw-eyebrow">Gallery</span><h2 class="wdw-heading h2 mt-1 mb-0">Tech and workspace photos</h2></div>
<div class="d-flex flex-wrap gap-2 gal-filters" role="group" aria-label="Filter photos">
<button type="button" class="btn btn-sm rounded-pill active" data-filter="all" aria-pressed="true">All</button>
<button type="button" class="btn btn-sm rounded-pill" data-filter="Code" aria-pressed="false">Code</button>
<button type="button" class="btn btn-sm rounded-pill" data-filter="Hardware" aria-pressed="false">Hardware</button>
<button type="button" class="btn btn-sm rounded-pill" data-filter="Workspace" aria-pressed="false">Workspace</button>
</div>
</div>
<div class="gal-grid" id="galGrid">
<figure class="gal-item m-0" data-cat="Hardware"><button type="button" class="gal-btn" data-full="https://images.unsplash.com/photo-1518770660439-4636190af475?auto=format&fit=crop&w=1400&q=80" data-alt="Circuit board close-up" aria-label="Open photo: Circuit board close-up"><img src="https://images.unsplash.com/photo-1518770660439-4636190af475?auto=format&fit=crop&w=600&q=70" alt="Circuit board close-up" loading="lazy" style="aspect-ratio:4/3"><span class="gal-tag">Hardware</span></button></figure>
<figure class="gal-item m-0" data-cat="Code"><button type="button" class="gal-btn" data-full="https://images.unsplash.com/photo-1461749280684-dccba630e2f6?auto=format&fit=crop&w=1400&q=80" data-alt="Source code on a dark editor" aria-label="Open photo: Source code on a dark editor"><img src="https://images.unsplash.com/photo-1461749280684-dccba630e2f6?auto=format&fit=crop&w=600&q=70" alt="Source code on a dark editor" loading="lazy" style="aspect-ratio:3/4"><span class="gal-tag">Code</span></button></figure>
<figure class="gal-item m-0" data-cat="Workspace"><button type="button" class="gal-btn" data-full="https://images.unsplash.com/photo-1498050108023-c5249f4df085?auto=format&fit=crop&w=1400&q=80" data-alt="Laptop on a bright desk" aria-label="Open photo: Laptop on a bright desk"><img src="https://images.unsplash.com/photo-1498050108023-c5249f4df085?auto=format&fit=crop&w=600&q=70" alt="Laptop on a bright desk" loading="lazy" style="aspect-ratio:1/1"><span class="gal-tag">Workspace</span></button></figure>
<figure class="gal-item m-0" data-cat="Hardware"><button type="button" class="gal-btn" data-full="https://images.unsplash.com/photo-1558494949-ef010cbdcc31?auto=format&fit=crop&w=1400&q=80" data-alt="Server rack with cables" aria-label="Open photo: Server rack with cables"><img src="https://images.unsplash.com/photo-1558494949-ef010cbdcc31?auto=format&fit=crop&w=600&q=70" alt="Server rack with cables" loading="lazy" style="aspect-ratio:3/4"><span class="gal-tag">Hardware</span></button></figure>
<figure class="gal-item m-0" data-cat="Code"><button type="button" class="gal-btn" data-full="https://images.unsplash.com/photo-1487058792275-0ad4aaf24ca7?auto=format&fit=crop&w=1400&q=80" data-alt="Blurred lines of code" aria-label="Open photo: Blurred lines of code"><img src="https://images.unsplash.com/photo-1487058792275-0ad4aaf24ca7?auto=format&fit=crop&w=600&q=70" alt="Blurred lines of code" loading="lazy" style="aspect-ratio:4/3"><span class="gal-tag">Code</span></button></figure>
<figure class="gal-item m-0" data-cat="Workspace"><button type="button" class="gal-btn" data-full="https://images.unsplash.com/photo-1519389950473-47ba0277781c?auto=format&fit=crop&w=1400&q=80" data-alt="Team laptops seen from above" aria-label="Open photo: Team laptops seen from above"><img src="https://images.unsplash.com/photo-1519389950473-47ba0277781c?auto=format&fit=crop&w=600&q=70" alt="Team laptops seen from above" loading="lazy" style="aspect-ratio:1/1"><span class="gal-tag">Workspace</span></button></figure>
<figure class="gal-item m-0" data-cat="Hardware"><button type="button" class="gal-btn" data-full="https://images.unsplash.com/photo-1531297484001-80022131f5a1?auto=format&fit=crop&w=1400&q=80" data-alt="Laptop glowing in the dark" aria-label="Open photo: Laptop glowing in the dark"><img src="https://images.unsplash.com/photo-1531297484001-80022131f5a1?auto=format&fit=crop&w=600&q=70" alt="Laptop glowing in the dark" loading="lazy" style="aspect-ratio:4/3"><span class="gal-tag">Hardware</span></button></figure>
<figure class="gal-item m-0" data-cat="Code"><button type="button" class="gal-btn" data-full="https://images.unsplash.com/photo-1555066931-4365d14bab8c?auto=format&fit=crop&w=1400&q=80" data-alt="Code open on a laptop" aria-label="Open photo: Code open on a laptop"><img src="https://images.unsplash.com/photo-1555066931-4365d14bab8c?auto=format&fit=crop&w=600&q=70" alt="Code open on a laptop" loading="lazy" style="aspect-ratio:3/4"><span class="gal-tag">Code</span></button></figure>
<figure class="gal-item m-0" data-cat="Workspace"><button type="button" class="gal-btn" data-full="https://images.unsplash.com/photo-1504384308090-c894fdcc538d?auto=format&fit=crop&w=1400&q=80" data-alt="Open-plan office" aria-label="Open photo: Open-plan office"><img src="https://images.unsplash.com/photo-1504384308090-c894fdcc538d?auto=format&fit=crop&w=600&q=70" alt="Open-plan office" loading="lazy" style="aspect-ratio:4/3"><span class="gal-tag">Workspace</span></button></figure>
<figure class="gal-item m-0" data-cat="Code"><button type="button" class="gal-btn" data-full="https://images.unsplash.com/photo-1555949963-ff9fe0c870eb?auto=format&fit=crop&w=1400&q=80" data-alt="Colourful code highlighting" aria-label="Open photo: Colourful code highlighting"><img src="https://images.unsplash.com/photo-1555949963-ff9fe0c870eb?auto=format&fit=crop&w=600&q=70" alt="Colourful code highlighting" loading="lazy" style="aspect-ratio:1/1"><span class="gal-tag">Code</span></button></figure>
<figure class="gal-item m-0" data-cat="Hardware"><button type="button" class="gal-btn" data-full="https://images.unsplash.com/photo-1550751827-4bd374c3f58b?auto=format&fit=crop&w=1400&q=80" data-alt="Illuminated circuit traces" aria-label="Open photo: Illuminated circuit traces"><img src="https://images.unsplash.com/photo-1550751827-4bd374c3f58b?auto=format&fit=crop&w=600&q=70" alt="Illuminated circuit traces" loading="lazy" style="aspect-ratio:3/4"><span class="gal-tag">Hardware</span></button></figure>
<figure class="gal-item m-0" data-cat="Workspace"><button type="button" class="gal-btn" data-full="https://images.unsplash.com/photo-1593642632559-0c6d3fc62b89?auto=format&fit=crop&w=1400&q=80" data-alt="Minimal desk by a window" aria-label="Open photo: Minimal desk by a window"><img src="https://images.unsplash.com/photo-1593642632559-0c6d3fc62b89?auto=format&fit=crop&w=600&q=70" alt="Minimal desk by a window" loading="lazy" style="aspect-ratio:4/3"><span class="gal-tag">Workspace</span></button></figure>
</div>
</div>
<div class="modal fade" id="galModal" tabindex="-1" aria-label="Photo preview" aria-hidden="true">
<div class="modal-dialog modal-dialog-centered modal-lg"><div class="modal-content border-0 overflow-hidden rounded-4">
<button type="button" class="btn-close gal-close" data-bs-dismiss="modal" aria-label="Close"></button>
<img src="data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==" alt="" class="img-fluid w-100" id="galModalImg">
</div></div>
</div>
</section>
/* Web Designer Wall library style — shared base for every Bootstrap 5 snippet.
Indigo accent, Plus Jakarta Sans, soft cards, pill buttons. Works in light and dark. */
@import url("https://fonts.googleapis.com/css2?family=Plus+Jakarta+Sans:wght@400;500;600;700;800&display=swap");
:root,
[data-bs-theme="light"] {
--wdw-font: "Plus Jakarta Sans", system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
--bs-body-font-family: var(--wdw-font);
--bs-primary: #4f46e5;
--bs-primary-rgb: 79, 70, 229;
--bs-primary-text-emphasis: #3730a3;
--bs-primary-bg-subtle: #eef2ff;
--bs-primary-border-subtle: #c7d2fe;
--bs-link-color: #4f46e5;
--bs-link-color-rgb: 79, 70, 229;
--bs-link-hover-color: #4338ca;
--bs-link-hover-color-rgb: 67, 56, 202;
--bs-focus-ring-color: rgba(79, 70, 229, 0.25);
--bs-border-radius: 0.75rem;
--bs-border-radius-lg: 1rem;
--bs-border-radius-xl: 1.25rem;
--wdw-radius-card: 1.25rem;
--wdw-shadow: 0 1px 2px rgba(16, 24, 40, 0.05), 0 16px 40px -16px rgba(16, 24, 40, 0.22);
--wdw-shadow-sm: 0 1px 2px rgba(16, 24, 40, 0.06), 0 4px 12px -4px rgba(16, 24, 40, 0.12);
--wdw-stage: #f5f6fb;
}
[data-bs-theme="dark"] {
--bs-primary: #818cf8;
--bs-primary-rgb: 129, 140, 248;
--bs-primary-text-emphasis: #c7d2fe;
--bs-primary-bg-subtle: rgba(129, 140, 248, 0.14);
--bs-primary-border-subtle: rgba(129, 140, 248, 0.35);
--bs-link-color: #a5b4fc;
--bs-link-color-rgb: 165, 180, 252;
--bs-link-hover-color: #c7d2fe;
--bs-link-hover-color-rgb: 199, 210, 254;
--bs-focus-ring-color: rgba(129, 140, 248, 0.35);
--wdw-shadow: 0 1px 2px rgba(0, 0, 0, 0.4), 0 16px 40px -16px rgba(0, 0, 0, 0.7);
--wdw-shadow-sm: 0 1px 2px rgba(0, 0, 0, 0.4), 0 4px 12px -4px rgba(0, 0, 0, 0.5);
--wdw-stage: #0f1117;
}
body { font-family: var(--wdw-font); -webkit-font-smoothing: antialiased; }
/* Bootstrap compiles its blue into these components; point them at the accent. */
.btn-primary {
--bs-btn-bg: var(--bs-primary); --bs-btn-border-color: var(--bs-primary);
--bs-btn-hover-bg: #4338ca; --bs-btn-hover-border-color: #4338ca;
--bs-btn-active-bg: #3730a3; --bs-btn-active-border-color: #3730a3;
--bs-btn-disabled-bg: var(--bs-primary); --bs-btn-disabled-border-color: var(--bs-primary);
--bs-btn-focus-shadow-rgb: var(--bs-primary-rgb);
}
[data-bs-theme="dark"] .btn-primary { --bs-btn-color: #0f1117; --bs-btn-hover-bg: #a5b4fc; --bs-btn-hover-border-color: #a5b4fc; --bs-btn-hover-color: #0f1117; --bs-btn-active-color: #0f1117; }
.btn-outline-primary {
--bs-btn-color: var(--bs-primary); --bs-btn-border-color: var(--bs-primary);
--bs-btn-hover-bg: var(--bs-primary); --bs-btn-hover-border-color: var(--bs-primary);
--bs-btn-active-bg: var(--bs-primary); --bs-btn-active-border-color: var(--bs-primary);
--bs-btn-focus-shadow-rgb: var(--bs-primary-rgb);
}
.btn { --bs-btn-font-weight: 600; min-height: 44px; display: inline-flex; align-items: center; justify-content: center; gap: .5rem; }
.btn-sm { min-height: 36px; }
.form-control, .form-select { min-height: 44px; border-radius: .75rem; }
.form-control:focus, .form-select:focus, .form-check-input:focus { border-color: rgba(var(--bs-primary-rgb), .6); box-shadow: 0 0 0 .25rem var(--bs-focus-ring-color); }
.form-check-input:checked { background-color: var(--bs-primary); border-color: var(--bs-primary); }
.nav-pills { --bs-nav-pills-link-active-bg: var(--bs-primary); }
.nav { --bs-nav-link-color: var(--bs-secondary-color); --bs-nav-link-hover-color: var(--bs-emphasis-color); }
.pagination { --bs-pagination-active-bg: var(--bs-primary); --bs-pagination-active-border-color: var(--bs-primary); --bs-pagination-color: var(--bs-body-color); --bs-pagination-focus-box-shadow: 0 0 0 .25rem var(--bs-focus-ring-color); }
.progress, .progress-stacked { --bs-progress-bar-bg: var(--bs-primary); }
.list-group { --bs-list-group-active-bg: var(--bs-primary); --bs-list-group-active-border-color: var(--bs-primary); }
.dropdown-menu { --bs-dropdown-link-active-bg: var(--bs-primary); border-radius: .875rem; box-shadow: var(--wdw-shadow-sm); }
.accordion { --bs-accordion-active-bg: var(--bs-primary-bg-subtle); --bs-accordion-active-color: var(--bs-primary-text-emphasis); --bs-accordion-btn-focus-box-shadow: 0 0 0 .25rem var(--bs-focus-ring-color); }
.badge { font-weight: 600; }
/* Library building blocks — use these instead of re-inventing them per snippet. */
.wdw-stage { min-height: 100vh; display: flex; align-items: center; background: var(--wdw-stage); padding-block: 3rem; }
.wdw-card { background: var(--bs-body-bg); border: 1px solid var(--bs-border-color-translucent); border-radius: var(--wdw-radius-card); box-shadow: var(--wdw-shadow); }
.wdw-card-sm { background: var(--bs-body-bg); border: 1px solid var(--bs-border-color-translucent); border-radius: 1rem; box-shadow: var(--wdw-shadow-sm); }
.wdw-aurora { position: relative; color: #fff; background: radial-gradient(60% 55% at 100% 0, #818cf8 0, transparent 70%), radial-gradient(65% 60% at 0 100%, #ec4899 0, transparent 65%), #1e1b4b; }
.wdw-eyebrow { display: inline-block; font-size: .75rem; font-weight: 700; letter-spacing: .08em; text-transform: uppercase; color: var(--bs-primary); }
.wdw-heading { font-weight: 800; letter-spacing: -.02em; color: var(--bs-emphasis-color); }
.wdw-muted { color: var(--bs-secondary-color); }
.wdw-icon { width: 2.75rem; height: 2.75rem; flex: none; display: inline-flex; align-items: center; justify-content: center; border-radius: .875rem; background: var(--bs-primary-bg-subtle); color: var(--bs-primary); }
/* Component */
.gal-grid { column-count: 3; column-gap: 1rem; }
@media (max-width: 767.98px) { .gal-grid { column-count: 2; column-gap: .625rem; } }
.gal-item { break-inside: avoid; margin-bottom: 1rem !important; }
@media (max-width: 767.98px) { .gal-item { margin-bottom: .625rem !important; } }
.gal-item.d-none { display: none !important; }
.gal-btn { position: relative; display: block; width: 100%; padding: 0; border: 0; background: var(--bs-tertiary-bg); border-radius: 1rem; overflow: hidden; box-shadow: var(--wdw-shadow-sm); cursor: zoom-in; }
.gal-btn img { display: block; width: 100%; object-fit: cover; transition: transform .4s ease; }
.gal-btn:hover img { transform: scale(1.05); }
.gal-btn:focus-visible { outline: 3px solid var(--bs-primary); outline-offset: 2px; }
.gal-tag { position: absolute; left: .75rem; bottom: .75rem; padding: .25rem .65rem; border-radius: 2rem; font-size: .75rem; font-weight: 600; color: #fff; background: rgba(15,17,23,.62); backdrop-filter: blur(6px); opacity: 0; transform: translateY(4px); transition: all .2s; }
.gal-btn:hover .gal-tag, .gal-btn:focus-visible .gal-tag { opacity: 1; transform: none; }
@media (hover: none) { .gal-tag { opacity: 1; transform: none; } }
.gal-filters .btn { min-height: 40px; --bs-btn-color: var(--bs-body-color); --bs-btn-border-color: var(--bs-border-color); background: var(--bs-body-bg); }
.gal-filters .btn.active { background: var(--bs-primary); border-color: var(--bs-primary); color: #fff; }
[data-bs-theme="dark"] .gal-filters .btn.active { color: #0f1117; }
.gal-close { position: absolute; top: .75rem; right: .75rem; z-index: 2; background-color: #fff; border-radius: 50%; padding: .75rem; opacity: .9; }
@media (prefers-reduced-motion: reduce) { .gal-btn img, .gal-tag { transition: none; } }
function initGalleryFilters() {
const buttons = document.querySelectorAll('.gal-filters [data-filter]');
const items = document.querySelectorAll('#galGrid .gal-item');
if (!buttons.length) return;
buttons.forEach((btn) => {
btn.addEventListener('click', () => {
const f = btn.dataset.filter;
buttons.forEach((b) => {
const on = b === btn;
b.classList.toggle('active', on);
b.setAttribute('aria-pressed', on);
});
items.forEach((it) => it.classList.toggle('d-none', f !== 'all' && it.dataset.cat !== f));
});
});
}
function initGalleryLightbox() {
const modalEl = document.getElementById('galModal');
const img = document.getElementById('galModalImg');
if (!modalEl || !img) return;
const modal = bootstrap.Modal.getOrCreateInstance(modalEl);
document.querySelectorAll('#galGrid .gal-btn').forEach((btn) => {
btn.addEventListener('click', () => {
img.src = btn.dataset.full;
img.alt = btn.dataset.alt;
modal.show();
});
});
}
initGalleryFilters();
initGalleryLightbox();
Built on Bootstrap 5.3.8 with plain JavaScript — no jQuery. Supports light and dark mode via data-bs-theme.
