1 GitHub star = 1 new component.

Star the repo
Developer Portfolio

Dev Project Detail

Project case study: overview, challenge, solution and highlights next to a sticky spec sheet (role, year, status, stack, metrics, links), with previous / next keys.

case-studyprojectspec-sheetportfolio
Live Preview

Overview

A cross-platform CLI that finds and safely removes stale build caches, node_modules and Docker layers, with a dry run and an undo log.

The challenge

Developer machines quietly fill up with caches from a dozen tools, and cleaning them by hand is risky.

The solution

A rule-based scanner that knows where each tool keeps its caches and moves files to a recoverable trash first.

Highlights

  • Rules for 30+ tools
  • Dry run with sizes and last access
  • Undo log for every removal

Usage

Copy and paste this code into your React component:

tsx
import { DevProjectDetail } from 'react-component-kit-ui/sections';

<DevProjectDetail project={{ title: 'Tidy', description: 'Frees disk space.', technologies: ['Rust'], role: 'Author', year: '2025' }} />

Manual Installation

If you are not using the npm package, create a new file and paste the following code: src/components/sections/DevProjectDetail.tsx + DevProjectDetail.css:

DevProjectDetail.tsx
'use client';

import './DevProjectDetail.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(' ');
}

/**
 * DevProjectDetail โ€” Project case study for developer portfolios ("Keycap" design): a long-form
 * column (overview, challenge, solution, features) next to a sticky "spec sheet" with role, year,
 * status, stack, metrics and links, followed by previous / next project keys.
 *
 * @param {object} project - { title, description, challenge?, solution?, features?: string[], role?, year?, status?, technologies[], metrics?: [{value, label}], liveUrl?, repoUrl?, stars? }
 * @param {{title: string, href: string}} prev - Previous project link.
 * @param {{title: string, href: string}} next - Next project link.
 * @param {object} labels - { overview, challenge, solution, features, spec, role, year, status, stack, live, code, prev, next }.
 * @param {string} className - Extra class.
 *
 * Accessibility: headings structure the long-form column; the spec sheet is an aside with a
 * definition list; prev/next is a labelled nav.
 */
export interface DevProjectDetailProps {
  project?: {
    title: string;
    description: string;
    challenge?: string;
    solution?: string;
    features?: string[];
    role?: string;
    year?: string;
    status?: string;
    technologies: string[];
    metrics?: Array<{ value: string; label: string }>;
    liveUrl?: string;
    repoUrl?: string;
    stars?: number;
  };
  prev?: { title: string; href: string };
  next?: { title: string; href: string };
  labels?: Partial<Record<'overview' | 'challenge' | 'solution' | 'features' | 'spec' | 'role' | 'year' | 'status' | 'stack' | 'live' | 'code' | 'prev' | 'next', string>>;
  className?: string;
}

