Skip to main content

Feature: Projects Gallery (/projects)

Purpose​

  • Feature name: Projects gallery (/projects)
  • Why this feature exists: Offer a fast, scannable entry point to project evidence and gold-standard examples.

Scope​

In scope​

  • featured project grid with status badges
  • full project list from the registry
  • quick links to repo/demo when available

Out of scope​

  • project detail evidence rendering (covered in project detail feature)
  • registry validation logic (covered in evidence-first content model)

Prereqs / Inputs​

  • project registry populated and validated
  • docs base URL configured for evidence links

Procedure / Content​

Feature summary​

  • Feature name: Projects gallery (/projects)
  • Feature group: Core pages and reviewer journey
  • Technical summary: Uses registry data to render featured cards and a complete list, with tag and status metadata.
  • Low-tech summary: A project directory that highlights the best entry points and lists everything else.

Feature in action​

  • Where to see it working: /projects in the deployed app or http://localhost:3000/projects during pnpm dev.

Confirmation Process​

Manual​

  • Steps: Open /projects, click a featured project and a non-featured project.
  • What to look for: Status badges render, tags display, detail links resolve.
  • Artifacts or reports to inspect: Registry validation in CI and Playwright route coverage.

Tests​

Potential behavior if broken or misconfigured​

  • Featured list empty because registry tags or status are missing.
  • Detail links route to 404 due to invalid slugs.

Long-term maintenance notes​

  • Keep featured list aligned with reviewer priorities.
  • Maintain tag taxonomy consistency as projects expand.

Dependencies, libraries, tools​

  • Next.js App Router
  • React
  • Tailwind CSS

Source code references (GitHub URLs)​

ADRs​

Runbooks​

  • None.

Additional internal references​

Validation / Expected outcomes​

  • Featured projects render with correct status and tags.
  • All projects list matches the registry source of truth.

Failure modes / Troubleshooting​

  • Missing projects: validate the registry data and rebuild.
  • Broken slugs: run registry validation and fix duplicates.

References​

  • None.