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.
projectsgridfilterportfolio
Usage
Copy and paste this code into your React component:
tsx
import { DevProjectGrid } from 'react-component-kit-ui/sections';
<DevProjectGrid projects={[{ title: 'Orbit UI', tagline: 'Accessible React kit', category: 'Frontend', href: '/projects/orbit-ui/', status: 'Live' }]} />Manual Installation
If you are not using the npm package, create a new file and paste the following code: src/components/sections/DevProjectGrid.tsx + DevProjectGrid.css:
DevProjectGrid.tsx
'use client';
import { useEffect, useRef } from 'react';
import './DevProjectGrid.css';
/** class:list โ className */
function cx(...args: unknown[]): string {
const out: string[] = [];
const walk = (v: unknown) => {
if (!v) return;
if (typeof v === 'string' || typeof v === 'number') out.push(String(v));
else if (Array.isArray(v)) v.forEach(walk);
else if (typeof v === 'object') for (const [k, on] of Object.entries(v as Record<string, unknown>)) if (on) out.push(k);
};
args.forEach(walk);
return out.join(' ');
}
interface Project {
title: string;
tagline: string;
category: string;
href: string;
technologies?: string[];
status?: string;
year?: string;
stars?: number;
}
/**
* 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.
*/
export interface DevProjectGridProps {
projects?: Project[];
filters?: boolean;
allLabel?: string;
emptyLabel?: string;
className?: string;
}
export function DevProjectGrid({ 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 = '' }: DevProjectGridProps) {
const categories = [...new Set(projects.map((p) => p.category))];
const pad = (n: number) => String(n).padStart(2, '0');
// Client-side behaviour: runs once after mount.
const mounted = useRef(false);
useEffect(() => {
if (mounted.current) return;
mounted.current = true;
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'}`;
}),
);
});
// eslint-disable-next-line react-hooks/exhaustive-deps
}, []);
return (
<>
<section className={cx(['dvpg', className])} data-dev-grid data-rk-31046f="">
<div className="dvpg__wrap" data-rk-31046f="">
{filters && categories.length > 1 && (
<div className="dvpg__filters" role="group" aria-label="Filter projects" data-rk-31046f="">
<button type="button" className="dvpg__filter" aria-pressed="true" data-filter="" data-rk-31046f="">{allLabel} <span data-rk-31046f="">{projects.length}</span></button>
{categories.map((c, __i: number) => (
<button key={__i} type="button" className="dvpg__filter" aria-pressed="false" data-filter={c} data-rk-31046f="">{c} <span data-rk-31046f="">{projects.filter((p) => p.category === c).length}</span></button>
))}
</div>
)}
<p className="dvpg__live" aria-live="polite" data-live data-rk-31046f=""></p>
<ul className="dvpg__grid" data-rk-31046f="">
{projects.map((p, i) => (
<li key={i} data-category={p.category} data-rk-31046f="">
<a className="dvpg__card" href={p.href} data-rk-31046f="">
<span className="dvpg__top" data-rk-31046f="">
<span className="dvpg__num" data-rk-31046f="">{pad(i + 1)}</span>
<span className="dvpg__cat" data-rk-31046f="">{p.category}</span>
{p.year && <span className="dvpg__year" data-rk-31046f="">{p.year}</span>}
</span>
<span className="dvpg__title" data-rk-31046f="">{p.title}</span>
<span className="dvpg__tagline" data-rk-31046f="">{p.tagline}</span>
{p.technologies && p.technologies.length > 0 && (
<span className="dvpg__chips" data-rk-31046f="">{p.technologies.slice(0, 4).map((t, __i: number) => <span key={__i} data-rk-31046f="">{t}</span>)}</span>
)}
<span className="dvpg__foot" data-rk-31046f="">
{p.status && <span className="dvpg__status" data-status={p.status.toLowerCase().replace(/\s+/g, '-')} data-rk-31046f=""><i aria-hidden="true" data-rk-31046f=""></i>{p.status}</span>}
{!!p.stars && <span className="dvpg__stars" data-rk-31046f="">โ
{p.stars.toLocaleString('en')}</span>}
<span className="dvpg__arrow" aria-hidden="true" data-rk-31046f="">โ</span>
</span>
</a>
</li>
))}
</ul>
<p className="dvpg__empty" data-empty hidden data-rk-31046f="">{emptyLabel}</p>
</div>
</section>
</>
);
}
export default DevProjectGrid;DevProjectGrid.css
.dvpg:where([data-rk-31046f]) { padding: 0 0 clamp(3rem, 7vw, 5rem); color: var(--c-text-1); }
.dvpg__wrap:where([data-rk-31046f]) { max-width: 1040px; margin: 0 auto; padding: 0 clamp(1rem, 3vw, 1.5rem); }
.dvpg__filters:where([data-rk-31046f]) { display: flex; flex-wrap: wrap; gap: 0.5rem; margin-bottom: 1.75rem; }
.dvpg__filter:where([data-rk-31046f]) {
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:where([data-rk-31046f]) span:where([data-rk-31046f]) { opacity: 0.5; }
.dvpg__filter:hover:where([data-rk-31046f]) { transform: translateY(1px); box-shadow: 0 2px 0 var(--c-text-1); }
.dvpg__filter[aria-pressed='true']:where([data-rk-31046f]) { background: var(--c-text-1); color: var(--c-bg); transform: translateY(3px); box-shadow: none; }
.dvpg__live:where([data-rk-31046f]) { position: absolute; width: 1px; height: 1px; overflow: hidden; clip-path: inset(50%); }
.dvpg__grid:where([data-rk-31046f]) { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 1.25rem; margin: 0; padding: 0; list-style: none; }
.dvpg__grid:where([data-rk-31046f]) li[hidden]:where([data-rk-31046f]) { display: none; }
.dvpg__card:where([data-rk-31046f]) {
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:where([data-rk-31046f]) { transform: translate(2px, 2px); box-shadow: 2px 2px 0 var(--c-text-1); }
.dvpg__card:active:where([data-rk-31046f]) { transform: translate(4px, 4px); box-shadow: 0 0 0 var(--c-text-1); }
.dvpg__card:focus-visible:where([data-rk-31046f]) { outline: 2px solid var(--c-text-1); outline-offset: 4px; }
.dvpg__top:where([data-rk-31046f]) { 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:where([data-rk-31046f]) { padding: 0.1rem 0.4rem; border-radius: 2px; background: var(--c-text-1); color: var(--c-bg); font-weight: 700; }
.dvpg__year:where([data-rk-31046f]) { margin-left: auto; }
.dvpg__title:where([data-rk-31046f]) { margin-top: 0.4rem; font-size: 1.45rem; font-weight: 800; letter-spacing: -0.02em; line-height: 1.15; }
.dvpg__tagline:where([data-rk-31046f]) { font-size: 0.9rem; line-height: 1.55; color: var(--c-text-2); }
.dvpg__chips:where([data-rk-31046f]) { display: flex; flex-wrap: wrap; gap: 0.35rem; margin-top: 0.2rem; }
.dvpg__chips:where([data-rk-31046f]) span:where([data-rk-31046f]) { 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:where([data-rk-31046f]) { 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:where([data-rk-31046f]) { display: inline-flex; align-items: center; gap: 0.4rem; }
.dvpg__status:where([data-rk-31046f]) i:where([data-rk-31046f]) { width: 7px; height: 7px; border-radius: 50%; background: var(--c-text-3); }
.dvpg__status[data-status='live']:where([data-rk-31046f]) i:where([data-rk-31046f]) { background: var(--c-success, #10b981); box-shadow: 0 0 6px var(--c-success, #10b981); }
.dvpg__status[data-status='in-progress']:where([data-rk-31046f]) i:where([data-rk-31046f]) { background: var(--c-warning, #f59e0b); }
.dvpg__arrow:where([data-rk-31046f]) { margin-left: auto; font-size: 1rem; color: var(--c-text-1); transition: transform 0.2s ease; }
.dvpg__card:hover:where([data-rk-31046f]) .dvpg__arrow:where([data-rk-31046f]) { transform: translate(2px, -2px); }
.dvpg__empty:where([data-rk-31046f]) { 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:where([data-rk-31046f]), .dvpg__filter:where([data-rk-31046f]), .dvpg__arrow:where([data-rk-31046f]) { transition: none; } }