export function DevProjectDetail({
  project: p = {
    title: 'Tidy',
    description: 'A cross-platform CLI that finds and safely removes stale build caches, node_modules and Docker layers, with a dry run and an undo log.',
    challenge: 'Developer machines quietly fill up with caches from a dozen tools, and cleaning them by hand is risky.',
    solution: 'A rule-based scanner that knows where each tool keeps its caches and moves files to a recoverable trash first.',
    features: ['Rules for 30+ tools', 'Dry run with sizes and last access', 'Undo log for every removal'],
    role: 'Author', year: '2025', status: 'Live', stars: 486,
    technologies: ['Rust', 'CLI', 'Docker'],
    metrics: [{ value: '12 GB', label: 'freed on average' }, { value: '3', label: 'platforms' }, { value: '<1s', label: 'scan' }],
    repoUrl: '#',
  },
  prev,
  next,
  labels = {},
  className = '',
}: DevProjectDetailProps) {
  const L = {
    overview: 'Overview', challenge: 'The challenge', solution: 'The solution', features: 'Highlights', spec: 'SPEC_SHEET',
    role: 'Role', year: 'Year', status: 'Status', stack: 'Stack', live: 'Visit live site', code: 'Source code', prev: 'Previous', next: 'Next',
    ...labels,
  };
  return (
    <>
      <section className={cx(['dvpd', className])} data-rk-8bc5e5="">
        <div className="dvpd__wrap" data-rk-8bc5e5="">
          <article className="dvpd__body" data-rk-8bc5e5="">
            <h2 data-rk-8bc5e5="">{L.overview}</h2>
            <p className="dvpd__lead" data-rk-8bc5e5="">{p.description}</p>
            {p.challenge && (<><h2 data-rk-8bc5e5="">{L.challenge}</h2><p data-rk-8bc5e5="">{p.challenge}</p></>)}
            {p.solution && (<><h2 data-rk-8bc5e5="">{L.solution}</h2><p data-rk-8bc5e5="">{p.solution}</p></>)}
            {p.features && p.features.length > 0 && (
              <>
                <h2 data-rk-8bc5e5="">{L.features}</h2>
                <ul className="dvpd__features" data-rk-8bc5e5="">{p.features.map((f, i) => <li key={i} data-rk-8bc5e5=""><span aria-hidden="true" data-rk-8bc5e5="">{String(i + 1).padStart(2, '0')}</span>{f}</li>)}</ul>
              </>
            )}
          </article>
      
          <aside className="dvpd__spec" aria-label={L.spec} data-rk-8bc5e5="">
            <p className="dvpd__spec-head" data-rk-8bc5e5=""><b data-rk-8bc5e5="">[</b>{` ${L.spec} `}<b data-rk-8bc5e5="">]</b></p>
            <dl data-rk-8bc5e5="">
              {p.role && <div data-rk-8bc5e5=""><dt data-rk-8bc5e5="">{L.role}</dt><dd data-rk-8bc5e5="">{p.role}</dd></div>}
              {p.year && <div data-rk-8bc5e5=""><dt data-rk-8bc5e5="">{L.year}</dt><dd data-rk-8bc5e5="">{p.year}</dd></div>}
              {p.status && <div data-rk-8bc5e5=""><dt data-rk-8bc5e5="">{L.status}</dt><dd data-rk-8bc5e5="">{p.status}</dd></div>}
              {!!p.stars && <div data-rk-8bc5e5=""><dt data-rk-8bc5e5="">GitHub</dt><dd data-rk-8bc5e5="">โ˜… {p.stars.toLocaleString('en')}</dd></div>}
            </dl>
            <p className="dvpd__label" data-rk-8bc5e5="">{L.stack}</p>
            <ul className="dvpd__chips" data-rk-8bc5e5="">{p.technologies.map((t, __i: number) => <li key={__i} data-rk-8bc5e5="">{t}</li>)}</ul>
            {p.metrics && p.metrics.length > 0 && (
              <ul className="dvpd__metrics" data-rk-8bc5e5="">{p.metrics.map((m, __i: number) => <li key={__i} data-rk-8bc5e5=""><strong data-rk-8bc5e5="">{m.value}</strong><span data-rk-8bc5e5="">{m.label}</span></li>)}</ul>
            )}
            <div className="dvpd__links" data-rk-8bc5e5="">
              {p.liveUrl && <a className="dvpd__btn dvpd__btn--primary" href={p.liveUrl} target="_blank" rel="noopener noreferrer" data-rk-8bc5e5="">{L.live} โ†—</a>}
              {p.repoUrl && <a className="dvpd__btn" href={p.repoUrl} target="_blank" rel="noopener noreferrer" data-rk-8bc5e5="">{L.code} โ†—</a>}
            </div>
          </aside>
        </div>
      
        {(prev || next) && (
          <nav className="dvpd__pager" aria-label="More projects" data-rk-8bc5e5="">
            {prev ? <a className="dvpd__key" href={prev.href} rel="prev" data-rk-8bc5e5=""><span data-rk-8bc5e5="">โ† {L.prev}</span><strong data-rk-8bc5e5="">{prev.title}</strong></a> : <span data-rk-8bc5e5=""></span>}
            {next && <a className="dvpd__key dvpd__key--next" href={next.href} rel="next" data-rk-8bc5e5=""><span data-rk-8bc5e5="">{L.next} โ†’</span><strong data-rk-8bc5e5="">{next.title}</strong></a>}
          </nav>
        )}
      </section>
    </>
  );
}

