Page Sections projectsgridfilterportfolio
Dev Project Grid
Keycap-style project cards (ink outline, hard shadow that presses on hover) with number, category, stack, status and stars, plus category filter keys.
Live Preview
Usage
Copy and paste this code into your Astro page:
astro
---
import { DevProjectGrid } from 'astro-component-kit/sections';
---
<DevProjectGrid projects={[{ title: 'Orbit UI', tagline: 'Accessible React kit', category: 'Frontend', href: '/projects/orbit-ui/', status: 'Live' }]} /> ---
import { DevProjectGrid } from 'astro-component-kit/sections';
---
<DevProjectGrid projects={[{ title: 'Orbit UI', tagline: 'Accessible React kit', category: 'Frontend', href: '/projects/orbit-ui/', status: 'Live' }]} /> Examples in context
Real code from the kit: how this piece is used inside templates, sections and other components.
PortfolioProjectsPage.astro astro
<DevProjectGrid
projects={site.projects.map((p) => ({
title: p.title, tagline: p.tagline, category: p.category, technologies: p.technologies,
status: p.status, year: p.year, stars: p.stars, href: portfolioProjectHref(routes, p.slug),
}))}
/> <DevProjectGrid
projects={site.projects.map((p) => ({
title: p.title, tagline: p.tagline, category: p.category, technologies: p.technologies,
status: p.status, year: p.year, stars: p.stars, href: portfolioProjectHref(routes, p.slug),
}))}
/> Used in
Templates
Works well with
Manual Installation
If you are not using the npm package, create a new file and paste the following code: src/components/lib/DevProjectGrid.astro:
astro
---
/**
* DevProjectGrid — Project index for developer portfolios ("Keycap" design): keycap-like cards
* (ink outline, hard offset shadow that "presses" on hover) with number, category, title, tagline,
* stack chips, status and stars, plus category filter keys.
*
* @param {Array<{title: string, tagline: string, category: string, href: string, technologies?: string[], status?: string, year?: string, stars?: number}>} projects - Projects.
* @param {boolean} filters - Show category filter keys. Default true.
* @param {string} allLabel - "All" filter label. Default 'All'.
* @param {string} emptyLabel - Shown when a filter has no results. Default 'No projects in this category yet.'
* @param {string} className - Extra class.
*
* Accessibility: filters are toggle buttons (aria-pressed) and the result count is announced in a
* polite live region; each card is one link with the title as its name.
*/
interface Project {
title: string;
tagline: string;
category: string;
href: string;
technologies?: string[];
status?: string;
year?: string;
stars?: number;
}
interface Props {
projects?: Project[];
filters?: boolean;
allLabel?: string;
emptyLabel?: string;
className?: string;
}
const { projects = [
{ title: 'Orbit UI', tagline: 'Accessible component kit for React', category: 'Frontend', href: '#', technologies: ['React', 'TypeScript', 'CSS'], status: 'Live', year: '2026', stars: 1240 },
{ title: 'Tidy', tagline: 'Reclaims disk space from dev caches', category: 'Tools', href: '#', technologies: ['Rust', 'CLI'], status: 'Live', year: '2025', stars: 486 },
{ title: 'Relay', tagline: 'Declarative API mocks in minutes', category: 'Backend', href: '#', technologies: ['Node.js', 'OpenAPI'], status: 'In progress', year: '2026', stars: 57 },
], filters = true, allLabel = 'All', emptyLabel = 'No projects in this category yet.', className = '' } = Astro.props;
const categories = [...new Set(projects.map((p) => p.category))];
const pad = (n: number) => String(n).padStart(2, '0');
---
<section class:list={['dvpg', className]} data-dev-grid>
<div class="dvpg__wrap">
{filters && categories.length > 1 && (
<div class="dvpg__filters" role="group" aria-label="Filter projects">
<button type="button" class="dvpg__filter" aria-pressed="true" data-filter="">{allLabel} <span>{projects.length}</span></button>
{categories.map((c) => (
<button type="button" class="dvpg__filter" aria-pressed="false" data-filter={c}>{c} <span>{projects.filter((p) => p.category === c).length}</span></button>
))}
</div>
)}
<p class="dvpg__live" aria-live="polite" data-live></p>
<ul class="dvpg__grid">
{projects.map((p, i) => (
<li data-category={p.category}>
<a class="dvpg__card" href={p.href}>
<span class="dvpg__top">
<span class="dvpg__num">{pad(i + 1)}</span>
<span class="dvpg__cat">{p.category}</span>
{p.year && <span class="dvpg__year">{p.year}</span>}
</span>
<span class="dvpg__title">{p.title}</span>
<span class="dvpg__tagline">{p.tagline}</span>
{p.technologies && p.technologies.length > 0 && (
<span class="dvpg__chips">{p.technologies.slice(0, 4).map((t) => <span>{t}</span>)}</span>
)}
<span class="dvpg__foot">
{p.status && <span class="dvpg__status" data-status={p.status.toLowerCase().replace(/\s+/g, '-')}><i aria-hidden="true"></i>{p.status}</span>}
{!!p.stars && <span class="dvpg__stars">★ {p.stars.toLocaleString('en')}</span>}
<span class="dvpg__arrow" aria-hidden="true">↗</span>
</span>
</a>
</li>
))}
</ul>
<p class="dvpg__empty" data-empty hidden>{emptyLabel}</p>
</div>
</section>
<style>
.dvpg { padding: 0 0 clamp(3rem, 7vw, 5rem); color: var(--c-text-1); }
.dvpg__wrap { max-width: 1040px; margin: 0 auto; padding: 0 clamp(1rem, 3vw, 1.5rem); }
.dvpg__filters { display: flex; flex-wrap: wrap; gap: 0.5rem; margin-bottom: 1.75rem; }
.dvpg__filter {
display: inline-flex;
align-items: center;
gap: 0.5rem;
min-height: 40px;
padding: 0 0.9rem;
border: 1.5px solid var(--c-text-1);
border-radius: 3px;
background: var(--c-bg);
color: var(--c-text-1);
font-family: var(--font-mono);
font-size: 0.74rem;
font-weight: 600;
box-shadow: 0 3px 0 var(--c-text-1);
cursor: pointer;
transition: transform 0.18s cubic-bezier(0.22, 1, 0.36, 1), box-shadow 0.18s ease, background 0.2s ease, color 0.2s ease;
}
.dvpg__filter span { opacity: 0.5; }
.dvpg__filter:hover { transform: translateY(1px); box-shadow: 0 2px 0 var(--c-text-1); }
.dvpg__filter[aria-pressed='true'] { background: var(--c-text-1); color: var(--c-bg); transform: translateY(3px); box-shadow: none; }
.dvpg__live { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); }
.dvpg__grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 1.25rem; margin: 0; padding: 0; list-style: none; }
.dvpg__grid li[hidden] { display: none; }
.dvpg__card {
position: relative;
display: flex;
flex-direction: column;
gap: 0.6rem;
height: 100%;
padding: 1.4rem;
border: 1.5px solid var(--c-text-1);
border-radius: 4px;
background: var(--c-bg);
color: var(--c-text-1);
text-decoration: none;
box-shadow: 4px 4px 0 var(--c-text-1);
transition: transform 0.18s cubic-bezier(0.22, 1, 0.36, 1), box-shadow 0.18s cubic-bezier(0.22, 1, 0.36, 1);
}
.dvpg__card:hover { transform: translate(2px, 2px); box-shadow: 2px 2px 0 var(--c-text-1); }
.dvpg__card:active { transform: translate(4px, 4px); box-shadow: 0 0 0 var(--c-text-1); }
.dvpg__card:focus-visible { outline: 2px solid var(--c-text-1); outline-offset: 4px; }
.dvpg__top { display: flex; align-items: center; gap: 0.6rem; font-family: var(--font-mono); font-size: 0.7rem; color: var(--c-text-3); text-transform: uppercase; letter-spacing: 0.04em; }
.dvpg__num { padding: 0.1rem 0.4rem; border-radius: 2px; background: var(--c-text-1); color: var(--c-bg); font-weight: 700; }
.dvpg__year { margin-left: auto; }
.dvpg__title { margin-top: 0.4rem; font-size: 1.45rem; font-weight: 800; letter-spacing: -0.02em; line-height: 1.15; }
.dvpg__tagline { font-size: 0.9rem; line-height: 1.55; color: var(--c-text-2); }
.dvpg__chips { display: flex; flex-wrap: wrap; gap: 0.35rem; margin-top: 0.2rem; }
.dvpg__chips span { padding: 0.2rem 0.5rem; border: 1px solid rgb(var(--ink-rgb, 0 0 0) / 0.2); border-radius: 2px; font-family: var(--font-mono); font-size: 0.66rem; }
.dvpg__foot { display: flex; align-items: center; gap: 0.75rem; margin-top: auto; padding-top: 0.8rem; border-top: 1px dashed rgb(var(--ink-rgb, 0 0 0) / 0.15); font-family: var(--font-mono); font-size: 0.7rem; color: var(--c-text-2); }
.dvpg__status { display: inline-flex; align-items: center; gap: 0.4rem; }
.dvpg__status i { width: 7px; height: 7px; border-radius: 50%; background: var(--c-text-3); }
.dvpg__status[data-status='live'] i { background: var(--c-success, #10b981); box-shadow: 0 0 6px var(--c-success, #10b981); }
.dvpg__status[data-status='in-progress'] i { background: var(--c-warning, #f59e0b); }
.dvpg__arrow { margin-left: auto; font-size: 1rem; color: var(--c-text-1); transition: transform 0.2s ease; }
.dvpg__card:hover .dvpg__arrow { transform: translate(2px, -2px); }
.dvpg__empty { margin: 2rem 0 0; font-family: var(--font-mono); font-size: 0.85rem; color: var(--c-text-3); }
@media (prefers-reduced-motion: reduce) { .dvpg__card, .dvpg__filter, .dvpg__arrow { transition: none; } }
</style>
<script>
document.querySelectorAll<HTMLElement>('[data-dev-grid]:not([data-bound])').forEach((root) => {
root.dataset.bound = '';
const buttons = Array.from(root.querySelectorAll<HTMLButtonElement>('[data-filter]'));
const items = Array.from(root.querySelectorAll<HTMLElement>('li[data-category]'));
const live = root.querySelector<HTMLElement>('[data-live]');
const empty = root.querySelector<HTMLElement>('[data-empty]');
buttons.forEach((btn) =>
btn.addEventListener('click', () => {
const f = btn.dataset.filter ?? '';
buttons.forEach((b) => b.setAttribute('aria-pressed', String(b === btn)));
let shown = 0;
items.forEach((li) => {
const on = !f || li.dataset.category === f;
li.hidden = !on;
if (on) shown++;
});
if (empty) empty.hidden = shown > 0;
if (live) live.textContent = `${shown} ${shown === 1 ? 'project' : 'projects'}`;
}),
);
});
</script> ---
/**
* DevProjectGrid — Project index for developer portfolios ("Keycap" design): keycap-like cards
* (ink outline, hard offset shadow that "presses" on hover) with number, category, title, tagline,
* stack chips, status and stars, plus category filter keys.
*
* @param {Array<{title: string, tagline: string, category: string, href: string, technologies?: string[], status?: string, year?: string, stars?: number}>} projects - Projects.
* @param {boolean} filters - Show category filter keys. Default true.
* @param {string} allLabel - "All" filter label. Default 'All'.
* @param {string} emptyLabel - Shown when a filter has no results. Default 'No projects in this category yet.'
* @param {string} className - Extra class.
*
* Accessibility: filters are toggle buttons (aria-pressed) and the result count is announced in a
* polite live region; each card is one link with the title as its name.
*/
interface Project {
title: string;
tagline: string;
category: string;
href: string;
technologies?: string[];
status?: string;
year?: string;
stars?: number;
}
interface Props {
projects?: Project[];
filters?: boolean;
allLabel?: string;
emptyLabel?: string;
className?: string;
}
const { projects = [
{ title: 'Orbit UI', tagline: 'Accessible component kit for React', category: 'Frontend', href: '#', technologies: ['React', 'TypeScript', 'CSS'], status: 'Live', year: '2026', stars: 1240 },
{ title: 'Tidy', tagline: 'Reclaims disk space from dev caches', category: 'Tools', href: '#', technologies: ['Rust', 'CLI'], status: 'Live', year: '2025', stars: 486 },
{ title: 'Relay', tagline: 'Declarative API mocks in minutes', category: 'Backend', href: '#', technologies: ['Node.js', 'OpenAPI'], status: 'In progress', year: '2026', stars: 57 },
], filters = true, allLabel = 'All', emptyLabel = 'No projects in this category yet.', className = '' } = Astro.props;
const categories = [...new Set(projects.map((p) => p.category))];
const pad = (n: number) => String(n).padStart(2, '0');
---
<section class:list={['dvpg', className]} data-dev-grid>
<div class="dvpg__wrap">
{filters && categories.length > 1 && (
<div class="dvpg__filters" role="group" aria-label="Filter projects">
<button type="button" class="dvpg__filter" aria-pressed="true" data-filter="">{allLabel} <span>{projects.length}</span></button>
{categories.map((c) => (
<button type="button" class="dvpg__filter" aria-pressed="false" data-filter={c}>{c} <span>{projects.filter((p) => p.category === c).length}</span></button>
))}
</div>
)}
<p class="dvpg__live" aria-live="polite" data-live></p>
<ul class="dvpg__grid">
{projects.map((p, i) => (
<li data-category={p.category}>
<a class="dvpg__card" href={p.href}>
<span class="dvpg__top">
<span class="dvpg__num">{pad(i + 1)}</span>
<span class="dvpg__cat">{p.category}</span>
{p.year && <span class="dvpg__year">{p.year}</span>}
</span>
<span class="dvpg__title">{p.title}</span>
<span class="dvpg__tagline">{p.tagline}</span>
{p.technologies && p.technologies.length > 0 && (
<span class="dvpg__chips">{p.technologies.slice(0, 4).map((t) => <span>{t}</span>)}</span>
)}
<span class="dvpg__foot">
{p.status && <span class="dvpg__status" data-status={p.status.toLowerCase().replace(/\s+/g, '-')}><i aria-hidden="true"></i>{p.status}</span>}
{!!p.stars && <span class="dvpg__stars">★ {p.stars.toLocaleString('en')}</span>}
<span class="dvpg__arrow" aria-hidden="true">↗</span>
</span>
</a>
</li>
))}
</ul>
<p class="dvpg__empty" data-empty hidden>{emptyLabel}</p>
</div>
</section>
<style>
.dvpg { padding: 0 0 clamp(3rem, 7vw, 5rem); color: var(--c-text-1); }
.dvpg__wrap { max-width: 1040px; margin: 0 auto; padding: 0 clamp(1rem, 3vw, 1.5rem); }
.dvpg__filters { display: flex; flex-wrap: wrap; gap: 0.5rem; margin-bottom: 1.75rem; }
.dvpg__filter {
display: inline-flex;
align-items: center;
gap: 0.5rem;
min-height: 40px;
padding: 0 0.9rem;
border: 1.5px solid var(--c-text-1);
border-radius: 3px;
background: var(--c-bg);
color: var(--c-text-1);
font-family: var(--font-mono);
font-size: 0.74rem;
font-weight: 600;
box-shadow: 0 3px 0 var(--c-text-1);
cursor: pointer;
transition: transform 0.18s cubic-bezier(0.22, 1, 0.36, 1), box-shadow 0.18s ease, background 0.2s ease, color 0.2s ease;
}
.dvpg__filter span { opacity: 0.5; }
.dvpg__filter:hover { transform: translateY(1px); box-shadow: 0 2px 0 var(--c-text-1); }
.dvpg__filter[aria-pressed='true'] { background: var(--c-text-1); color: var(--c-bg); transform: translateY(3px); box-shadow: none; }
.dvpg__live { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); }
.dvpg__grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 1.25rem; margin: 0; padding: 0; list-style: none; }
.dvpg__grid li[hidden] { display: none; }
.dvpg__card {
position: relative;
display: flex;
flex-direction: column;
gap: 0.6rem;
height: 100%;
padding: 1.4rem;
border: 1.5px solid var(--c-text-1);
border-radius: 4px;
background: var(--c-bg);
color: var(--c-text-1);
text-decoration: none;
box-shadow: 4px 4px 0 var(--c-text-1);
transition: transform 0.18s cubic-bezier(0.22, 1, 0.36, 1), box-shadow 0.18s cubic-bezier(0.22, 1, 0.36, 1);
}
.dvpg__card:hover { transform: translate(2px, 2px); box-shadow: 2px 2px 0 var(--c-text-1); }
.dvpg__card:active { transform: translate(4px, 4px); box-shadow: 0 0 0 var(--c-text-1); }
.dvpg__card:focus-visible { outline: 2px solid var(--c-text-1); outline-offset: 4px; }
.dvpg__top { display: flex; align-items: center; gap: 0.6rem; font-family: var(--font-mono); font-size: 0.7rem; color: var(--c-text-3); text-transform: uppercase; letter-spacing: 0.04em; }
.dvpg__num { padding: 0.1rem 0.4rem; border-radius: 2px; background: var(--c-text-1); color: var(--c-bg); font-weight: 700; }
.dvpg__year { margin-left: auto; }
.dvpg__title { margin-top: 0.4rem; font-size: 1.45rem; font-weight: 800; letter-spacing: -0.02em; line-height: 1.15; }
.dvpg__tagline { font-size: 0.9rem; line-height: 1.55; color: var(--c-text-2); }
.dvpg__chips { display: flex; flex-wrap: wrap; gap: 0.35rem; margin-top: 0.2rem; }
.dvpg__chips span { padding: 0.2rem 0.5rem; border: 1px solid rgb(var(--ink-rgb, 0 0 0) / 0.2); border-radius: 2px; font-family: var(--font-mono); font-size: 0.66rem; }
.dvpg__foot { display: flex; align-items: center; gap: 0.75rem; margin-top: auto; padding-top: 0.8rem; border-top: 1px dashed rgb(var(--ink-rgb, 0 0 0) / 0.15); font-family: var(--font-mono); font-size: 0.7rem; color: var(--c-text-2); }
.dvpg__status { display: inline-flex; align-items: center; gap: 0.4rem; }
.dvpg__status i { width: 7px; height: 7px; border-radius: 50%; background: var(--c-text-3); }
.dvpg__status[data-status='live'] i { background: var(--c-success, #10b981); box-shadow: 0 0 6px var(--c-success, #10b981); }
.dvpg__status[data-status='in-progress'] i { background: var(--c-warning, #f59e0b); }
.dvpg__arrow { margin-left: auto; font-size: 1rem; color: var(--c-text-1); transition: transform 0.2s ease; }
.dvpg__card:hover .dvpg__arrow { transform: translate(2px, -2px); }
.dvpg__empty { margin: 2rem 0 0; font-family: var(--font-mono); font-size: 0.85rem; color: var(--c-text-3); }
@media (prefers-reduced-motion: reduce) { .dvpg__card, .dvpg__filter, .dvpg__arrow { transition: none; } }
</style>
<script>
document.querySelectorAll<HTMLElement>('[data-dev-grid]:not([data-bound])').forEach((root) => {
root.dataset.bound = '';
const buttons = Array.from(root.querySelectorAll<HTMLButtonElement>('[data-filter]'));
const items = Array.from(root.querySelectorAll<HTMLElement>('li[data-category]'));
const live = root.querySelector<HTMLElement>('[data-live]');
const empty = root.querySelector<HTMLElement>('[data-empty]');
buttons.forEach((btn) =>
btn.addEventListener('click', () => {
const f = btn.dataset.filter ?? '';
buttons.forEach((b) => b.setAttribute('aria-pressed', String(b === btn)));
let shown = 0;
items.forEach((li) => {
const on = !f || li.dataset.category === f;
li.hidden = !on;
if (on) shown++;
});
if (empty) empty.hidden = shown > 0;
if (live) live.textContent = `${shown} ${shown === 1 ? 'project' : 'projects'}`;
}),
);
});
</script>
Quick Info
- Category
- Page Sections
- Filename
DevProjectGrid.astro- Dependencies
- None — pure Astro + CSS
- Tags
- projectsgridfilterportfolio