diff --git a/frontend/README.md b/frontend/README.md
new file mode 100644
index 0000000..7bef6b2
--- /dev/null
+++ b/frontend/README.md
@@ -0,0 +1,12 @@
+# GemHub frontend
+
+Create React App 5 with React 18 and TypeScript 4. The checked-in `tsconfig.json` and `src/react-app-env.d.ts` are required for CRA to recognize the TypeScript entry point and App module.
+
+```bash
+npm ci --ignore-scripts --no-audit --no-fund
+npm run lint
+CI=true npm run build
+npm start
+```
+
+The development proxy targets the Ruby API at `http://localhost:4567`. Build and lint checks do not verify that service or marketplace mutations. Create Gem, Sandbox, and Benchmarks currently contain coming-soon interfaces; a successful build does not make them implemented features.
diff --git a/frontend/src/api/client.ts b/frontend/src/api/client.ts
index bef7181..c0935b3 100644
--- a/frontend/src/api/client.ts
+++ b/frontend/src/api/client.ts
@@ -7,11 +7,9 @@ import {
   GemResponse,
   CreateGemRequest,
   UpdateGemRequest,
-  Rating,
   RatingsResponse,
   RatingResponse,
   CreateRatingRequest,
-  Badge,
   BadgesResponse,
   BadgeResponse,
   CreateBadgeRequest,
diff --git a/frontend/src/components/Layout.tsx b/frontend/src/components/Layout.tsx
index 0926e26..d034c41 100644
--- a/frontend/src/components/Layout.tsx
+++ b/frontend/src/components/Layout.tsx
@@ -121,9 +121,9 @@ function Layout({ children }: LayoutProps) {
 
         {/* Navigation */}
         <nav className="flex flex-1 flex-col">
-          <ul role="list" className="flex flex-1 flex-col gap-y-7">
+          <ul className="flex flex-1 flex-col gap-y-7">
             <li>
-              <ul role="list" className="-mx-2 space-y-1">
+              <ul className="-mx-2 space-y-1">
                 {navigation.map((item) => {
                   const current = location.pathname === item.href;
                   return (
diff --git a/frontend/src/pages/Dashboard.tsx b/frontend/src/pages/Dashboard.tsx
index c84f9e7..0162024 100644
--- a/frontend/src/pages/Dashboard.tsx
+++ b/frontend/src/pages/Dashboard.tsx
@@ -9,7 +9,7 @@ import {
   EyeIcon,
   CalendarIcon,
 } from '@heroicons/react/24/outline';
-import apiClient, { apiKeys, formatDownloads, formatRating, formatDate } from '../api/client';
+import apiClient, { apiKeys, formatDownloads, formatRating } from '../api/client';
 import { Gem } from '../types';
 
 function Dashboard() {
diff --git a/frontend/src/react-app-env.d.ts b/frontend/src/react-app-env.d.ts
new file mode 100644
index 0000000..6431bc5
--- /dev/null
+++ b/frontend/src/react-app-env.d.ts
@@ -0,0 +1 @@
+/// <reference types="react-scripts" />
diff --git a/frontend/tsconfig.json b/frontend/tsconfig.json
new file mode 100644
index 0000000..9d379a3
--- /dev/null
+++ b/frontend/tsconfig.json
@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "es5",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "noFallthroughCasesInSwitch": true,
+    "module": "esnext",
+    "moduleResolution": "node",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "noEmit": true,
+    "jsx": "react-jsx"
+  },
+  "include": ["src"]
+}