export default DevProjectDetail;
DevProjectDetail.css
.dvpd:where([data-rk-8bc5e5]) { padding: 0 0 clamp(3rem, 7vw, 5rem); color: var(--c-text-1); }
.dvpd__wrap:where([data-rk-8bc5e5]) { max-width: 1040px; margin: 0 auto; padding: 0 clamp(1rem, 3vw, 1.5rem); display: grid; grid-template-columns: minmax(0, 1fr) 320px; gap: clamp(2rem, 5vw, 4rem); align-items: start; }
.dvpd__body:where([data-rk-8bc5e5]) h2:where([data-rk-8bc5e5]) { margin: 2.25rem 0 0.75rem; font-family: var(--font-mono); font-size: 0.78rem; font-weight: 700; letter-spacing: 0.08em; text-transform: uppercase; color: var(--c-text-3); }
.dvpd__body:where([data-rk-8bc5e5]) h2:first-child:where([data-rk-8bc5e5]) { margin-top: 0; }
.dvpd__body:where([data-rk-8bc5e5]) p:where([data-rk-8bc5e5]) { margin: 0; font-size: 1.02rem; line-height: 1.8; color: var(--c-text-2); }
.dvpd__body:where([data-rk-8bc5e5]) .dvpd__lead:where([data-rk-8bc5e5]) { font-size: 1.2rem; line-height: 1.65; color: var(--c-text-1); }
.dvpd__features:where([data-rk-8bc5e5]) { display: grid; gap: 0.6rem; margin: 0; padding: 0; list-style: none; }
.dvpd__features:where([data-rk-8bc5e5]) li:where([data-rk-8bc5e5]) { display: flex; gap: 0.85rem; align-items: baseline; padding: 0.85rem 1rem; border: 1px solid var(--c-border); border-radius: 4px; font-size: 0.95rem; line-height: 1.55; }
.dvpd__features:where([data-rk-8bc5e5]) span:where([data-rk-8bc5e5]) { font-family: var(--font-mono); font-size: 0.7rem; font-weight: 700; color: var(--c-text-3); }

