full keyboard navigation

src/App.tsx

@@ -6,7 +6,7 @@ import {
 	Notes,
 } from "@nsmr/pixelart-react";
 import { useEffect, useState } from "react";
-import { Link, Route, Routes, useParams } from "react-router-dom";
+import { Link, Route, Routes, useNavigate, useParams } from "react-router-dom";
 import { AskAI } from "@/components/ask-ai";
 import { ProjectListItem } from "@/components/ProjectListItem";
 import { TimeSince } from "@/components/time-since";
@@ -39,7 +39,10 @@ export default App;
 
 function Home() {
 	const isDevMode = import.meta.env.VITE_PUBLIC_DEV === "1";
+	const navigate = useNavigate();
 	const [asciiArt, setAsciiArt] = useState("");
+	const [activeIndex, setActiveIndex] = useState<number | null>(null);
+	const [hasPointerInteraction, setHasPointerInteraction] = useState(false);
 	const [asciiFile] = useState(
 		() => asciiFiles[Math.floor(Math.random() * asciiFiles.length)],
 	);
@@ -48,6 +51,9 @@ function Home() {
 			parseDate(b.metadata.date).getTime() -
 			parseDate(a.metadata.date).getTime(),
 	);
+	const visibleProjects = sortedProjects.filter(
+		(project) => isDevMode || !project.metadata.hidden,
+	);
 
 	useEffect(() => {
 		let isActive = true;
@@ -61,6 +67,78 @@ function Home() {
 		};
 	}, [asciiFile]);
 
+	useEffect(() => {
+		setActiveIndex((prev) => {
+			if (visibleProjects.length === 0) return null;
+			if (prev === null) return null;
+			return Math.min(prev, visibleProjects.length - 1);
+		});
+	}, [visibleProjects.length]);
+
+	useEffect(() => {
+		if (visibleProjects.length === 0) return;
+
+		const handleKeyDown = (event: KeyboardEvent) => {
+			if (event.defaultPrevented || event.isComposing) return;
+			if (event.metaKey || event.ctrlKey || event.altKey) return;
+			if (isInteractiveTarget(event.target)) return;
+
+			const key = event.key.length === 1 ? event.key.toLowerCase() : event.key;
+			const isDesktop = window.matchMedia("(min-width: 768px)").matches;
+			const columns = isDesktop ? 2 : 1;
+
+			let delta = 0;
+			if (key === "ArrowLeft" || key === "h") delta = -1;
+			if (key === "ArrowRight" || key === "l") delta = 1;
+			if (key === "ArrowUp" || key === "k") delta = -columns;
+			if (key === "ArrowDown" || key === "j") delta = columns;
+
+			if (delta !== 0) {
+				event.preventDefault();
+				setActiveIndex((prev) => {
+					if (prev === null) return 0;
+					const next = Math.max(
+						0,
+						Math.min(visibleProjects.length - 1, prev + delta),
+					);
+					return next;
+				});
+				return;
+			}
+
+			if (key === "Enter") {
+				if (activeIndex === null) return;
+				event.preventDefault();
+				const target = visibleProjects[activeIndex];
+				if (!target) return;
+				navigate(`/projects/${target.metadata.slug}`);
+			}
+		};
+
+		window.addEventListener("keydown", handleKeyDown);
+		return () => {
+			window.removeEventListener("keydown", handleKeyDown);
+		};
+	}, [activeIndex, navigate, visibleProjects]);
+
+	useEffect(() => {
+		const enablePointerInteraction = () => {
+			setHasPointerInteraction(true);
+		};
+
+		window.addEventListener("pointermove", enablePointerInteraction, {
+			once: true,
+		});
+		window.addEventListener("pointerdown", enablePointerInteraction, {
+			once: true,
+		});
+
+		return () => {
+			window.removeEventListener("pointermove", enablePointerInteraction);
+			window.removeEventListener("pointerdown", enablePointerInteraction);
+		};
+	}, []);
+
 	return (
 		<div className="min-h-dvh flex flex-col items-center gap-2 text-2xl px-6 py-10">
 			<div className="flex flex-col items-center gap-4 mb-4">
@@ -103,24 +181,44 @@ function Home() {
 				</div>
 			</div>
 			<div className="w-full max-w-5xl grid grid-cols-1 md:grid-cols-2 gap-4">
-				{sortedProjects.map((project) => (
+				{visibleProjects.map((project, index) => (
 					<ProjectListItem
 						key={project.metadata.slug}
 						metadata={project.metadata}
 						isDevMode={isDevMode}
+						isActive={activeIndex !== null && index === activeIndex}
+						enableHover={hasPointerInteraction}
 					/>
 				))}
 			</div>
-			<div className="w-full max-w-5xl flex items-center justify-between gap-4">
+			<div className="w-full max-w-5xl grid grid-cols-1 md:grid-cols-[1fr_auto_1fr] items-center gap-3 md:gap-4">
 				<div className="flex items-center gap-6">
 					<AskAI name="me" inline />
 				</div>
-				<ThemeToggle />
+				<p className="text-xs text-fg/80 text-center text-pretty">
+					arrows or hjkl, then enter
+				</p>
+				<div className="justify-self-center md:justify-self-end">
+					<ThemeToggle />
+				</div>
 			</div>
 		</div>
 	);
 }
 
+function isInteractiveTarget(target: EventTarget | null): boolean {
+	if (!(target instanceof HTMLElement)) return false;
+	if (target.isContentEditable) return true;
+	const tagName = target.tagName;
+	return (
+		tagName === "INPUT" ||
+		tagName === "TEXTAREA" ||
+		tagName === "SELECT" ||
+		tagName === "BUTTON" ||
+		tagName === "A"
+	);
+}
+
 function ProjectRoute() {
 	const { slug } = useParams();
 	if (!slug || !projects[slug]) return <NotFound />;

src/components/ProjectListItem.tsx

@@ -5,9 +5,13 @@ import type { ProjectMetadata } from "@/projects";
 export function ProjectListItem({
 	metadata,
 	isDevMode = false,
+	isActive = false,
+	enableHover = true,
 }: {
 	metadata: ProjectMetadata;
 	isDevMode?: boolean;
+	isActive?: boolean;
+	enableHover?: boolean;
 }) {
 	const tags = metadata.tags ? [...metadata.tags].sort() : [];
 	if (metadata.hidden && !isDevMode) return null;
@@ -16,7 +20,9 @@ export function ProjectListItem({
 		<Link
 			to={`/projects/${metadata.slug}`}
 			className={cn(
-				"group relative block flex flex-col justify-between transition-colors duration-200 border-2 hover:border-accent",
+				"group relative block flex flex-col justify-between transition-colors duration-200 border-2",
+				enableHover && "hover:border-accent",
+				isActive && "border-accent",
 				isDevMode && metadata.hidden && "border-dashed border-accent",
 			)}
 			data-tags={tags.join(",")}

src/components/ProjectPage.tsx

@@ -1,6 +1,6 @@
 import { Home } from "@nsmr/pixelart-react";
-import type { ReactNode } from "react";
-import { Link } from "react-router-dom";
+import { type ReactNode, useEffect } from "react";
+import { Link, useNavigate } from "react-router-dom";
 import { getProjectPrompt } from "@/lib/constants";
 import type { ProjectMetadata } from "@/projects";
 import { AskAI } from "./ask-ai";
@@ -12,10 +12,36 @@ export function ProjectPage({
 	metadata: ProjectMetadata;
 	children: ReactNode;
 }) {
+	const navigate = useNavigate();
 	const tags = metadata.tags ? [...metadata.tags].sort() : [];
 
+	useEffect(() => {
+		const handleKeyDown = (event: KeyboardEvent) => {
+			if (event.defaultPrevented || event.isComposing) return;
+			if (event.metaKey || event.ctrlKey || event.altKey) return;
+			if (isInteractiveTarget(event.target)) return;
+
+			if (
+				event.key === "Escape" ||
+				event.key === "Backspace" ||
+				event.key === "q"
+			) {
+				event.preventDefault();
+				navigate("/");
+			}
+		};
+
+		window.addEventListener("keydown", handleKeyDown);
+		return () => {
+			window.removeEventListener("keydown", handleKeyDown);
+		};
+	}, [navigate]);
+
 	return (
-		<div className="mx-auto w-full max-w-4xl px-6 py-4 text-md border my-8">
+		<div className="relative mx-auto w-full max-w-4xl px-6 py-4 text-md border my-8">
+			<p className="absolute top-4 right-6 text-xs text-fg/75">
+				esc or backspace to go back
+			</p>
 			<Link
 				to="/"
 				className="inline-flex items-center text-sm hover:text-accent mb-4"
@@ -37,14 +63,16 @@ export function ProjectPage({
 						<div className="w-24 h-24 mb-2 border rounded" />
 					)}
 				</div>
-				<AskAI
-					name={metadata.title}
-					prompt={getProjectPrompt(
-						metadata.title,
-						metadata.description,
-						metadata.slug,
-					)}
-				/>
+				<div className="ml-auto flex flex-col items-end text-right">
+					<AskAI
+						name={metadata.title}
+						prompt={getProjectPrompt(
+							metadata.title,
+							metadata.description,
+							metadata.slug,
+						)}
+					/>
+				</div>
 			</div>
 			{metadata.url ? (
 				<div className="flex flex-col mb-2">
@@ -112,3 +140,16 @@ export function ProjectPage({
 		</div>
 	);
 }
+
+function isInteractiveTarget(target: EventTarget | null): boolean {
+	if (!(target instanceof HTMLElement)) return false;
+	if (target.isContentEditable) return true;
+	const tagName = target.tagName;
+	return (
+		tagName === "INPUT" ||
+		tagName === "TEXTAREA" ||
+		tagName === "SELECT" ||
+		tagName === "BUTTON" ||
+		tagName === "A"
+	);
+}