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.
Usage
Copy and paste this code into your Astro page:
---
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 <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
Works well with
Manual Installation
If you are not using the npm package, create a new file and paste the following code: src/components/sections/DevProjectGrid.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>
This section was crafted as a core block for the following template. You can preview the full interactive multi-page experience or explore all related components.
Developer Portfolio
A monochrome, keyboard-inspired portfolio with 3D projects, a typing keyboard and a contribution matrix of flying cubes.
More Sections to Explore
Discover other full-width landing blocks and production-ready sections from our library.
Dev Header
Floating navigation with a split logo that collapses on scroll (N·OALINDQVIST·.DEV → N.DEV), pill links, light/dark toggle and a full-screen mobile menu.
Dev Hero
Developer hero: an oversized title that retypes itself, the name dropping in with floating blocks, a status pill and an endless tape of skill cards with tooltips, over a 3D dot matrix that parts around the cursor.
Dev Projects Showcase 3D
3D projects slider: paper cards with ink outlines fanned out in perspective, each with an animated visual chosen by data (code, terminal, equalizer, monitor, endpoints, paint, atom). Drag, keys or arrows to move; click to open a project sheet.
Dev Keyboard 3D
Full-width 3D mechanical keyboard that types your stack by itself and echoes each word as a huge backdrop; slot content (e.g. a repo list) floats over the lower rows.