.dvpd__spec:where([data-rk-8bc5e5]) { position: sticky; top: 6rem; padding: 1.5rem; border: 2px solid var(--c-text-1); border-radius: 4px; background: var(--c-bg); box-shadow: 6px 6px 0 var(--c-text-1); }
.dvpd__spec-head:where([data-rk-8bc5e5]) { margin: 0 0 1rem; font-family: var(--font-mono); font-size: 0.72rem; letter-spacing: 0.08em; color: var(--c-text-3); }
.dvpd__spec-head:where([data-rk-8bc5e5]) b:where([data-rk-8bc5e5]) { color: var(--c-text-1); }
.dvpd__spec:where([data-rk-8bc5e5]) dl:where([data-rk-8bc5e5]) { margin: 0 0 1.25rem; }
.dvpd__spec:where([data-rk-8bc5e5]) dl:where([data-rk-8bc5e5]) div:where([data-rk-8bc5e5]) { display: flex; justify-content: space-between; gap: 1rem; padding: 0.55rem 0; border-bottom: 1px dashed rgb(var(--ink-rgb, 0 0 0) / 0.15); }
.dvpd__spec:where([data-rk-8bc5e5]) dt:where([data-rk-8bc5e5]) { font-family: var(--font-mono); font-size: 0.72rem; text-transform: uppercase; letter-spacing: 0.05em; color: var(--c-text-3); }
.dvpd__spec:where([data-rk-8bc5e5]) dd:where([data-rk-8bc5e5]) { margin: 0; font-size: 0.88rem; font-weight: 600; text-align: right; }
.dvpd__label:where([data-rk-8bc5e5]) { margin: 0 0 0.5rem; font-family: var(--font-mono); font-size: 0.68rem; font-weight: 700; letter-spacing: 0.08em; text-transform: uppercase; color: var(--c-text-3); }
.dvpd__chips:where([data-rk-8bc5e5]) { display: flex; flex-wrap: wrap; gap: 0.4rem; margin: 0 0 1.25rem; padding: 0; list-style: none; }
.dvpd__chips:where([data-rk-8bc5e5]) li:where([data-rk-8bc5e5]) { padding: 0.3rem 0.6rem; border: 1.5px solid var(--c-text-1); border-radius: 2px; font-family: var(--font-mono); font-size: 0.7rem; font-weight: 600; }
.dvpd__metrics:where([data-rk-8bc5e5]) { display: grid; grid-template-columns: repeat(3, 1fr); gap: 0.5rem; margin: 0 0 1.25rem; padding: 0; list-style: none; }
.dvpd__metrics:where([data-rk-8bc5e5]) li:where([data-rk-8bc5e5]) { display: flex; flex-direction: column; gap: 0.15rem; padding: 0.6rem 0.5rem; border-radius: 4px; background: rgb(var(--ink-rgb, 0 0 0) / 0.04); text-align: center; }
.dvpd__metrics:where([data-rk-8bc5e5]) strong:where([data-rk-8bc5e5]) { font-size: 1rem; font-weight: 800; letter-spacing: -0.02em; }
.dvpd__metrics:where([data-rk-8bc5e5]) span:where([data-rk-8bc5e5]) { font-family: var(--font-mono); font-size: 0.6rem; line-height: 1.3; color: var(--c-text-3); }
.dvpd__links:where([data-rk-8bc5e5]) { display: grid; gap: 0.6rem; }
.dvpd__btn:where([data-rk-8bc5e5]) { display: inline-flex; align-items: center; justify-content: center; min-height: 44px; border: 1.5px solid var(--c-text-1); border-radius: 2px; color: var(--c-text-1); font-family: var(--font-mono); font-size: 0.82rem; font-weight: 700; text-decoration: none; box-shadow: 2px 2px 0 var(--c-text-1); transition: transform 0.15s ease, box-shadow 0.15s ease; }
.dvpd__btn:hover:where([data-rk-8bc5e5]) { transform: translateY(-1px); box-shadow: 3px 3px 0 var(--c-text-1); }
.dvpd__btn--primary:where([data-rk-8bc5e5]) { background: var(--c-text-1); color: var(--c-bg); }

.dvpd__pager:where([data-rk-8bc5e5]) { max-width: 1040px; margin: clamp(3rem, 6vw, 4.5rem) auto 0; padding: 0 clamp(1rem, 3vw, 1.5rem); display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; }
.dvpd__key:where([data-rk-8bc5e5]) { display: flex; flex-direction: column; gap: 0.3rem; padding: 1.1rem 1.25rem; border: 1.5px solid var(--c-text-1); border-radius: 4px; color: var(--c-text-1); text-decoration: none; box-shadow: 0 4px 0 var(--c-text-1); transition: transform 0.18s ease, box-shadow 0.18s ease; }
.dvpd__key:hover:where([data-rk-8bc5e5]) { transform: translateY(2px); box-shadow: 0 2px 0 var(--c-text-1); }
.dvpd__key:where([data-rk-8bc5e5]) span:where([data-rk-8bc5e5]) { font-family: var(--font-mono); font-size: 0.7rem; text-transform: uppercase; letter-spacing: 0.06em; color: var(--c-text-3); }
.dvpd__key:where([data-rk-8bc5e5]) strong:where([data-rk-8bc5e5]) { font-size: 1.1rem; }
.dvpd__key--next:where([data-rk-8bc5e5]) { text-align: right; grid-column: 2; }
.dvpd:where([data-rk-8bc5e5]) :focus-visible:where([data-rk-8bc5e5]) { outline: 2px solid var(--c-text-1); outline-offset: 3px; }
@media (max-width: 860px) {
  .dvpd__wrap:where([data-rk-8bc5e5]) { grid-template-columns: 1fr; }
  .dvpd__spec:where([data-rk-8bc5e5]) { position: static; }
}
@media (max-width: 560px) { .dvpd__pager:where([data-rk-8bc5e5]) { grid-template-columns: 1fr; } .dvpd__key--next:where([data-rk-8bc5e5]) { grid-column: auto; } }