clean up the homepage

Author: mitchellh

AGENTS.md

@@ -1,5 +1,11 @@
 # Ghostty Website
 
-- Lint all code with `npm run lint` and fix all issues including warnings
+## Basics
+
 - Verify all changes with `npm run build`
+- Lint all code with `npm run lint` and fix all issues including warnings
 - The site should be fully static, no server-side rendering, functions, etc.
+
+## Code Style
+
+- All functions and top-level constants should be documented with comments

src/app/home-client.tsx src/app/HomeContent.tsxsrc/app/home-client.tsx renamed to src/app/HomeContent.tsx

@@ -5,14 +5,15 @@ import GridContainer from "@/components/grid-container";
 import { ButtonLink } from "@/components/link";
 import { P } from "@/components/text";
 import type { TerminalFontSize } from "@/components/terminal";
-import type { TerminalsMap } from "@/lib/fetch-terminal-content";
+import type { TerminalsMap } from "./terminal-data";
 import { useEffect, useState } from "react";
-import s from "./Home.module.css";
+import s from "./home-content.module.css";
 
 interface HomeClientProps {
   terminalData: TerminalsMap;
 }
 
+/** Tracks the current viewport size for responsive terminal sizing. */
 function useWindowSize() {
   const [width, setWidth] = useState(0);
   const [height, setHeight] = useState(0);
@@ -23,11 +24,13 @@ function useWindowSize() {
     }
     window.addEventListener("resize", updateSize);
     updateSize();
+
     return () => window.removeEventListener("resize", updateSize);
   }, []);
   return [width, height];
 }
 
+/** Renders the animated terminal hero and action links for the homepage. */
 export default function HomeClient({ terminalData }: HomeClientProps) {
   const animationFrames = Object.keys(terminalData)
     .filter((k) => {

src/app/Home.module.css src/app/home-content.module.csssrc/app/Home.module.css renamed to src/app/home-content.module.css

@@ -1,16 +1,16 @@
-import { loadAllTerminalFiles } from "@/lib/fetch-terminal-content";
+import HomeContent from "./HomeContent";
+import { loadAllTerminalFiles } from "./terminal-data";
 import type { Metadata } from "next";
-import HomeClient from "./home-client";
-
-export const dynamic = "force-static";
 
+/** Defines document metadata for the Ghostty homepage. */
 export const metadata: Metadata = {
   title: "Ghostty",
   description:
     "Ghostty is a fast, feature-rich, and cross-platform terminal emulator that uses platform-native UI and GPU acceleration.",
 };
 
+/** Loads homepage terminal data and renders the client-side home content. */
 export default async function HomePage() {
   const terminalData = await loadAllTerminalFiles("/home");
-  return <HomeClient terminalData={terminalData} />;
+  return <HomeContent terminalData={terminalData} />;
 }

src/app/page.tsx

@@ -1,11 +1,17 @@
 import { promises as fs } from "node:fs";
+
+/** Provides POSIX and path utilities for terminal file traversal. */
 const nodePath = require("node:path");
 
+/** Filesystem location for checked-in terminal snapshot data. */
 const TERMINALS_DIRECTORY = "./terminals";
+
+/** Extension used by terminal snapshot files. */
 const TERMINAL_CONTENT_FILE_EXTENSION = ".txt";
 
 export type TerminalsMap = { [k: string]: string[] };
 
+/** Loads terminal text files and returns them keyed by slug path. */
 export async function loadAllTerminalFiles(
   subdirectory?: string,
 ): Promise<TerminalsMap> {
@@ -29,6 +35,7 @@ export async function loadAllTerminalFiles(
   return Object.fromEntries(map);
 }
 
+/** Walks a directory recursively and returns full file paths. */
 async function collectAllFilesRecursively(root: string): Promise<string[]> {
   const files: string[] = [];
   const entries = await fs.readdir(root, { withFileTypes: true });