From 12bb04e127abbfa350193e2630220810fdf078f4 Mon Sep 17 00:00:00 2001
From: Daniel Roe <daniel@roe.dev>
Date: Wed, 26 Aug 2026 08:10:01 +0000
Subject: [PATCH] feat: move projects to atproto

---
 .gitignore                                    |   3 +
 app/components/TheProjects.server.vue         |  63 +-
 app/components/admin/ProjectCategoryForm.vue  |  92 +++
 app/components/admin/ProjectDraggable.vue     |  95 +++
 app/components/admin/ProjectForm.vue          | 438 ++++++++++++
 app/components/admin/Shell.vue                |   1 +
 app/pages/admin/index.vue                     |   6 +-
 .../admin/projects/categories/[rkey].vue      |  53 ++
 app/pages/admin/projects/categories/new.vue   |  23 +
 app/pages/admin/projects/index.vue            | 184 ++++++
 app/pages/admin/projects/items/[rkey].vue     |  54 ++
 app/pages/admin/projects/items/new.vue        |  23 +
 lexicons/README.md                            |  13 +-
 lexicons/community/lexicon/app/defs.json      | 295 +++++++++
 lexicons/dev/roe/project.json                 |  70 ++
 lexicons/dev/roe/projectCategory.json         |  31 +
 modules/projects.ts                           |  94 ---
 nuxt.config.ts                                |   1 +
 package.json                                  |   3 +-
 scripts/migrate-projects-to-atproto.ts        | 276 ++++++++
 .../admin/project-categories/[rkey].delete.ts |   6 +
 .../admin/project-categories/[rkey].get.ts    |   6 +
 .../admin/project-categories/[rkey].put.ts    |   7 +
 .../api/admin/project-categories/index.get.ts |   8 +
 .../admin/project-categories/index.post.ts    |   7 +
 server/api/admin/projects/[rkey].delete.ts    |   6 +
 server/api/admin/projects/[rkey].get.ts       |   6 +
 server/api/admin/projects/[rkey].put.ts       |   7 +
 server/api/admin/projects/index.get.ts        |   8 +
 server/api/admin/projects/index.post.ts       |   7 +
 server/api/admin/stats.get.ts                 |   6 +-
 server/api/projects.get.ts                    |   5 +
 server/routes/projects.md.get.ts              |  15 +-
 server/utils/admin/oauth.ts                   |   2 +
 server/utils/cms/projects.ts                  |  97 +++
 shared/cms/projects.ts                        |  25 +
 shared/lex/community.ts                       |   5 +
 shared/lex/community/lexicon.ts               |   5 +
 shared/lex/community/lexicon/app.ts           |   5 +
 shared/lex/community/lexicon/app/defs.defs.ts | 621 ++++++++++++++++++
 shared/lex/community/lexicon/app/defs.ts      |   5 +
 shared/lex/dev/roe.ts                         |   2 +
 shared/lex/dev/roe/project.defs.ts            | 110 ++++
 shared/lex/dev/roe/project.ts                 |   6 +
 shared/lex/dev/roe/projectCategory.defs.ts    |  58 ++
 shared/lex/dev/roe/projectCategory.ts         |   6 +
 shared/lex/index.ts                           |   1 +
 shared/project-icons.ts                       |  41 ++
 test/unit/bundle.spec.ts                      |   4 +-
 uno.config.ts                                 |   4 +-
 50 files changed, 2753 insertions(+), 156 deletions(-)
 create mode 100644 app/components/admin/ProjectCategoryForm.vue
 create mode 100644 app/components/admin/ProjectDraggable.vue
 create mode 100644 app/components/admin/ProjectForm.vue
 create mode 100644 app/pages/admin/projects/categories/[rkey].vue
 create mode 100644 app/pages/admin/projects/categories/new.vue
 create mode 100644 app/pages/admin/projects/index.vue
 create mode 100644 app/pages/admin/projects/items/[rkey].vue
 create mode 100644 app/pages/admin/projects/items/new.vue
 create mode 100644 lexicons/community/lexicon/app/defs.json
 create mode 100644 lexicons/dev/roe/project.json
 create mode 100644 lexicons/dev/roe/projectCategory.json
 delete mode 100644 modules/projects.ts
 create mode 100644 scripts/migrate-projects-to-atproto.ts
 create mode 100644 server/api/admin/project-categories/[rkey].delete.ts
 create mode 100644 server/api/admin/project-categories/[rkey].get.ts
 create mode 100644 server/api/admin/project-categories/[rkey].put.ts
 create mode 100644 server/api/admin/project-categories/index.get.ts
 create mode 100644 server/api/admin/project-categories/index.post.ts
 create mode 100644 server/api/admin/projects/[rkey].delete.ts
 create mode 100644 server/api/admin/projects/[rkey].get.ts
 create mode 100644 server/api/admin/projects/[rkey].put.ts
 create mode 100644 server/api/admin/projects/index.get.ts
 create mode 100644 server/api/admin/projects/index.post.ts
 create mode 100644 server/api/projects.get.ts
 create mode 100644 server/utils/cms/projects.ts
 create mode 100644 shared/cms/projects.ts
 create mode 100644 shared/lex/community.ts
 create mode 100644 shared/lex/community/lexicon.ts
 create mode 100644 shared/lex/community/lexicon/app.ts
 create mode 100644 shared/lex/community/lexicon/app/defs.defs.ts
 create mode 100644 shared/lex/community/lexicon/app/defs.ts
 create mode 100644 shared/lex/dev/roe/project.defs.ts
 create mode 100644 shared/lex/dev/roe/project.ts
 create mode 100644 shared/lex/dev/roe/projectCategory.defs.ts
 create mode 100644 shared/lex/dev/roe/projectCategory.ts
 create mode 100644 shared/project-icons.ts

diff --git a/.gitignore b/.gitignore
index 0dc76385..66434651 100644
--- a/.gitignore
+++ b/.gitignore
@@ -112,3 +112,6 @@ credentials.json
 
 downloads/
 .env*.local
+
+# one-shot projects migration manifest
+scripts/.projects-migration-state.json
diff --git a/app/components/TheProjects.server.vue b/app/components/TheProjects.server.vue
index de890edd..7d5f18a2 100644
--- a/app/components/TheProjects.server.vue
+++ b/app/components/TheProjects.server.vue
@@ -1,58 +1,23 @@
 <script setup lang="ts">
-import { projects } from '#build/projects.mjs'
+import type { ProjectCategory } from '#shared/cms/projects'
+
+const { data } = await useFetch<ProjectCategory[]>('/api/projects')
 
 function slug (name: string) {
   return name.toLowerCase().replace(/[\s/]+/g, '-')
 }
-/**
- i-ri:magic-line
- i-ri:font-size
- i-ri:css3-line
- i-ri:archive-stack-line
- i-ri:font-family
- i-ri:route-line
- i-ri:braces-line
- i-ri:shield-keyhole-line
- i-ri:walk-line
- i-ri:text-spacing
- i-ri:error-warning-line
- i-ri:server-line
- i-ri:exchange-line
- i-ri:cpu-line
- i-ri:list-ordered
- i-ri:archive-line
- i-ri:filter-off-line
- i-ri:bubble-chart-line
- i-ri:database-2-line
- i-ri:database-line
- i-ri:link
- i-ri:vidicon-line
- i-ri:flashlight-line
- i-ri:arrow-up-circle-line
- i-ri:shield-check-line
- i-ri:dashboard-3-line
- i-ri:folder-download-line
- i-ri:toggle-line
- i-ri:file-zip-line
- i-ri:flashlight-line
- i-ri:refresh-line
- i-ri:archive-stack-line
- i-ri:keyboard-line
- i-ri:restaurant-line
- i-ri:reactjs-line
-*/
 </script>
 
 <template>
   <div>
     <section
-      v-for="category in projects"
-      :id="slug(category.category)"
-      :key="category.category"
+      v-for="category in data || []"
+      :id="slug(category.title)"
+      :key="category._id"
       class="mb-16"
     >
       <h2 class="text-lg">
-        {{ category.category }}
+        {{ category.title }}
       </h2>
 
       <div class="w-screen -mx-4 md:-mx-12 overflow-visible mt-4">
@@ -69,7 +34,7 @@ function slug (name: string) {
             ]"
           >
             <a
-              :href="item.url || item.repo"
+              :href="item.url || item.repo || undefined"
               target="_blank"
               rel="noopener noreferrer"
               class="flex flex-grow f-ring-accent"
@@ -80,14 +45,14 @@ function slug (name: string) {
                 v-if="item.image"
                 class="relative flex items-center justify-center bg-gray-100 dark:bg-gray-900 aspect-video overflow-hidden"
               >
-                <NuxtImg
-                  :src="item.image"
-                  :alt="`Screenshot of ${item.name}`"
+                <img
+                  :src="item.image.url"
+                  :alt="item.image.alt"
                   loading="lazy"
-                  width="640"
-                  height="360"
+                  :width="item.image.width ?? 640"
+                  :height="item.image.height ?? 360"
                   class="w-full h-full object-cover"
-                />
+                >
                 <span
                   v-if="item.archived"
                   class="absolute top-2 left-2 px-2 py-0.5 bg-background/80 backdrop-blur-sm rounded text-[0.625rem] uppercase tracking-[0.15rem]"
diff --git a/app/components/admin/ProjectCategoryForm.vue b/app/components/admin/ProjectCategoryForm.vue
new file mode 100644
index 00000000..b5840287
--- /dev/null
+++ b/app/components/admin/ProjectCategoryForm.vue
@@ -0,0 +1,92 @@
+<script setup lang="ts">
+import type { dev } from '#shared/lex'
+import type { Loose, Strict } from '#shared/cms/strict'
+
+type ProjectCategoryValue = Omit<Loose<Strict<dev.roe.projectCategory.Main>>, '$type'>
+
+const props = defineProps<{
+  initial?: Partial<ProjectCategoryValue>
+  submitLabel?: string
+}>()
+
+const emit = defineEmits<{
+  (e: 'submit', value: ProjectCategoryValue): void
+}>()
+
+const form = reactive({
+  title: props.initial?.title ?? '',
+  order: props.initial?.order ?? 100,
+})
+
+const submitting = ref(false)
+const error = ref<string | null>(null)
+
+async function onSubmit () {
+  error.value = null
+  submitting.value = true
+  try {
+    const value: ProjectCategoryValue = {
+      title: form.title,
+      order: form.order,
+      ...(props.initial?.createdAt ? { createdAt: props.initial.createdAt } : { createdAt: new Date().toISOString() }),
+    }
+    emit('submit', value)
+  }
+  catch (err) {
+    error.value = err instanceof Error ? err.message : String(err)
+  }
+  finally {
+    submitting.value = false
+  }
+}
+</script>
+
+<template>
+  <form
+    class="flex flex-col gap-4 max-w-lg"
+    @submit.prevent="onSubmit"
+  >
+    <p
+      v-if="error"
+      class="text-sm text-red-500"
+    >
+      {{ error }}
+    </p>
+
+    <label class="flex flex-col gap-1 text-sm">
+      <span class="text-muted">Title <span class="text-red-500">*</span></span>
+      <input
+        v-model="form.title"
+        required
+        type="text"
+        class="bg-accent px-3 py-2"
+      >
+    </label>
+
+    <label class="flex flex-col gap-1 text-sm">
+      <span class="text-muted">Order</span>
+      <input
+        v-model.number="form.order"
+        type="number"
+        class="bg-accent px-3 py-2"
+      >
+      <span class="text-xs text-muted">Lower numbers render first. Defaults to 100.</span>
+    </label>
+
+    <div class="flex gap-3">
+      <button
+        type="submit"
+        :disabled="submitting"
+        class="bg-primary text-background px-4 py-2 hover:bg-primary/90 transition-colors disabled:opacity-60"
+      >
+        {{ submitting ? 'Saving…' : (submitLabel ?? 'Save') }}
+      </button>
+      <NuxtLink
+        to="/admin/projects"
+        class="text-muted hover:text-primary self-center text-sm"
+      >
+        Cancel
+      </NuxtLink>
+    </div>
+  </form>
+</template>
diff --git a/app/components/admin/ProjectDraggable.vue b/app/components/admin/ProjectDraggable.vue
new file mode 100644
index 00000000..f2229f52
--- /dev/null
+++ b/app/components/admin/ProjectDraggable.vue
@@ -0,0 +1,95 @@
+<script setup lang="ts">
+import { useDragAndDrop } from '@formkit/drag-and-drop/vue'
+import { community } from '#shared/lex'
+import type { dev } from '#shared/lex'
+import type { Loose } from '#shared/cms/strict'
+
+interface ProjectEntry {
+  rkey: string
+  uri: string
+  cid: string
+  value: Loose<dev.roe.project.Main>
+}
+
+const props = defineProps<{
+  items: ProjectEntry[]
+}>()
+
+const emit = defineEmits<{
+  (e: 'reorder', items: ProjectEntry[]): void
+  (e: 'remove', rkey: string, name: string): void
+}>()
+
+const [parent, values] = useDragAndDrop<ProjectEntry>([...props.items], {
+  dragHandle: '[data-drag-handle]',
+})
+
+const { defs } = community.lexicon.app
+
+function isArchived (item: ProjectEntry) {
+  return item.value.status === defs.unmaintained.value || item.value.status === defs.discontinued.value
+}
+
+watch(() => props.items, next => {
+  // Sync local list when the parent re-fetches (e.g. after a save).
+  values.value = [...next]
+})
+
+// Emit reorder when the order actually changes vs incoming props.
+watch(values, next => {
+  const before = props.items.map(i => i.rkey).join(',')
+  const after = next.map(i => i.rkey).join(',')
+  if (before !== after) emit('reorder', next)
+}, { deep: false })
+</script>
+
+<template>
+  <ul
+    ref="parent"
+    class="flex flex-col gap-2"
+  >
+    <li
+      v-for="item in values"
+      :key="item.rkey"
+      class="flex items-center gap-3 bg-accent px-3 py-2"
+    >
+      <span
+        data-drag-handle
+        class="cursor-grab text-muted select-none"
+      >
+        <span aria-hidden="true">⋮⋮</span>
+        <span class="sr-only">Drag to reorder</span>
+      </span>
+      <div class="flex-grow min-w-0">
+        <NuxtLink
+          :to="`/admin/projects/items/${item.rkey}`"
+          class="block underline-offset-4 hover:underline truncate"
+        >
+          {{ item.value.name }}<span
+            v-if="isArchived(item)"
+            class="text-xs text-muted"
+          > · archived</span>
+        </NuxtLink>
+        <div
+          v-if="item.value.description"
+          class="text-sm text-muted truncate"
+        >
+          {{ item.value.description }}
+        </div>
+      </div>
+      <button
+        type="button"
+        class="text-sm text-muted hover:text-red-500 transition-colors"
+        @click="emit('remove', item.rkey, item.value.name)"
+      >
+        Delete
+      </button>
+    </li>
+  </ul>
+  <p
+    v-if="!values.length"
+    class="text-muted text-xs"
+  >
+    No projects in this category.
+  </p>
+</template>
diff --git a/app/components/admin/ProjectForm.vue b/app/components/admin/ProjectForm.vue
new file mode 100644
index 00000000..d7c4bc22
--- /dev/null
+++ b/app/components/admin/ProjectForm.vue
@@ -0,0 +1,438 @@
+<script setup lang="ts">
+import { community } from '#shared/lex'
+import type { com, dev } from '#shared/lex'
+import { ref } from 'vue'
+import { blobUrlFor, cidFromBlob } from '#shared/cms/blob'
+import { projectIcons } from '#shared/project-icons'
+import type { Loose, Strict } from '#shared/cms/strict'
+
+type ProjectValue = Omit<Loose<Strict<dev.roe.project.Main>>, '$type'>
+type ProjectImage = NonNullable<ProjectValue['images']>[number]
+
+interface ProjectCategoryEntry {
+  rkey: string
+  uri: string
+  cid: string
+  value: dev.roe.projectCategory.Main
+}
+
+const props = defineProps<{
+  initial?: Partial<ProjectValue>
+  submitLabel?: string
+}>()
+
+const emit = defineEmits<{
+  (e: 'submit', value: ProjectValue): void
+}>()
+
+const { defs } = community.lexicon.app
+
+const LINK_ROLES = [
+  { value: '', label: 'No role' },
+  { value: defs.linkRoleWebsite.value, label: 'Website' },
+  { value: defs.linkRoleSourceCode.value, label: 'Source code' },
+  { value: defs.linkRoleDocs.value, label: 'Docs' },
+  { value: defs.linkRoleChangelog.value, label: 'Changelog' },
+  { value: defs.linkRoleSupport.value, label: 'Support' },
+  { value: defs.linkRoleStatus.value, label: 'Status' },
+]
+
+const STATUSES = [
+  { value: '', label: 'Unset' },
+  { value: defs.released.value, label: 'Released' },
+  { value: defs.preview.value, label: 'Preview' },
+  { value: defs.unreleased.value, label: 'Unreleased' },
+  { value: defs.unmaintained.value, label: 'Unmaintained (renders as archived)' },
+  { value: defs.discontinued.value, label: 'Discontinued (renders as archived)' },
+]
+
+const { data: categories } = useAdminFetch<ProjectCategoryEntry[]>('/api/admin/project-categories', { default: () => [] })
+
+const { public: publicConfig } = useRuntimeConfig()
+const pdsService = publicConfig.atproto?.service || null
+const pdsDid = publicConfig.atproto?.did || null
+
+/**
+ * The record holds `images` as an array, but the card only ever renders one
+ * screenshot, so the editor exposes a single image and writes it back as a
+ * one-item array tagged `purposeScreenshot`.
+ */
+const initialImage = props.initial?.images?.find(i => i.purpose === defs.purposeScreenshot.value) ?? props.initial?.images?.[0]
+
+const form = reactive({
+  categoryUri: props.initial?.category?.uri ?? '',
+  name: props.initial?.name ?? '',
+  description: props.initial?.description ?? '',
+  links: (props.initial?.links ?? []).map(l => ({ uri: l.uri, label: l.label ?? '', role: l.role ?? '' })),
+  status: props.initial?.status ?? '',
+  icon: props.initial?.icon ?? '',
+  order: props.initial?.order ?? 100,
+  image: initialImage?.image,
+  imageAlt: initialImage?.alt ?? '',
+  aspectRatio: initialImage?.aspectRatio,
+})
+
+/**
+ * Only safelisted icons render on the site, so the picker offers those. An icon
+ * already on the record is kept as an option even if it has since been dropped
+ * from the safelist, so editing a project can't silently discard it.
+ */
+const iconOptions = computed(() => {
+  const icons: string[] = [...projectIcons]
+  if (form.icon && !icons.includes(form.icon)) icons.unshift(form.icon)
+  return icons
+})
+
+const localPreviewUrl = ref<string | null>(null)
+onBeforeUnmount(() => {
+  if (localPreviewUrl.value) URL.revokeObjectURL(localPreviewUrl.value)
+})
+
+const submitting = ref(false)
+const error = ref<string | null>(null)
+
+const imageUrl = computed(() => {
+  if (localPreviewUrl.value) return localPreviewUrl.value
+  if (!form.image || !pdsService || !pdsDid) return null
+  const cid = cidFromBlob(form.image)
+  if (!cid) return null
+  return blobUrlFor(pdsService, pdsDid, cid)
+})
+
+async function onImageChange (e: Event) {
+  const file = (e.target as HTMLInputElement).files?.[0]
+  if (!file) return
+
+  if (localPreviewUrl.value) URL.revokeObjectURL(localPreviewUrl.value)
+  localPreviewUrl.value = URL.createObjectURL(file)
+
+  const buf = new Uint8Array(await file.arrayBuffer())
+  try {
+    const [uploaded, clientAspectRatio] = await Promise.all([
+      $fetch<{
+        blob: NonNullable<ProjectImage['image']>
+        aspectRatio?: { width: number, height: number }
+      }>('/api/admin/blobs', {
+        method: 'POST',
+        body: buf,
+        headers: { 'content-type': file.type || 'application/octet-stream' },
+      }),
+      probeImageAspectRatio(file),
+    ])
+    form.image = uploaded.blob
+    form.aspectRatio = clientAspectRatio ?? uploaded.aspectRatio
+    if (!form.imageAlt && form.name) form.imageAlt = `Screenshot of ${form.name}`
+  }
+  catch (err) {
+    error.value = err instanceof Error ? err.message : String(err)
+    if (localPreviewUrl.value) {
+      URL.revokeObjectURL(localPreviewUrl.value)
+      localPreviewUrl.value = null
+    }
+  }
+}
+
+function clearImage () {
+  form.image = undefined
+  form.aspectRatio = undefined
+  form.imageAlt = ''
+  if (localPreviewUrl.value) {
+    URL.revokeObjectURL(localPreviewUrl.value)
+    localPreviewUrl.value = null
+  }
+}
+
+function addLink () {
+  form.links.push({ uri: '', label: '', role: '' })
+}
+
+function removeLink (i: number) {
+  form.links.splice(i, 1)
+}
+
+async function onSubmit () {
+  error.value = null
+  submitting.value = true
+  try {
+    const category = (categories.value ?? []).find(c => c.uri === form.categoryUri)
+    if (!category) {
+      error.value = 'Please pick a category.'
+      submitting.value = false
+      return
+    }
+    if (form.image && !form.imageAlt) {
+      error.value = 'Please describe the image for screen reader users.'
+      submitting.value = false
+      return
+    }
+    const categoryRef: Loose<com.atproto.repo.strongRef.Main> = { uri: category.uri, cid: category.cid }
+
+    const links = form.links
+      .filter(l => l.uri)
+      .map(l => ({
+        $type: 'community.lexicon.app.defs#link' as const,
+        uri: l.uri,
+        ...(l.label ? { label: l.label } : {}),
+        ...(l.role ? { role: l.role } : {}),
+      }))
+
+    const value: ProjectValue = {
+      category: categoryRef,
+      name: form.name,
+      ...(form.description ? { description: form.description } : {}),
+      ...(links.length ? { links } : {}),
+      ...(form.image
+        ? {
+            images: [{
+              $type: 'community.lexicon.app.defs#image' as const,
+              purpose: defs.purposeScreenshot.value,
+              image: form.image,
+              alt: form.imageAlt,
+              ...(form.aspectRatio ? { aspectRatio: form.aspectRatio } : {}),
+            }],
+          }
+        : {}),
+      ...(form.status ? { status: form.status } : {}),
+      ...(form.icon ? { icon: form.icon } : {}),
+      order: form.order,
+      ...(props.initial?.createdAt ? { createdAt: props.initial.createdAt } : { createdAt: new Date().toISOString() }),
+    }
+    emit('submit', value)
+  }
+  catch (err) {
+    error.value = err instanceof Error ? err.message : String(err)
+  }
+  finally {
+    submitting.value = false
+  }
+}
+</script>
+
+<template>
+  <form
+    class="flex flex-col gap-4 max-w-2xl"
+    @submit.prevent="onSubmit"
+  >
+    <p
+      v-if="error"
+      class="text-sm text-red-500"
+    >
+      {{ error }}
+    </p>
+
+    <label class="flex flex-col gap-1 text-sm">
+      <span class="text-muted">Category <span class="text-red-500">*</span></span>
+      <select
+        v-model="form.categoryUri"
+        required
+        class="bg-accent px-3 py-2"
+      >
+        <option value="">
+          - pick a category -
+        </option>
+        <option
+          v-for="c in categories ?? []"
+          :key="c.uri"
+          :value="c.uri"
+        >
+          {{ c.value.title }}
+        </option>
+      </select>
+    </label>
+
+    <label class="flex flex-col gap-1 text-sm">
+      <span class="text-muted">Name <span class="text-red-500">*</span></span>
+      <input
+        v-model="form.name"
+        required
+        type="text"
+        class="bg-accent px-3 py-2"
+      >
+    </label>
+
+    <label class="flex flex-col gap-1 text-sm">
+      <span class="text-muted">Description</span>
+      <textarea
+        v-model="form.description"
+        rows="3"
+        class="bg-accent px-3 py-2"
+      />
+    </label>
+
+    <div class="flex flex-col gap-2 text-sm">
+      <span class="text-muted">Links</span>
+      <div
+        v-for="(link, i) in form.links"
+        :key="i"
+        class="flex gap-2 items-center"
+      >
+        <input
+          v-model="form.links[i]!.uri"
+          type="url"
+          placeholder="https://…"
+          class="bg-accent px-3 py-2 flex-grow"
+          :aria-label="`Link ${i + 1} URL`"
+        >
+        <input
+          v-model="form.links[i]!.label"
+          type="text"
+          placeholder="Label (optional)"
+          class="bg-accent px-3 py-2 w-32"
+          :aria-label="`Link ${i + 1} label`"
+        >
+        <select
+          v-model="form.links[i]!.role"
+          class="bg-accent px-3 py-2 w-36"
+          :aria-label="`Link ${i + 1} role`"
+        >
+          <option
+            v-for="role in LINK_ROLES"
+            :key="role.value"
+            :value="role.value"
+          >
+            {{ role.label }}
+          </option>
+        </select>
+        <button
+          type="button"
+          class="text-xs text-muted hover:text-red-500"
+          @click="removeLink(i)"
+        >
+          Remove
+        </button>
+      </div>
+      <button
+        type="button"
+        class="text-xs text-muted hover:text-primary self-start"
+        @click="addLink"
+      >
+        + Add link
+      </button>
+      <span class="text-xs text-muted">The card links to the first website link, and shows a source icon for the first source code link.</span>
+    </div>
+
+    <label class="flex flex-col gap-1 text-sm">
+      <span class="text-muted">Status</span>
+      <select
+        v-model="form.status"
+        class="bg-accent px-3 py-2"
+      >
+        <option
+          v-for="status in STATUSES"
+          :key="status.value"
+          :value="status.value"
+        >
+          {{ status.label }}
+        </option>
+      </select>
+    </label>
+
+    <fieldset class="flex flex-col gap-2 text-sm border-0 p-0 m-0">
+      <legend class="text-muted">
+        Icon
+      </legend>
+      <div class="flex flex-wrap gap-1">
+        <button
+          type="button"
+          class="h-9 w-9 flex items-center justify-center bg-accent f-ring-accent transition-colors"
+          :class="form.icon ? 'text-muted hover:text-primary' : 'ring-2 ring-primary/80 text-primary'"
+          :aria-pressed="!form.icon"
+          title="No icon"
+          @click="form.icon = ''"
+        >
+          <span
+            class="i-ri:close-line h-5 w-5"
+            aria-hidden="true"
+          />
+          <span class="sr-only">No icon</span>
+        </button>
+        <button
+          v-for="icon in iconOptions"
+          :key="icon"
+          type="button"
+          class="h-9 w-9 flex items-center justify-center bg-accent f-ring-accent transition-colors"
+          :class="form.icon === icon ? 'ring-2 ring-primary/80 text-primary' : 'text-muted hover:text-primary'"
+          :aria-pressed="form.icon === icon"
+          :title="icon"
+          @click="form.icon = icon"
+        >
+          <span
+            :class="icon"
+            class="h-5 w-5"
+            aria-hidden="true"
+          />
+          <span class="sr-only">{{ icon }}</span>
+        </button>
+      </div>
+      <span class="text-xs text-muted">
+        Shown when there's no screenshot. Icons are generated at build time, so a new
+        one needs adding to <code>shared/project-icons.ts</code> before it can be picked.
+      </span>
+    </fieldset>
+
+    <label class="flex flex-col gap-1 text-sm">
+      <span class="text-muted">Order</span>
+      <input
+        v-model.number="form.order"
+        type="number"
+        class="bg-accent px-3 py-2"
+      >
+      <span class="text-xs text-muted">Lower numbers render first within a category. Defaults to 100.</span>
+    </label>
+
+    <div class="flex flex-col gap-2 text-sm">
+      <span class="text-muted">Screenshot</span>
+      <div
+        v-if="imageUrl"
+        class="flex items-start gap-3"
+      >
+        <img
+          :src="imageUrl"
+          alt="Project screenshot preview"
+          class="max-h-40 bg-accent object-contain"
+        >
+        <button
+          type="button"
+          class="text-xs text-muted hover:text-red-500 transition-colors"
+          @click="clearImage"
+        >
+          Remove
+        </button>
+      </div>
+      <input
+        type="file"
+        accept="image/*"
+        class="text-sm"
+        @change="onImageChange"
+      >
+      <label
+        v-if="form.image"
+        class="flex flex-col gap-1"
+      >
+        <span class="text-muted">Alt text <span class="text-red-500">*</span></span>
+        <input
+          v-model="form.imageAlt"
+          type="text"
+          required
+          class="bg-accent px-3 py-2"
+        >
+      </label>
+    </div>
+
+    <div class="flex gap-3">
+      <button
+        type="submit"
+        :disabled="submitting"
+        class="bg-primary text-background px-4 py-2 hover:bg-primary/90 transition-colors disabled:opacity-60"
+      >
+        {{ submitting ? 'Saving…' : (submitLabel ?? 'Save') }}
+      </button>
+      <NuxtLink
+        to="/admin/projects"
+        class="text-muted hover:text-primary self-center text-sm"
+      >
+        Cancel
+      </NuxtLink>
+    </div>
+  </form>
+</template>
diff --git a/app/components/admin/Shell.vue b/app/components/admin/Shell.vue
index ca59b8f8..324e15c3 100644
--- a/app/components/admin/Shell.vue
+++ b/app/components/admin/Shell.vue
@@ -22,6 +22,7 @@ const nav = [
   { label: 'AMA', to: '/admin/ama' },
   { label: 'Talks', to: '/admin/talks' },
   { label: 'Uses', to: '/admin/uses' },
+  { label: 'Projects', to: '/admin/projects' },
   { label: 'Entities', to: '/admin/entities' },
   { label: 'Invites', to: '/admin/invites' },
   { label: 'Location', to: '/admin/location' },
diff --git a/app/pages/admin/index.vue b/app/pages/admin/index.vue
index 211c663f..fbc54144 100644
--- a/app/pages/admin/index.vue
+++ b/app/pages/admin/index.vue
@@ -8,6 +8,8 @@ const { data: stats, loading } = useAdminFetch<{
   talkGroups: number
   usesCategories: number
   usesItems: number
+  projectCategories: number
+  projects: number
   hasLocation: boolean
 }>('/api/admin/stats')
 
@@ -18,6 +20,8 @@ const cards = computed(() => [
   { label: 'Talk groups', value: stats.value?.talkGroups ?? 0, to: '/admin/talks' },
   { label: 'Uses categories', value: stats.value?.usesCategories ?? 0, to: '/admin/uses' },
   { label: 'Uses items', value: stats.value?.usesItems ?? 0, to: '/admin/uses' },
+  { label: 'Project categories', value: stats.value?.projectCategories ?? 0, to: '/admin/projects' },
+  { label: 'Projects', value: stats.value?.projects ?? 0, to: '/admin/projects' },
   { label: 'Location', value: stats.value?.hasLocation ? 'set' : 'not set', to: '/admin/location' },
 ])
 </script>
@@ -30,7 +34,7 @@ const cards = computed(() => [
       aria-hidden="true"
     >
       <li
-        v-for="i in 5"
+        v-for="i in 7"
         :key="i"
       >
         <div class="block bg-accent p-6">
diff --git a/app/pages/admin/projects/categories/[rkey].vue b/app/pages/admin/projects/categories/[rkey].vue
new file mode 100644
index 00000000..1693dced
--- /dev/null
+++ b/app/pages/admin/projects/categories/[rkey].vue
@@ -0,0 +1,53 @@
+<script setup lang="ts">
+import type { dev } from '#shared/lex'
+import type { Loose } from '#shared/cms/strict'
+
+definePageMeta({ layout: false })
+useHead({ title: 'Edit project category - admin - Daniel Roe' })
+
+const route = useRoute()
+const rkey = computed(() => {
+  const raw = route.params.rkey
+  return typeof raw === 'string' && raw ? raw : null
+})
+
+if (!rkey.value) {
+  throw createError({ statusCode: 404, statusMessage: 'Missing rkey.' })
+}
+
+type ProjectCategoryValue = Omit<Loose<dev.roe.projectCategory.Main>, '$type'>
+
+interface CategoryEntry {
+  rkey: string
+  uri: string
+  cid: string
+  value: dev.roe.projectCategory.Main
+}
+
+// `watch: false` stops useFetch firing one last `/.../undefined` request
+// when `navigateTo` clears `route.params.rkey` on unmount.
+const { data, loading } = useAdminFetch<CategoryEntry>(`/api/admin/project-categories/${rkey.value}`, {
+  watch: false,
+})
+
+async function save (value: ProjectCategoryValue) {
+  if (!rkey.value) return
+  await $fetch(`/api/admin/project-categories/${rkey.value}`, { method: 'PUT', body: value })
+  await navigateTo('/admin/projects')
+}
+</script>
+
+<template>
+  <AdminShell title="Edit project category">
+    <AdminProjectCategoryForm
+      v-if="data"
+      :initial="data.value"
+      submit-label="Save"
+      @submit="save"
+    />
+    <AdminSkeletonForm
+      v-else-if="loading"
+      :fields="['text', 'text']"
+    />
+  </AdminShell>
+</template>
diff --git a/app/pages/admin/projects/categories/new.vue b/app/pages/admin/projects/categories/new.vue
new file mode 100644
index 00000000..4a704110
--- /dev/null
+++ b/app/pages/admin/projects/categories/new.vue
@@ -0,0 +1,23 @@
+<script setup lang="ts">
+import type { dev } from '#shared/lex'
+import type { Loose } from '#shared/cms/strict'
+
+definePageMeta({ layout: false })
+useHead({ title: 'New project category - admin - Daniel Roe' })
+
+type ProjectCategoryValue = Omit<Loose<dev.roe.projectCategory.Main>, '$type'>
+
+async function save (value: ProjectCategoryValue) {
+  await $fetch('/api/admin/project-categories', { method: 'POST', body: value })
+  await navigateTo('/admin/projects')
+}
+</script>
+
+<template>
+  <AdminShell title="New project category">
+    <AdminProjectCategoryForm
+      submit-label="Create"
+      @submit="save"
+    />
+  </AdminShell>
+</template>
diff --git a/app/pages/admin/projects/index.vue b/app/pages/admin/projects/index.vue
new file mode 100644
index 00000000..03e046c8
--- /dev/null
+++ b/app/pages/admin/projects/index.vue
@@ -0,0 +1,184 @@
+<script setup lang="ts">
+import type { dev } from '#shared/lex'
+import type { Loose } from '#shared/cms/strict'
+
+definePageMeta({ layout: false })
+useHead({ title: 'Projects - admin - Daniel Roe' })
+
+interface CategoryEntry {
+  rkey: string
+  uri: string
+  cid: string
+  value: Loose<dev.roe.projectCategory.Main>
+}
+
+interface ProjectEntry {
+  rkey: string
+  uri: string
+  cid: string
+  value: Loose<dev.roe.project.Main>
+}
+
+const { data: categoriesData, refresh: refreshCategories, loading: categoriesLoading } = useAdminFetch<CategoryEntry[]>('/api/admin/project-categories', { default: () => [] })
+const { data: projectsData, refresh: refreshProjects, loading: projectsLoading } = useAdminFetch<ProjectEntry[]>('/api/admin/projects', { default: () => [] })
+
+const showSkeleton = computed(() =>
+  (categoriesLoading.value || projectsLoading.value)
+  && !categoriesData.value.length,
+)
+
+const sortedCategories = computed(() => {
+  return [...(categoriesData.value ?? [])].sort((a, b) => (a.value.order ?? 100) - (b.value.order ?? 100))
+})
+
+/**
+ * Per-category reactive project lists wired to formkit/drag-and-drop. Each
+ * category's projects are sortable independently; cross-category drag is
+ * intentionally not enabled (different parent ref).
+ */
+const categoryDnD = computed(() => {
+  return sortedCategories.value.map(category => {
+    const itemsForCategory = (projectsData.value ?? [])
+      .filter(it => it.value.category?.uri === category.uri)
+      .sort((a, b) => (a.value.order ?? 100) - (b.value.order ?? 100))
+
+    return { category, items: itemsForCategory }
+  })
+})
+
+async function removeCategory (rkey: string, title: string) {
+  if (!confirm(`Delete category "${title}"? Projects in this category will be left orphaned.`)) return
+  const previous = categoriesData.value
+  categoriesData.value = categoriesData.value.filter(c => c.rkey !== rkey)
+  try {
+    await $fetch(`/api/admin/project-categories/${rkey}`, { method: 'DELETE' })
+    refreshCategories()
+  }
+  catch (error) {
+    categoriesData.value = previous
+    throw error
+  }
+}
+
+async function removeProject (rkey: string, name: string) {
+  if (!confirm(`Delete project "${name}"?`)) return
+  const previous = projectsData.value
+  projectsData.value = projectsData.value.filter(i => i.rkey !== rkey)
+  try {
+    await $fetch(`/api/admin/projects/${rkey}`, { method: 'DELETE' })
+    refreshProjects()
+  }
+  catch (error) {
+    projectsData.value = previous
+    throw error
+  }
+}
+
+/**
+ * After a drag-and-drop reorder, persist the new order by writing each
+ * project's `order` field to match its array position. Cheap-ish: one PUT per
+ * project in the affected category.
+ */
+async function persistProjectOrder (items: ProjectEntry[]) {
+  const orders = new Map(items.map((item, i) => [item.rkey, (i + 1) * 10]))
+  projectsData.value = projectsData.value.map(item => {
+    const order = orders.get(item.rkey)
+    return order === undefined ? item : { ...item, value: { ...item.value, order } }
+  })
+  await Promise.all(items.map((item, i) => {
+    const value = { ...item.value, order: (i + 1) * 10 }
+    delete (value as Record<string, unknown>).$type
+    return $fetch(`/api/admin/projects/${item.rkey}`, { method: 'PUT', body: value })
+  }))
+  refreshProjects()
+}
+</script>
+
+<template>
+  <AdminShell title="Projects">
+    <div class="flex flex-wrap items-center gap-2 mb-6">
+      <NuxtLink
+        to="/admin/projects/categories/new"
+        class="text-sm bg-accent text-primary px-3 py-1 hover:bg-accent/80 transition-colors"
+      >
+        New category
+      </NuxtLink>
+      <NuxtLink
+        v-if="categoriesData?.length"
+        to="/admin/projects/items/new"
+        class="text-sm bg-primary text-background px-3 py-1 hover:bg-primary/90 transition-colors"
+      >
+        New project
+      </NuxtLink>
+    </div>
+
+    <p
+      v-if="!showSkeleton && !categoriesData?.length"
+      class="text-muted text-sm"
+    >
+      No categories yet. Create a category before adding projects.
+    </p>
+
+    <div
+      v-if="showSkeleton"
+      class="flex flex-col gap-8"
+      aria-hidden="true"
+    >
+      <section
+        v-for="i in 3"
+        :key="i"
+      >
+        <header class="flex items-center gap-3 mb-2">
+          <h2 class="text-lg">
+            <AdminSkeleton class="bg-accent w-40" />
+          </h2>
+          <span class="text-xs text-muted">
+            <AdminSkeleton class="bg-accent w-16" />
+          </span>
+        </header>
+        <AdminSkeletonRows
+          variant="card"
+          :rows="3"
+        />
+      </section>
+    </div>
+
+    <div
+      v-else
+      class="flex flex-col gap-8"
+    >
+      <section
+        v-for="bucket in categoryDnD"
+        :key="bucket.category.rkey"
+      >
+        <header class="flex items-center gap-3 mb-2">
+          <h2 class="text-lg">
+            {{ bucket.category.value.title }}
+          </h2>
+          <span class="text-xs text-muted">order {{ bucket.category.value.order ?? 100 }}</span>
+          <div class="ml-auto flex gap-3 text-sm">
+            <NuxtLink
+              :to="`/admin/projects/categories/${bucket.category.rkey}`"
+              class="text-muted hover:text-primary transition-colors"
+            >
+              Edit
+            </NuxtLink>
+            <button
+              type="button"
+              class="text-muted hover:text-red-500 transition-colors"
+              @click="removeCategory(bucket.category.rkey, bucket.category.value.title)"
+            >
+              Delete
+            </button>
+          </div>
+        </header>
+
+        <AdminProjectDraggable
+          :items="bucket.items"
+          @reorder="persistProjectOrder"
+          @remove="removeProject"
+        />
+      </section>
+    </div>
+  </AdminShell>
+</template>
diff --git a/app/pages/admin/projects/items/[rkey].vue b/app/pages/admin/projects/items/[rkey].vue
new file mode 100644
index 00000000..cf284b81
--- /dev/null
+++ b/app/pages/admin/projects/items/[rkey].vue
@@ -0,0 +1,54 @@
+<script setup lang="ts">
+import type { dev } from '#shared/lex'
+import type { Loose } from '#shared/cms/strict'
+
+definePageMeta({ layout: false })
+useHead({ title: 'Edit project - admin - Daniel Roe' })
+
+const route = useRoute()
+const rkey = computed(() => {
+  const raw = route.params.rkey
+  return typeof raw === 'string' && raw ? raw : null
+})
+
+if (!rkey.value) {
+  throw createError({ statusCode: 404, statusMessage: 'Missing rkey.' })
+}
+
+type ProjectValue = Omit<Loose<dev.roe.project.Main>, '$type'>
+
+interface ProjectEntry {
+  rkey: string
+  uri: string
+  cid: string
+  value: dev.roe.project.Main
+}
+
+// `watch: false` stops useFetch firing one last `/.../undefined` request
+// when `navigateTo` clears `route.params.rkey` on unmount.
+const { data, loading } = useAdminFetch<ProjectEntry>(`/api/admin/projects/${rkey.value}`, {
+  watch: false,
+})
+
+async function save (value: ProjectValue) {
+  if (!rkey.value) return
+  await $fetch(`/api/admin/projects/${rkey.value}`, { method: 'PUT', body: value })
+  await navigateTo('/admin/projects')
+}
+</script>
+
+<template>
+  <AdminShell title="Edit project">
+    <AdminProjectForm
+      v-if="data"
+      :initial="data.value"
+      submit-label="Save"
+      @submit="save"
+    />
+    <AdminSkeletonForm
+      v-else-if="loading"
+      :fields="['text', 'text', 'textarea', 'text', 'text', 'text', 'checkbox', 'text']"
+      width-class="max-w-2xl"
+    />
+  </AdminShell>
+</template>
diff --git a/app/pages/admin/projects/items/new.vue b/app/pages/admin/projects/items/new.vue
new file mode 100644
index 00000000..56576f5f
--- /dev/null
+++ b/app/pages/admin/projects/items/new.vue
@@ -0,0 +1,23 @@
+<script setup lang="ts">
+import type { dev } from '#shared/lex'
+import type { Loose } from '#shared/cms/strict'
+
+definePageMeta({ layout: false })
+useHead({ title: 'New project - admin - Daniel Roe' })
+
+type ProjectValue = Omit<Loose<dev.roe.project.Main>, '$type'>
+
+async function save (value: ProjectValue) {
+  await $fetch('/api/admin/projects', { method: 'POST', body: value })
+  await navigateTo('/admin/projects')
+}
+</script>
+
+<template>
+  <AdminShell title="New project">
+    <AdminProjectForm
+      submit-label="Create"
+      @submit="save"
+    />
+  </AdminShell>
+</template>
diff --git a/lexicons/README.md b/lexicons/README.md
index 912f79be..65d5e526 100644
--- a/lexicons/README.md
+++ b/lexicons/README.md
@@ -1,7 +1,16 @@
 # lexicons
 
-Schemas for the records my CMS writes to my PDS. `com/` holds vendored copies of
-upstream schemas we reference; everything under `dev/roe/` is mine.
+Schemas for the records my CMS writes to my PDS. `com/` and `community/` hold
+vendored copies of upstream schemas we reference; everything under `dev/roe/` is
+mine.
+
+`community/lexicon/app/defs.json` is a verbatim copy of the
+[Lexicon Community](https://tangled.org/lexicon.community/lexicons) schema,
+checked against the `com.atproto.lexicon.schema` record published at
+`did:plc:mtr7qrqtcyseedx3jyr5o7db`. `dev.roe.project` uses its `#link`,
+`#image` and `#status` defs rather than reinventing them. Refresh it from
+upstream when the shared defs change; `pnpm lex:publish` only writes `dev.roe.*`
+schemas, so vendored files are never republished under my authority.
 
 - `pnpm lex:gen` regenerates the TypeScript types in `shared/lex/`.
 - `pnpm lex:publish` writes each `dev.roe.*` schema to the PDS as a
diff --git a/lexicons/community/lexicon/app/defs.json b/lexicons/community/lexicon/app/defs.json
new file mode 100644
index 00000000..34ea7595
--- /dev/null
+++ b/lexicons/community/lexicon/app/defs.json
@@ -0,0 +1,295 @@
+{
+  "lexicon": 1,
+  "id": "community.lexicon.app.defs",
+  "defs": {
+    "link": {
+      "type": "object",
+      "description": "A labeled URI associated with an app.",
+      "required": ["uri"],
+      "properties": {
+        "uri": {
+          "type": "string",
+          "format": "uri",
+          "description": "Destination URI."
+        },
+        "label": {
+          "type": "string",
+          "maxLength": 100,
+          "maxGraphemes": 50,
+          "description": "Human-readable label for the URI."
+        },
+        "role": {
+          "type": "ref",
+          "ref": "#linkRole",
+          "description": "Known role of this link, if any."
+        }
+      }
+    },
+    "linkRole": {
+      "type": "string",
+      "description": "Known role of a link associated with an app.",
+      "knownValues": [
+        "community.lexicon.app.defs#linkRoleWebsite",
+        "community.lexicon.app.defs#linkRoleWebManifest",
+        "community.lexicon.app.defs#linkRolePrivacyPolicy",
+        "community.lexicon.app.defs#linkRoleTermsOfService",
+        "community.lexicon.app.defs#linkRoleSupport",
+        "community.lexicon.app.defs#linkRoleSourceCode",
+        "community.lexicon.app.defs#linkRoleDocs",
+        "community.lexicon.app.defs#linkRoleChangelog",
+        "community.lexicon.app.defs#linkRoleStatus",
+        "community.lexicon.app.defs#linkRoleAppStore",
+        "community.lexicon.app.defs#linkRolePlayStore",
+        "community.lexicon.app.defs#linkRoleFDroid"
+      ]
+    },
+    "linkRoleWebsite": {
+      "type": "token",
+      "description": "Primary website or landing page."
+    },
+    "linkRoleWebManifest": {
+      "type": "token",
+      "description": "Web App Manifest."
+    },
+    "linkRolePrivacyPolicy": {
+      "type": "token",
+      "description": "Privacy policy."
+    },
+    "linkRoleTermsOfService": {
+      "type": "token",
+      "description": "Terms of service."
+    },
+    "linkRoleSupport": {
+      "type": "token",
+      "description": "Support, help, or contact page."
+    },
+    "linkRoleSourceCode": {
+      "type": "token",
+      "description": "Source code repository or source distribution."
+    },
+    "linkRoleDocs": {
+      "type": "token",
+      "description": "Documentation."
+    },
+    "linkRoleChangelog": {
+      "type": "token",
+      "description": "Changelog or release notes."
+    },
+    "linkRoleStatus": {
+      "type": "token",
+      "description": "Service status page."
+    },
+    "linkRoleAppStore": {
+      "type": "token",
+      "description": "Apple App Store listing."
+    },
+    "linkRolePlayStore": {
+      "type": "token",
+      "description": "Google Play Store listing."
+    },
+    "linkRoleFDroid": {
+      "type": "token",
+      "description": "F-Droid listing."
+    },
+    "image": {
+      "type": "object",
+      "description": "An image associated with an app, including accessibility and display metadata. Exactly one of `image` (ATProto blob) or `uri` (remote URL) MUST be present. Consumers SHOULD ignore image items that have neither or both.",
+      "required": ["alt"],
+      "properties": {
+        "purpose": {
+          "type": "string",
+          "knownValues": [
+            "community.lexicon.app.defs#purposeIcon",
+            "community.lexicon.app.defs#purposeLogo",
+            "community.lexicon.app.defs#purposeHero",
+            "community.lexicon.app.defs#purposeScreenshot",
+            "community.lexicon.app.defs#purposeBanner",
+            "community.lexicon.app.defs#purposeSocialCard",
+            "community.lexicon.app.defs#purposeAppStore",
+            "community.lexicon.app.defs#purposeAd"
+          ],
+          "description": "How directories and stores should use the image. Omit this field when no known purpose fits."
+        },
+        "image": {
+          "type": "blob",
+          "description": "The raw image file.",
+          "accept": ["image/*"],
+          "maxSize": 2000000
+        },
+        "uri": {
+          "type": "string",
+          "format": "uri",
+          "description": "Remote image URI."
+        },
+        "alt": {
+          "type": "string",
+          "maxLength": 1000,
+          "maxGraphemes": 300,
+          "description": "Alt text description of the image, for accessibility."
+        },
+        "aspectRatio": {
+          "type": "ref",
+          "ref": "#aspectRatio"
+        }
+      }
+    },
+    "aspectRatio": {
+      "type": "object",
+      "description": "width:height represents an aspect ratio. It may be approximate.",
+      "required": ["width", "height"],
+      "properties": {
+        "width": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "height": {
+          "type": "integer",
+          "minimum": 1
+        }
+      }
+    },
+    "purposeIcon": {
+      "type": "token",
+      "description": "A small square icon representing the app, typically used in launchers, lists, and tab bars."
+    },
+    "purposeLogo": {
+      "type": "token",
+      "description": "A logotype or wordmark for the app."
+    },
+    "purposeHero": {
+      "type": "token",
+      "description": "A large promotional or feature image, typically used at the top of a directory listing."
+    },
+    "purposeScreenshot": {
+      "type": "token",
+      "description": "A screenshot of the app's UI, used in directory and store listings."
+    },
+    "purposeBanner": {
+      "type": "token",
+      "description": "A wide banner image, such as a header image for a profile or listing page."
+    },
+    "purposeSocialCard": {
+      "type": "token",
+      "description": "An image sized and formatted for social media sharing previews (Open Graph, Twitter Card, etc.)."
+    },
+    "purposeAppStore": {
+      "type": "token",
+      "description": "A promotional image formatted for a native app store listing."
+    },
+    "purposeAd": {
+      "type": "token",
+      "description": "A promotional or advertising image."
+    },
+    "status": {
+      "type": "string",
+      "description": "Current release or maintenance status of an app.",
+      "knownValues": [
+        "community.lexicon.app.defs#unreleased",
+        "community.lexicon.app.defs#preview",
+        "community.lexicon.app.defs#released",
+        "community.lexicon.app.defs#unmaintained",
+        "community.lexicon.app.defs#discontinued"
+      ]
+    },
+    "unreleased": {
+      "type": "token",
+      "description": "The app has been announced but is not yet available."
+    },
+    "preview": {
+      "type": "token",
+      "description": "The app is available as an alpha, beta, early access, or preview release."
+    },
+    "released": {
+      "type": "token",
+      "description": "The app is generally available."
+    },
+    "unmaintained": {
+      "type": "token",
+      "description": "The app may still be available, but is no longer actively maintained."
+    },
+    "discontinued": {
+      "type": "token",
+      "description": "The app is no longer available or supported."
+    },
+    "platform": {
+      "type": "string",
+      "description": "Platform where an app is available.",
+      "knownValues": [
+        "community.lexicon.app.defs#platformWeb",
+        "community.lexicon.app.defs#platformIOS",
+        "community.lexicon.app.defs#platformAndroid",
+        "community.lexicon.app.defs#platformMacOS",
+        "community.lexicon.app.defs#platformWindows",
+        "community.lexicon.app.defs#platformLinux",
+        "community.lexicon.app.defs#platformCLI"
+      ]
+    },
+    "platformWeb": {
+      "type": "token",
+      "description": "Web app or website."
+    },
+    "platformIOS": {
+      "type": "token",
+      "description": "iOS app."
+    },
+    "platformAndroid": {
+      "type": "token",
+      "description": "Android app."
+    },
+    "platformMacOS": {
+      "type": "token",
+      "description": "macOS app."
+    },
+    "platformWindows": {
+      "type": "token",
+      "description": "Windows app."
+    },
+    "platformLinux": {
+      "type": "token",
+      "description": "Linux app."
+    },
+    "platformCLI": {
+      "type": "token",
+      "description": "Command line interface."
+    },
+    "lexiconInterop": {
+      "type": "object",
+      "description": "Self-declared AT Protocol lexicon interoperability signals.",
+      "properties": {
+        "produces": {
+          "type": "array",
+          "description": "Lexicon collections this app creates or publishes records for.",
+          "items": {
+            "type": "string",
+            "format": "nsid"
+          }
+        },
+        "consumes": {
+          "type": "array",
+          "description": "Lexicon collections this app reads, displays, imports, or otherwise consumes.",
+          "items": {
+            "type": "string",
+            "format": "nsid"
+          }
+        }
+      }
+    },
+    "accountIndicator": {
+      "type": "object",
+      "description": "A record whose presence in an account can indicate that the account probably uses this app.",
+      "required": ["collection"],
+      "properties": {
+        "collection": {
+          "type": "string",
+          "format": "nsid",
+          "description": "Record collection to look for in an account repository."
+        },
+        "rkey": {
+          "type": "string",
+          "format": "record-key",
+          "description": "Optional record key to look for within the collection."
+        }
+      }
+    }
+  }
+}
diff --git a/lexicons/dev/roe/project.json b/lexicons/dev/roe/project.json
new file mode 100644
index 00000000..351bc407
--- /dev/null
+++ b/lexicons/dev/roe/project.json
@@ -0,0 +1,70 @@
+{
+  "lexicon": 1,
+  "id": "dev.roe.project",
+  "defs": {
+    "main": {
+      "type": "record",
+      "description": "A project on the /projects page, belonging to a dev.roe.projectCategory.",
+      "key": "tid",
+      "record": {
+        "type": "object",
+        "required": ["category", "name", "createdAt"],
+        "properties": {
+          "category": {
+            "type": "ref",
+            "ref": "com.atproto.repo.strongRef",
+            "description": "Strong-ref to the parent dev.roe.projectCategory record."
+          },
+          "name": {
+            "type": "string",
+            "maxLength": 2560,
+            "maxGraphemes": 256
+          },
+          "description": {
+            "type": "string",
+            "maxLength": 25000,
+            "maxGraphemes": 2500
+          },
+          "links": {
+            "type": "array",
+            "description": "Relevant destinations for the project. The site links the card at the first `linkRoleWebsite`, falling back to the first link of any role.",
+            "items": {
+              "type": "ref",
+              "ref": "community.lexicon.app.defs#link"
+            },
+            "maxLength": 12
+          },
+          "images": {
+            "type": "array",
+            "description": "Visual assets for the project. The site renders the first `purposeScreenshot`, falling back to the first image of any purpose.",
+            "items": {
+              "type": "ref",
+              "ref": "community.lexicon.app.defs#image"
+            },
+            "maxLength": 8
+          },
+          "status": {
+            "type": "ref",
+            "ref": "community.lexicon.app.defs#status",
+            "description": "Release or maintenance status. `unmaintained` and `discontinued` render the card as archived."
+          },
+          "icon": {
+            "type": "string",
+            "maxLength": 640,
+            "maxGraphemes": 64,
+            "description": "UnoCSS icon class, e.g. `i-ri:rocket-line`. Used when there is no image."
+          },
+          "order": {
+            "type": "integer",
+            "description": "Lower values render first within the category. Defaults to 100 in the editor.",
+            "default": 100
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "datetime"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/lexicons/dev/roe/projectCategory.json b/lexicons/dev/roe/projectCategory.json
new file mode 100644
index 00000000..e01a5a56
--- /dev/null
+++ b/lexicons/dev/roe/projectCategory.json
@@ -0,0 +1,31 @@
+{
+  "lexicon": 1,
+  "id": "dev.roe.projectCategory",
+  "defs": {
+    "main": {
+      "type": "record",
+      "description": "A category on the /projects page. Projects belong to a category via dev.roe.project.category.",
+      "key": "tid",
+      "record": {
+        "type": "object",
+        "required": ["title", "createdAt"],
+        "properties": {
+          "title": {
+            "type": "string",
+            "maxLength": 2560,
+            "maxGraphemes": 256
+          },
+          "order": {
+            "type": "integer",
+            "description": "Lower values render first. Defaults to 100 in the editor.",
+            "default": 100
+          },
+          "createdAt": {
+            "type": "string",
+            "format": "datetime"
+          }
+        }
+      }
+    }
+  }
+}
diff --git a/modules/projects.ts b/modules/projects.ts
deleted file mode 100644
index b4d026ed..00000000
--- a/modules/projects.ts
+++ /dev/null
@@ -1,94 +0,0 @@
-import { readFile } from 'node:fs/promises'
-
-import { addTemplate, addTypeTemplate, defineNuxtModule, useNuxt } from 'nuxt/kit'
-import { resolve } from 'pathe'
-import yaml from 'js-yaml'
-
-export interface ProjectItem {
-  name: string
-  description?: string
-  url?: string
-  repo?: string
-  image?: string
-  icon?: string
-  archived?: boolean
-  order?: number
-}
-
-export interface ProjectCategory {
-  category: string
-  order?: number
-  items: ProjectItem[]
-}
-
-export default defineNuxtModule({
-  meta: {
-    name: 'projects',
-  },
-  async setup () {
-    const nuxt = useNuxt()
-    const filePath = resolve(nuxt.options.rootDir, 'content/projects.yml')
-
-    let categories: ProjectCategory[] = []
-    try {
-      const raw = await readFile(filePath, 'utf-8')
-      const parsed = yaml.load(raw) as ProjectCategory[] | null
-      categories = Array.isArray(parsed) ? parsed : []
-    }
-    catch (err: unknown) {
-      if ((err as NodeJS.ErrnoException)?.code !== 'ENOENT') throw err
-    }
-
-    categories = categories
-      .map(c => ({
-        ...c,
-        items: [...(c.items || [])].sort(
-          (a, b) => (a.order ?? 100) - (b.order ?? 100),
-        ),
-      }))
-      .sort((a, b) => (a.order ?? 100) - (b.order ?? 100))
-
-    addTemplate({
-      filename: 'projects.mjs',
-      getContents: () => `export const projects = ${JSON.stringify(categories)}`,
-      write: true,
-    })
-
-    nuxt.options.nitro.virtual ||= {}
-    nuxt.options.nitro.virtual['#projects.json'] = () =>
-      `export const projects = ${JSON.stringify(categories)}`
-
-    nuxt.options.nitro.externals ||= {}
-    nuxt.options.nitro.externals.inline ||= []
-    nuxt.options.nitro.externals.inline.push('#projects.json')
-
-    addTypeTemplate({
-      filename: 'types/projects.d.ts',
-      getContents: () => `
-interface ProjectItem {
-  name: string
-  description?: string
-  url?: string
-  repo?: string
-  image?: string
-  icon?: string
-  archived?: boolean
-  order?: number
-}
-interface ProjectCategory {
-  category: string
-  order?: number
-  items: ProjectItem[]
-}
-
-declare module '#build/projects.mjs' {
-  export const projects: ProjectCategory[]
-}
-
-declare module '#projects.json' {
-  export const projects: ProjectCategory[]
-}
-`,
-    }, { nuxt: true, nitro: true })
-  },
-})
diff --git a/nuxt.config.ts b/nuxt.config.ts
index 3d8e4b01..b57397a9 100644
--- a/nuxt.config.ts
+++ b/nuxt.config.ts
@@ -170,6 +170,7 @@ export default defineNuxtConfig({
     '/api/talks': { swr: 60 * 60 },
     '/api/upcoming-conferences': { swr: 60 * 60 },
     '/api/uses': { swr: 60 * 60 },
+    '/api/projects': { swr: 60 * 60 },
     '/api/current-location': { swr: 60 * 5 },
     '/api/sponsors': { prerender: true },
     '/api/hi': { cors: true },
diff --git a/package.json b/package.json
index 8b45633e..f52741c1 100644
--- a/package.json
+++ b/package.json
@@ -20,7 +20,8 @@
     "auth:youtube": "node --env-file=.env scripts/youtube-auth.ts",
     "auth:youtube:refresh": "node --env-file=.env scripts/youtube-auth.ts refresh",
     "lex:gen": "lex build --lexicons ./lexicons --out ./shared/lex --clear --index-file --import-ext .ts",
-    "lex:publish": "node --env-file=.env scripts/publish-lex.ts"
+    "lex:publish": "node --env-file=.env scripts/publish-lex.ts",
+    "migrate:projects": "node --env-file=.env scripts/migrate-projects-to-atproto.ts"
   },
   "nano-staged": {
     "*.{js,ts,mjs,vue}": [
diff --git a/scripts/migrate-projects-to-atproto.ts b/scripts/migrate-projects-to-atproto.ts
new file mode 100644
index 00000000..cc89ec46
--- /dev/null
+++ b/scripts/migrate-projects-to-atproto.ts
@@ -0,0 +1,276 @@
+/**
+ * One-shot `content/projects.yml` → atproto migration script. Creates a
+ * `dev.roe.projectCategory` record per category and a `dev.roe.project` record
+ * per item, uploading each item's `image` (a path under `public/`) as a blob.
+ *
+ * Usage:
+ *   node --env-file=.env scripts/migrate-projects-to-atproto.ts --dry-run
+ *   node --env-file=.env scripts/migrate-projects-to-atproto.ts
+ *   node --env-file=.env scripts/migrate-projects-to-atproto.ts --reset
+ *
+ * Flags:
+ *   --dry-run  Don't write anything; print what would happen.
+ *   --reset    Delete every record this script created (per the manifest),
+ *              clear the manifest, then exit.
+ *
+ * Idempotency: a manifest at scripts/.projects-migration-state.json maps
+ * `category:<title>` / `project:<category>/<name>` keys to the at:// URI that
+ * was created for them, so reruns skip anything already migrated. Categories
+ * are written before projects, because `project.category` is a strong-ref.
+ *
+ * Identity resolution matches scripts/publish-lex.ts: only
+ * NUXT_ATPROTO_PASSWORD is required.
+ *
+ * Both this script and `content/projects.yml` can be deleted once the
+ * migration has run against the live PDS.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { promises as dns } from 'node:dns'
+import { dirname, join, resolve } from 'node:path'
+import process from 'node:process'
+import { fileURLToPath } from 'node:url'
+
+import { Client, asStringFormat } from '@atproto/lex'
+import type { l } from '@atproto/lex'
+import { PasswordSession } from '@atproto/lex-password-session'
+import { defineCommand, runMain } from 'citty'
+import { imageMeta } from 'image-meta'
+import { load as loadYaml } from 'js-yaml'
+
+import { community, dev } from '../shared/lex/index.ts'
+
+const { defs } = community.lexicon.app
+
+const here = dirname(fileURLToPath(import.meta.url))
+const root = resolve(here, '..')
+const manifestPath = join(here, '.projects-migration-state.json')
+
+interface YamlProject {
+  name: string
+  description?: string
+  url?: string
+  repo?: string
+  image?: string
+  icon?: string
+  archived?: boolean
+  order?: number
+}
+
+interface YamlCategory {
+  category: string
+  order?: number
+  items?: YamlProject[]
+}
+
+interface ManifestEntry {
+  uri: string
+  cid: string
+}
+
+type Manifest = Record<string, ManifestEntry>
+
+function loadManifest (): Manifest {
+  if (!existsSync(manifestPath)) return {}
+  try {
+    return JSON.parse(readFileSync(manifestPath, 'utf8')) as Manifest
+  }
+  catch {
+    return {}
+  }
+}
+
+function saveManifest (manifest: Manifest): void {
+  const sorted: Manifest = {}
+  for (const key of Object.keys(manifest).sort()) sorted[key] = manifest[key]!
+  writeFileSync(manifestPath, JSON.stringify(sorted, null, 2) + '\n')
+}
+
+async function resolveDid (domain: string): Promise<string> {
+  const records = await dns.resolveTxt(`_atproto.${domain}`).catch(() => [])
+  for (const chunks of records) {
+    const value = chunks.join('')
+    if (value.startsWith('did=')) return value.slice('did='.length)
+  }
+
+  const res = await fetch(`https://${domain}/.well-known/atproto-did`)
+  if (!res.ok) throw new Error(`could not resolve a DID for ${domain} via _atproto TXT or /.well-known/atproto-did`)
+  return (await res.text()).trim()
+}
+
+async function resolvePdsEndpoint (did: string): Promise<string> {
+  const url = did.startsWith('did:plc:')
+    ? `https://plc.directory/${did}`
+    : did.startsWith('did:web:')
+      ? `https://${did.slice('did:web:'.length)}/.well-known/did.json`
+      : null
+  if (!url) throw new Error(`unsupported DID method: ${did}`)
+
+  const res = await fetch(url)
+  if (!res.ok) throw new Error(`${url} -> ${res.status}`)
+  const doc = await res.json() as { service?: Array<{ id: string, serviceEndpoint: string }> }
+  const pds = doc.service?.find(s => s.id === '#atproto_pds' || s.id.endsWith('#atproto_pds'))
+  if (!pds?.serviceEndpoint) throw new Error(`DID doc for ${did} has no #atproto_pds service entry`)
+  return pds.serviceEndpoint
+}
+
+const MIME_BY_EXT: Record<string, `${string}/${string}`> = {
+  '.png': 'image/png',
+  '.jpg': 'image/jpeg',
+  '.jpeg': 'image/jpeg',
+  '.webp': 'image/webp',
+  '.avif': 'image/avif',
+  '.gif': 'image/gif',
+  '.svg': 'image/svg+xml',
+}
+
+function readCategories (): YamlCategory[] {
+  const parsed = loadYaml(readFileSync(join(root, 'content/projects.yml'), 'utf8'))
+  if (!Array.isArray(parsed)) throw new Error('content/projects.yml did not parse to an array')
+  return parsed as YamlCategory[]
+}
+
+const main = defineCommand({
+  meta: {
+    name: 'migrate-projects-to-atproto',
+    description: 'Migrate content/projects.yml into dev.roe.projectCategory + dev.roe.project records',
+  },
+  args: {
+    'dry-run': {
+      type: 'boolean',
+      description: 'Print what would change without writing to the PDS',
+      default: false,
+    },
+    'reset': {
+      type: 'boolean',
+      description: 'Delete every record in the manifest and clear it',
+      default: false,
+    },
+  },
+  async run ({ args }) {
+    const password = process.env.NUXT_ATPROTO_PASSWORD
+    if (!password) {
+      console.error('Set NUXT_ATPROTO_PASSWORD (see .env.example).')
+      process.exitCode = 1
+      return
+    }
+
+    const did = asStringFormat(process.env.NUXT_ATPROTO_DID || await resolveDid('roe.dev'), 'did')
+    const service = process.env.NUXT_PUBLIC_ATPROTO_SERVICE || await resolvePdsEndpoint(did)
+    console.log(`${did} @ ${service}\n`)
+
+    const session = await PasswordSession.login({ service, identifier: did, password })
+    const client = new Client(session)
+    const manifest = loadManifest()
+
+    if (args.reset) {
+      const remaining: Manifest = { ...manifest }
+      for (const [key, entry] of Object.entries(manifest)) {
+        const [collection, rkey] = [entry.uri.split('/').at(-2)!, entry.uri.split('/').at(-1)!]
+        if (args['dry-run']) {
+          console.log(`   delete (dry run)  ${entry.uri}`)
+          continue
+        }
+        await client.deleteRecord(collection as `${string}.${string}.${string}`, rkey, { repo: did })
+        Reflect.deleteProperty(remaining, key)
+        console.log(`🗑  deleted  ${entry.uri}`)
+      }
+      if (!args['dry-run']) saveManifest(remaining)
+      return
+    }
+
+    const createdAt = asStringFormat(new Date().toISOString(), 'datetime')
+
+    for (const category of readCategories()) {
+      const categoryKey = `category:${category.category}`
+      let categoryEntry = manifest[categoryKey]
+
+      if (categoryEntry) {
+        console.log(`   unchanged  ${category.category}`)
+      }
+      else if (args['dry-run']) {
+        console.log(`   create (dry run)  category ${category.category}`)
+        categoryEntry = { uri: `at://${did}/dev.roe.projectCategory/dry-run`, cid: 'dry-run' }
+      }
+      else {
+        const res = await client.create(dev.roe.projectCategory.main, {
+          title: category.category,
+          order: category.order ?? 100,
+          createdAt,
+        }, { repo: did, validateRequest: true })
+        categoryEntry = { uri: res.uri, cid: res.cid }
+        manifest[categoryKey] = categoryEntry
+        saveManifest(manifest)
+        console.log(`🟢 created  category ${category.category}`)
+      }
+
+      for (const item of category.items ?? []) {
+        const itemKey = `project:${category.category}/${item.name}`
+        if (manifest[itemKey]) {
+          console.log(`   unchanged  ${item.name}`)
+          continue
+        }
+
+        let image: l.BlobRef | undefined
+        let aspectRatio: { width: number, height: number } | undefined
+        if (item.image) {
+          const path = join(root, 'public', item.image.replace(/^\//, ''))
+          if (!existsSync(path)) throw new Error(`${item.name}: ${item.image} does not exist under public/`)
+          const bytes = new Uint8Array(readFileSync(path))
+          const ext = item.image.slice(item.image.lastIndexOf('.')).toLowerCase()
+          const encoding = MIME_BY_EXT[ext]
+          if (!encoding) throw new Error(`${item.name}: unsupported image extension ${ext}`)
+
+          const { width, height } = imageMeta(bytes)
+          if (width && height) aspectRatio = { width, height }
+
+          if (args['dry-run']) {
+            console.log(`   upload (dry run)  ${item.image} (${bytes.byteLength} bytes)`)
+          }
+          else {
+            const uploaded = await client.uploadBlob(bytes, { encoding })
+            image = uploaded.body.blob
+          }
+        }
+
+        if (args['dry-run']) {
+          console.log(`   create (dry run)  project ${item.name}`)
+          continue
+        }
+
+        const links = [
+          ...(item.url ? [{ uri: asStringFormat(item.url, 'uri'), role: defs.linkRoleWebsite.value }] : []),
+          ...(item.repo && item.repo !== item.url
+            ? [{ uri: asStringFormat(item.repo, 'uri'), role: defs.linkRoleSourceCode.value }]
+            : []),
+        ]
+
+        const res = await client.create(dev.roe.project.main, {
+          category: { uri: asStringFormat(categoryEntry.uri, 'at-uri'), cid: categoryEntry.cid },
+          name: item.name,
+          ...(item.description ? { description: item.description } : {}),
+          ...(links.length ? { links } : {}),
+          ...(image
+            ? {
+                images: [{
+                  purpose: defs.purposeScreenshot.value,
+                  image,
+                  alt: `Screenshot of ${item.name}`,
+                  ...(aspectRatio ? { aspectRatio } : {}),
+                }],
+              }
+            : {}),
+          ...(item.archived ? { status: defs.unmaintained.value } : {}),
+          ...(item.icon ? { icon: item.icon } : {}),
+          order: item.order ?? 100,
+          createdAt,
+        }, { repo: did, validateRequest: true })
+
+        manifest[itemKey] = { uri: res.uri, cid: res.cid }
+        saveManifest(manifest)
+        console.log(`🟢 created  project ${item.name}${image ? ' (+ image)' : ''}`)
+      }
+    }
+  },
+})
+
+runMain(main)
diff --git a/server/api/admin/project-categories/[rkey].delete.ts b/server/api/admin/project-categories/[rkey].delete.ts
new file mode 100644
index 00000000..b663fc1c
--- /dev/null
+++ b/server/api/admin/project-categories/[rkey].delete.ts
@@ -0,0 +1,6 @@
+import { deleteAdminRecord } from '../../../utils/admin/crud'
+import { dev } from '#shared/lex'
+
+export default defineEventHandler(event => {
+  return deleteAdminRecord(event, dev.roe.projectCategory.main, getRouterParam(event, 'rkey'))
+})
diff --git a/server/api/admin/project-categories/[rkey].get.ts b/server/api/admin/project-categories/[rkey].get.ts
new file mode 100644
index 00000000..58f9a47a
--- /dev/null
+++ b/server/api/admin/project-categories/[rkey].get.ts
@@ -0,0 +1,6 @@
+import { getAdminRecord } from '../../../utils/admin/crud'
+import { dev } from '#shared/lex'
+
+export default defineEventHandler(event => {
+  return getAdminRecord(event, dev.roe.projectCategory.main, getRouterParam(event, 'rkey'))
+})
diff --git a/server/api/admin/project-categories/[rkey].put.ts b/server/api/admin/project-categories/[rkey].put.ts
new file mode 100644
index 00000000..9fcf50bd
--- /dev/null
+++ b/server/api/admin/project-categories/[rkey].put.ts
@@ -0,0 +1,7 @@
+import { updateAdminRecord } from '../../../utils/admin/crud'
+import { dev } from '#shared/lex'
+
+export default defineEventHandler(async event => {
+  const body = await readBody<Omit<dev.roe.projectCategory.Main, '$type'>>(event)
+  return updateAdminRecord(event, dev.roe.projectCategory.main, getRouterParam(event, 'rkey'), body)
+})
diff --git a/server/api/admin/project-categories/index.get.ts b/server/api/admin/project-categories/index.get.ts
new file mode 100644
index 00000000..789dcd92
--- /dev/null
+++ b/server/api/admin/project-categories/index.get.ts
@@ -0,0 +1,8 @@
+import { listAdminRecords } from '../../../utils/admin/crud'
+import { dev } from '#shared/lex'
+
+export default defineEventHandler(event => {
+  return listAdminRecords(event, dev.roe.projectCategory.main, {
+    sortBy: r => r.value.order ?? 100,
+  })
+})
diff --git a/server/api/admin/project-categories/index.post.ts b/server/api/admin/project-categories/index.post.ts
new file mode 100644
index 00000000..57e56b74
--- /dev/null
+++ b/server/api/admin/project-categories/index.post.ts
@@ -0,0 +1,7 @@
+import { createAdminRecord } from '../../../utils/admin/crud'
+import { dev } from '#shared/lex'
+
+export default defineEventHandler(async event => {
+  const body = await readBody<Omit<dev.roe.projectCategory.Main, '$type' | 'createdAt'>>(event)
+  return createAdminRecord(event, dev.roe.projectCategory.main, body)
+})
diff --git a/server/api/admin/projects/[rkey].delete.ts b/server/api/admin/projects/[rkey].delete.ts
new file mode 100644
index 00000000..37f13fc0
--- /dev/null
+++ b/server/api/admin/projects/[rkey].delete.ts
@@ -0,0 +1,6 @@
+import { deleteAdminRecord } from '../../../utils/admin/crud'
+import { dev } from '#shared/lex'
+
+export default defineEventHandler(event => {
+  return deleteAdminRecord(event, dev.roe.project.main, getRouterParam(event, 'rkey'))
+})
diff --git a/server/api/admin/projects/[rkey].get.ts b/server/api/admin/projects/[rkey].get.ts
new file mode 100644
index 00000000..8df66653
--- /dev/null
+++ b/server/api/admin/projects/[rkey].get.ts
@@ -0,0 +1,6 @@
+import { getAdminRecord } from '../../../utils/admin/crud'
+import { dev } from '#shared/lex'
+
+export default defineEventHandler(event => {
+  return getAdminRecord(event, dev.roe.project.main, getRouterParam(event, 'rkey'))
+})
diff --git a/server/api/admin/projects/[rkey].put.ts b/server/api/admin/projects/[rkey].put.ts
new file mode 100644
index 00000000..0a2a2207
--- /dev/null
+++ b/server/api/admin/projects/[rkey].put.ts
@@ -0,0 +1,7 @@
+import { updateAdminRecord } from '../../../utils/admin/crud'
+import { dev } from '#shared/lex'
+
+export default defineEventHandler(async event => {
+  const body = await readBody<Omit<dev.roe.project.Main, '$type'>>(event)
+  return updateAdminRecord(event, dev.roe.project.main, getRouterParam(event, 'rkey'), body)
+})
diff --git a/server/api/admin/projects/index.get.ts b/server/api/admin/projects/index.get.ts
new file mode 100644
index 00000000..5e5e2dd1
--- /dev/null
+++ b/server/api/admin/projects/index.get.ts
@@ -0,0 +1,8 @@
+import { listAdminRecords } from '../../../utils/admin/crud'
+import { dev } from '#shared/lex'
+
+export default defineEventHandler(event => {
+  return listAdminRecords(event, dev.roe.project.main, {
+    sortBy: r => r.value.order ?? 100,
+  })
+})
diff --git a/server/api/admin/projects/index.post.ts b/server/api/admin/projects/index.post.ts
new file mode 100644
index 00000000..751b744f
--- /dev/null
+++ b/server/api/admin/projects/index.post.ts
@@ -0,0 +1,7 @@
+import { createAdminRecord } from '../../../utils/admin/crud'
+import { dev } from '#shared/lex'
+
+export default defineEventHandler(async event => {
+  const body = await readBody<Omit<dev.roe.project.Main, '$type' | 'createdAt'>>(event)
+  return createAdminRecord(event, dev.roe.project.main, body)
+})
diff --git a/server/api/admin/stats.get.ts b/server/api/admin/stats.get.ts
index 925eb5bf..54118145 100644
--- a/server/api/admin/stats.get.ts
+++ b/server/api/admin/stats.get.ts
@@ -12,11 +12,13 @@ export default defineEventHandler(async event => {
     return total
   }
 
-  const [talks, talkGroups, usesCategories, usesItems] = await Promise.all([
+  const [talks, talkGroups, usesCategories, usesItems, projectCategories, projects] = await Promise.all([
     count(dev.roe.talk.main),
     count(dev.roe.talkGroup.main),
     count(dev.roe.usesCategory.main),
     count(dev.roe.usesItem.main),
+    count(dev.roe.projectCategory.main),
+    count(dev.roe.project.main),
   ])
 
   // Location is a singleton; check by attempting to fetch `self`.
@@ -27,5 +29,5 @@ export default defineEventHandler(async event => {
   }
   catch { /* missing record → false */ }
 
-  return { talks, talkGroups, usesCategories, usesItems, hasLocation }
+  return { talks, talkGroups, usesCategories, usesItems, projectCategories, projects, hasLocation }
 })
diff --git a/server/api/projects.get.ts b/server/api/projects.get.ts
new file mode 100644
index 00000000..f6b5e7e8
--- /dev/null
+++ b/server/api/projects.get.ts
@@ -0,0 +1,5 @@
+import { getProjects } from '../utils/cms/projects'
+
+export default defineEventHandler(async event => {
+  return getProjects(event)
+})
diff --git a/server/routes/projects.md.get.ts b/server/routes/projects.md.get.ts
index 65f56ed4..299aefb2 100644
--- a/server/routes/projects.md.get.ts
+++ b/server/routes/projects.md.get.ts
@@ -1,14 +1,21 @@
-import { projects } from '#projects.json'
 import { pageMeta } from '#md-page-meta.json'
 
-export default defineEventHandler(() => {
+import { getProjects } from '../utils/cms/projects'
+
+export default defineEventHandler(async event => {
+  if (import.meta.test) {
+    return mdResponse('')
+  }
+
+  const categories = await getProjects(event)
+
   const lines = [
     mdFrontmatter('/projects', pageMeta['/projects']!),
     '',
   ]
 
-  for (const category of projects) {
-    lines.push(`## ${category.category}`)
+  for (const category of categories) {
+    lines.push(`## ${category.title}`)
     lines.push('')
 
     for (const item of category.items) {
diff --git a/server/utils/admin/oauth.ts b/server/utils/admin/oauth.ts
index bea40e87..0304f998 100644
--- a/server/utils/admin/oauth.ts
+++ b/server/utils/admin/oauth.ts
@@ -24,6 +24,8 @@ const SCOPES = [
   'repo:dev.roe.entity',
   'repo:dev.roe.invite',
   'repo:dev.roe.location',
+  'repo:dev.roe.project',
+  'repo:dev.roe.projectCategory',
   'repo:dev.roe.talk',
   'repo:dev.roe.talkGroup',
   'repo:dev.roe.usesCategory',
diff --git a/server/utils/cms/projects.ts b/server/utils/cms/projects.ts
new file mode 100644
index 00000000..cc658572
--- /dev/null
+++ b/server/utils/cms/projects.ts
@@ -0,0 +1,97 @@
+import type { H3Event } from 'h3'
+
+import { listRecords, blobImage } from '../atproto'
+import { community, dev } from '#shared/lex'
+import type { Project, ProjectCategory } from '#shared/cms/projects'
+
+export type { Project, ProjectCategory } from '#shared/cms/projects'
+
+const { defs } = community.lexicon.app
+
+const ARCHIVED_STATUSES = new Set<string>([
+  defs.unmaintained.value,
+  defs.discontinued.value,
+])
+
+/**
+ * Fetch all project categories with their projects, joined by strong-ref, each
+ * sorted by `order`. Projects whose parent category isn't in the repo are
+ * dropped (defence against orphans if a category was deleted without cascading
+ * to its projects).
+ */
+export async function getProjects (event: H3Event): Promise<ProjectCategory[]> {
+  const [categories, projects] = await Promise.all([
+    listRecords(event, dev.roe.projectCategory.main),
+    listRecords(event, dev.roe.project.main),
+  ])
+
+  const projectsByCategoryUri = new Map<string, typeof projects>()
+  for (const project of projects) {
+    const parentUri = project.value.category?.uri
+    if (!parentUri) continue
+    const bucket = projectsByCategoryUri.get(parentUri) ?? []
+    bucket.push(project)
+    projectsByCategoryUri.set(parentUri, bucket)
+  }
+
+  const mapped = await Promise.all(categories.map(async cat => {
+    const bucket = projectsByCategoryUri.get(cat.uri) ?? []
+    const items: Project[] = await Promise.all(bucket.map(async it => {
+      const { $type, category, links, images, status, createdAt, ...passthrough } = it.value
+      return {
+        ...passthrough,
+        url: linkFor(links, defs.linkRoleWebsite.value) ?? linkFor(links) ?? null,
+        repo: linkFor(links, defs.linkRoleSourceCode.value) ?? null,
+        archived: !!status && ARCHIVED_STATUSES.has(status),
+        image: await projectImage(event, images),
+      }
+    }))
+    items.sort((a, b) => (a.order ?? 100) - (b.order ?? 100))
+
+    const { $type, createdAt, ...passthrough } = cat.value
+    return {
+      ...passthrough,
+      _id: rkeyFromUri(cat.uri),
+      items,
+    }
+  }))
+
+  return mapped.sort((a, b) => (a.order ?? 100) - (b.order ?? 100))
+}
+
+type Links = dev.roe.project.Main['links']
+type Images = dev.roe.project.Main['images']
+
+/** The first link with `role`, or the first link of any role when `role` is omitted. */
+function linkFor (links: Links, role?: string): string | null {
+  const link = role ? links?.find(l => l.role === role) : links?.[0]
+  return link?.uri ?? null
+}
+
+/**
+ * The screenshot the card renders, preferring an explicit `purposeScreenshot`.
+ * `community.lexicon.app.defs#image` allows either an uploaded blob or a
+ * remote `uri`; we render whichever the record carries.
+ */
+async function projectImage (event: H3Event, images: Images): Promise<Project['image']> {
+  const image = images?.find(i => i.purpose === defs.purposeScreenshot.value) ?? images?.[0]
+  if (!image) return null
+
+  if (image.image) {
+    const blob = await blobImage(event, image.image, image.aspectRatio)
+    return blob ? { ...blob, alt: image.alt } : null
+  }
+
+  if (!image.uri) return null
+  return {
+    url: image.uri,
+    alt: image.alt,
+    width: image.aspectRatio?.width ?? null,
+    height: image.aspectRatio?.height ?? null,
+  }
+}
+
+function rkeyFromUri (uri: string): string {
+  const i = uri.lastIndexOf('/')
+  return i === -1 ? uri : uri.slice(i + 1)
+}
diff --git a/shared/cms/projects.ts b/shared/cms/projects.ts
new file mode 100644
index 00000000..ed83dbfe
--- /dev/null
+++ b/shared/cms/projects.ts
@@ -0,0 +1,25 @@
+import type { dev } from '../lex/index.ts'
+import type { Strict } from './strict.ts'
+
+/**
+ * The view model the /projects page renders. Records store
+ * `community.lexicon.app.defs` links and images; the read path picks the ones
+ * the page uses (site link, source link, screenshot) so the page doesn't have
+ * to know about link roles and image purposes.
+ */
+export type Project = Omit<Strict<dev.roe.project.Main>, '$type' | 'category' | 'links' | 'images' | 'status' | 'createdAt'> & {
+  url: string | null
+  repo: string | null
+  archived: boolean
+  image: {
+    url: string
+    alt: string
+    width: number | null
+    height: number | null
+  } | null
+}
+
+export type ProjectCategory = Omit<Strict<dev.roe.projectCategory.Main>, '$type' | 'createdAt'> & {
+  _id: string
+  items: Project[]
+}
diff --git a/shared/lex/community.ts b/shared/lex/community.ts
new file mode 100644
index 00000000..f86015c5
--- /dev/null
+++ b/shared/lex/community.ts
@@ -0,0 +1,5 @@
+/*
+ * THIS FILE WAS GENERATED BY "@atproto/lex". DO NOT EDIT.
+ */
+
+export * as lexicon from './community/lexicon.ts'
diff --git a/shared/lex/community/lexicon.ts b/shared/lex/community/lexicon.ts
new file mode 100644
index 00000000..d027c156
--- /dev/null
+++ b/shared/lex/community/lexicon.ts
@@ -0,0 +1,5 @@
+/*
+ * THIS FILE WAS GENERATED BY "@atproto/lex". DO NOT EDIT.
+ */
+
+export * as app from './lexicon/app.ts'
diff --git a/shared/lex/community/lexicon/app.ts b/shared/lex/community/lexicon/app.ts
new file mode 100644
index 00000000..df02b815
--- /dev/null
+++ b/shared/lex/community/lexicon/app.ts
@@ -0,0 +1,5 @@
+/*
+ * THIS FILE WAS GENERATED BY "@atproto/lex". DO NOT EDIT.
+ */
+
+export * as defs from './app/defs.ts'
diff --git a/shared/lex/community/lexicon/app/defs.defs.ts b/shared/lex/community/lexicon/app/defs.defs.ts
new file mode 100644
index 00000000..fd0cd335
--- /dev/null
+++ b/shared/lex/community/lexicon/app/defs.defs.ts
@@ -0,0 +1,621 @@
+/*
+ * THIS FILE WAS GENERATED BY "@atproto/lex". DO NOT EDIT.
+ */
+
+import { l } from '@atproto/lex'
+
+const $nsid = 'community.lexicon.app.defs'
+
+type $nsid = typeof $nsid
+
+export { $nsid }
+
+/** A labeled URI associated with an app. */
+type Link = {
+  $type?: 'community.lexicon.app.defs#link'
+
+  /**
+   * Destination URI.
+   */
+  uri: l.UriString
+
+  /**
+   * Human-readable label for the URI.
+   */
+  label?: string
+
+  /**
+   * Known role of this link, if any.
+   */
+  role?: LinkRole
+}
+
+export type { Link }
+
+/** A labeled URI associated with an app. */
+const link = /*#__PURE__*/ l.typedObject<Link>(
+  $nsid,
+  'link',
+  /*#__PURE__*/ l.object({
+    uri: /*#__PURE__*/ l.string({ format: 'uri' }),
+    label: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.string({ maxLength: 100, maxGraphemes: 50 }),
+    ),
+    role: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.ref<LinkRole>((() => linkRole) as any),
+    ),
+  }),
+)
+
+export { link }
+
+/** Known role of a link associated with an app. */
+type LinkRole =
+  | 'community.lexicon.app.defs#linkRoleWebsite'
+  | 'community.lexicon.app.defs#linkRoleWebManifest'
+  | 'community.lexicon.app.defs#linkRolePrivacyPolicy'
+  | 'community.lexicon.app.defs#linkRoleTermsOfService'
+  | 'community.lexicon.app.defs#linkRoleSupport'
+  | 'community.lexicon.app.defs#linkRoleSourceCode'
+  | 'community.lexicon.app.defs#linkRoleDocs'
+  | 'community.lexicon.app.defs#linkRoleChangelog'
+  | 'community.lexicon.app.defs#linkRoleStatus'
+  | 'community.lexicon.app.defs#linkRoleAppStore'
+  | 'community.lexicon.app.defs#linkRolePlayStore'
+  | 'community.lexicon.app.defs#linkRoleFDroid'
+  | l.UnknownString
+
+export type { LinkRole }
+
+/** Known role of a link associated with an app. */
+const linkRole = /*#__PURE__*/ l.string<{
+  knownValues: [
+    'community.lexicon.app.defs#linkRoleWebsite',
+    'community.lexicon.app.defs#linkRoleWebManifest',
+    'community.lexicon.app.defs#linkRolePrivacyPolicy',
+    'community.lexicon.app.defs#linkRoleTermsOfService',
+    'community.lexicon.app.defs#linkRoleSupport',
+    'community.lexicon.app.defs#linkRoleSourceCode',
+    'community.lexicon.app.defs#linkRoleDocs',
+    'community.lexicon.app.defs#linkRoleChangelog',
+    'community.lexicon.app.defs#linkRoleStatus',
+    'community.lexicon.app.defs#linkRoleAppStore',
+    'community.lexicon.app.defs#linkRolePlayStore',
+    'community.lexicon.app.defs#linkRoleFDroid',
+  ]
+}>()
+
+export { linkRole }
+
+/** Primary website or landing page. */
+type LinkRoleWebsite = 'community.lexicon.app.defs#linkRoleWebsite'
+
+export type { LinkRoleWebsite }
+
+/** Primary website or landing page. */
+const linkRoleWebsite = /*#__PURE__*/ l.token($nsid, 'linkRoleWebsite')
+
+export { linkRoleWebsite }
+
+/** Web App Manifest. */
+type LinkRoleWebManifest = 'community.lexicon.app.defs#linkRoleWebManifest'
+
+export type { LinkRoleWebManifest }
+
+/** Web App Manifest. */
+const linkRoleWebManifest = /*#__PURE__*/ l.token($nsid, 'linkRoleWebManifest')
+
+export { linkRoleWebManifest }
+
+/** Privacy policy. */
+type LinkRolePrivacyPolicy = 'community.lexicon.app.defs#linkRolePrivacyPolicy'
+
+export type { LinkRolePrivacyPolicy }
+
+/** Privacy policy. */
+const linkRolePrivacyPolicy = /*#__PURE__*/ l.token(
+  $nsid,
+  'linkRolePrivacyPolicy',
+)
+
+export { linkRolePrivacyPolicy }
+
+/** Terms of service. */
+type LinkRoleTermsOfService =
+  'community.lexicon.app.defs#linkRoleTermsOfService'
+
+export type { LinkRoleTermsOfService }
+
+/** Terms of service. */
+const linkRoleTermsOfService = /*#__PURE__*/ l.token(
+  $nsid,
+  'linkRoleTermsOfService',
+)
+
+export { linkRoleTermsOfService }
+
+/** Support, help, or contact page. */
+type LinkRoleSupport = 'community.lexicon.app.defs#linkRoleSupport'
+
+export type { LinkRoleSupport }
+
+/** Support, help, or contact page. */
+const linkRoleSupport = /*#__PURE__*/ l.token($nsid, 'linkRoleSupport')
+
+export { linkRoleSupport }
+
+/** Source code repository or source distribution. */
+type LinkRoleSourceCode = 'community.lexicon.app.defs#linkRoleSourceCode'
+
+export type { LinkRoleSourceCode }
+
+/** Source code repository or source distribution. */
+const linkRoleSourceCode = /*#__PURE__*/ l.token($nsid, 'linkRoleSourceCode')
+
+export { linkRoleSourceCode }
+
+/** Documentation. */
+type LinkRoleDocs = 'community.lexicon.app.defs#linkRoleDocs'
+
+export type { LinkRoleDocs }
+
+/** Documentation. */
+const linkRoleDocs = /*#__PURE__*/ l.token($nsid, 'linkRoleDocs')
+
+export { linkRoleDocs }
+
+/** Changelog or release notes. */
+type LinkRoleChangelog = 'community.lexicon.app.defs#linkRoleChangelog'
+
+export type { LinkRoleChangelog }
+
+/** Changelog or release notes. */
+const linkRoleChangelog = /*#__PURE__*/ l.token($nsid, 'linkRoleChangelog')
+
+export { linkRoleChangelog }
+
+/** Service status page. */
+type LinkRoleStatus = 'community.lexicon.app.defs#linkRoleStatus'
+
+export type { LinkRoleStatus }
+
+/** Service status page. */
+const linkRoleStatus = /*#__PURE__*/ l.token($nsid, 'linkRoleStatus')
+
+export { linkRoleStatus }
+
+/** Apple App Store listing. */
+type LinkRoleAppStore = 'community.lexicon.app.defs#linkRoleAppStore'
+
+export type { LinkRoleAppStore }
+
+/** Apple App Store listing. */
+const linkRoleAppStore = /*#__PURE__*/ l.token($nsid, 'linkRoleAppStore')
+
+export { linkRoleAppStore }
+
+/** Google Play Store listing. */
+type LinkRolePlayStore = 'community.lexicon.app.defs#linkRolePlayStore'
+
+export type { LinkRolePlayStore }
+
+/** Google Play Store listing. */
+const linkRolePlayStore = /*#__PURE__*/ l.token($nsid, 'linkRolePlayStore')
+
+export { linkRolePlayStore }
+
+/** F-Droid listing. */
+type LinkRoleFDroid = 'community.lexicon.app.defs#linkRoleFDroid'
+
+export type { LinkRoleFDroid }
+
+/** F-Droid listing. */
+const linkRoleFDroid = /*#__PURE__*/ l.token($nsid, 'linkRoleFDroid')
+
+export { linkRoleFDroid }
+
+/** An image associated with an app, including accessibility and display metadata. Exactly one of `image` (ATProto blob) or `uri` (remote URL) MUST be present. Consumers SHOULD ignore image items that have neither or both. */
+type Image = {
+  $type?: 'community.lexicon.app.defs#image'
+
+  /**
+   * How directories and stores should use the image. Omit this field when no known purpose fits.
+   */
+  purpose?:
+    | 'community.lexicon.app.defs#purposeIcon'
+    | 'community.lexicon.app.defs#purposeLogo'
+    | 'community.lexicon.app.defs#purposeHero'
+    | 'community.lexicon.app.defs#purposeScreenshot'
+    | 'community.lexicon.app.defs#purposeBanner'
+    | 'community.lexicon.app.defs#purposeSocialCard'
+    | 'community.lexicon.app.defs#purposeAppStore'
+    | 'community.lexicon.app.defs#purposeAd'
+    | l.UnknownString
+
+  /**
+   * The raw image file.
+   */
+  image?: l.BlobRef
+
+  /**
+   * Remote image URI.
+   */
+  uri?: l.UriString
+
+  /**
+   * Alt text description of the image, for accessibility.
+   */
+  alt: string
+  aspectRatio?: AspectRatio
+}
+
+export type { Image }
+
+/** An image associated with an app, including accessibility and display metadata. Exactly one of `image` (ATProto blob) or `uri` (remote URL) MUST be present. Consumers SHOULD ignore image items that have neither or both. */
+const image = /*#__PURE__*/ l.typedObject<Image>(
+  $nsid,
+  'image',
+  /*#__PURE__*/ l.object({
+    purpose: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.string<{
+        knownValues: [
+          'community.lexicon.app.defs#purposeIcon',
+          'community.lexicon.app.defs#purposeLogo',
+          'community.lexicon.app.defs#purposeHero',
+          'community.lexicon.app.defs#purposeScreenshot',
+          'community.lexicon.app.defs#purposeBanner',
+          'community.lexicon.app.defs#purposeSocialCard',
+          'community.lexicon.app.defs#purposeAppStore',
+          'community.lexicon.app.defs#purposeAd',
+        ]
+      }>(),
+    ),
+    image: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.blob({ accept: ['image/*'], maxSize: 2000000 }),
+    ),
+    uri: /*#__PURE__*/ l.optional(/*#__PURE__*/ l.string({ format: 'uri' })),
+    alt: /*#__PURE__*/ l.string({ maxLength: 1000, maxGraphemes: 300 }),
+    aspectRatio: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.ref<AspectRatio>((() => aspectRatio) as any),
+    ),
+  }),
+)
+
+export { image }
+
+/** width:height represents an aspect ratio. It may be approximate. */
+type AspectRatio = {
+  $type?: 'community.lexicon.app.defs#aspectRatio'
+  width: number
+  height: number
+}
+
+export type { AspectRatio }
+
+/** width:height represents an aspect ratio. It may be approximate. */
+const aspectRatio = /*#__PURE__*/ l.typedObject<AspectRatio>(
+  $nsid,
+  'aspectRatio',
+  /*#__PURE__*/ l.object({
+    width: /*#__PURE__*/ l.integer({ minimum: 1 }),
+    height: /*#__PURE__*/ l.integer({ minimum: 1 }),
+  }),
+)
+
+export { aspectRatio }
+
+/** A small square icon representing the app, typically used in launchers, lists, and tab bars. */
+type PurposeIcon = 'community.lexicon.app.defs#purposeIcon'
+
+export type { PurposeIcon }
+
+/** A small square icon representing the app, typically used in launchers, lists, and tab bars. */
+const purposeIcon = /*#__PURE__*/ l.token($nsid, 'purposeIcon')
+
+export { purposeIcon }
+
+/** A logotype or wordmark for the app. */
+type PurposeLogo = 'community.lexicon.app.defs#purposeLogo'
+
+export type { PurposeLogo }
+
+/** A logotype or wordmark for the app. */
+const purposeLogo = /*#__PURE__*/ l.token($nsid, 'purposeLogo')
+
+export { purposeLogo }
+
+/** A large promotional or feature image, typically used at the top of a directory listing. */
+type PurposeHero = 'community.lexicon.app.defs#purposeHero'
+
+export type { PurposeHero }
+
+/** A large promotional or feature image, typically used at the top of a directory listing. */
+const purposeHero = /*#__PURE__*/ l.token($nsid, 'purposeHero')
+
+export { purposeHero }
+
+/** A screenshot of the app's UI, used in directory and store listings. */
+type PurposeScreenshot = 'community.lexicon.app.defs#purposeScreenshot'
+
+export type { PurposeScreenshot }
+
+/** A screenshot of the app's UI, used in directory and store listings. */
+const purposeScreenshot = /*#__PURE__*/ l.token($nsid, 'purposeScreenshot')
+
+export { purposeScreenshot }
+
+/** A wide banner image, such as a header image for a profile or listing page. */
+type PurposeBanner = 'community.lexicon.app.defs#purposeBanner'
+
+export type { PurposeBanner }
+
+/** A wide banner image, such as a header image for a profile or listing page. */
+const purposeBanner = /*#__PURE__*/ l.token($nsid, 'purposeBanner')
+
+export { purposeBanner }
+
+/** An image sized and formatted for social media sharing previews (Open Graph, Twitter Card, etc.). */
+type PurposeSocialCard = 'community.lexicon.app.defs#purposeSocialCard'
+
+export type { PurposeSocialCard }
+
+/** An image sized and formatted for social media sharing previews (Open Graph, Twitter Card, etc.). */
+const purposeSocialCard = /*#__PURE__*/ l.token($nsid, 'purposeSocialCard')
+
+export { purposeSocialCard }
+
+/** A promotional image formatted for a native app store listing. */
+type PurposeAppStore = 'community.lexicon.app.defs#purposeAppStore'
+
+export type { PurposeAppStore }
+
+/** A promotional image formatted for a native app store listing. */
+const purposeAppStore = /*#__PURE__*/ l.token($nsid, 'purposeAppStore')
+
+export { purposeAppStore }
+
+/** A promotional or advertising image. */
+type PurposeAd = 'community.lexicon.app.defs#purposeAd'
+
+export type { PurposeAd }
+
+/** A promotional or advertising image. */
+const purposeAd = /*#__PURE__*/ l.token($nsid, 'purposeAd')
+
+export { purposeAd }
+
+/** Current release or maintenance status of an app. */
+type Status =
+  | 'community.lexicon.app.defs#unreleased'
+  | 'community.lexicon.app.defs#preview'
+  | 'community.lexicon.app.defs#released'
+  | 'community.lexicon.app.defs#unmaintained'
+  | 'community.lexicon.app.defs#discontinued'
+  | l.UnknownString
+
+export type { Status }
+
+/** Current release or maintenance status of an app. */
+const status = /*#__PURE__*/ l.string<{
+  knownValues: [
+    'community.lexicon.app.defs#unreleased',
+    'community.lexicon.app.defs#preview',
+    'community.lexicon.app.defs#released',
+    'community.lexicon.app.defs#unmaintained',
+    'community.lexicon.app.defs#discontinued',
+  ]
+}>()
+
+export { status }
+
+/** The app has been announced but is not yet available. */
+type Unreleased = 'community.lexicon.app.defs#unreleased'
+
+export type { Unreleased }
+
+/** The app has been announced but is not yet available. */
+const unreleased = /*#__PURE__*/ l.token($nsid, 'unreleased')
+
+export { unreleased }
+
+/** The app is available as an alpha, beta, early access, or preview release. */
+type Preview = 'community.lexicon.app.defs#preview'
+
+export type { Preview }
+
+/** The app is available as an alpha, beta, early access, or preview release. */
+const preview = /*#__PURE__*/ l.token($nsid, 'preview')
+
+export { preview }
+
+/** The app is generally available. */
+type Released = 'community.lexicon.app.defs#released'
+
+export type { Released }
+
+/** The app is generally available. */
+const released = /*#__PURE__*/ l.token($nsid, 'released')
+
+export { released }
+
+/** The app may still be available, but is no longer actively maintained. */
+type Unmaintained = 'community.lexicon.app.defs#unmaintained'
+
+export type { Unmaintained }
+
+/** The app may still be available, but is no longer actively maintained. */
+const unmaintained = /*#__PURE__*/ l.token($nsid, 'unmaintained')
+
+export { unmaintained }
+
+/** The app is no longer available or supported. */
+type Discontinued = 'community.lexicon.app.defs#discontinued'
+
+export type { Discontinued }
+
+/** The app is no longer available or supported. */
+const discontinued = /*#__PURE__*/ l.token($nsid, 'discontinued')
+
+export { discontinued }
+
+/** Platform where an app is available. */
+type Platform =
+  | 'community.lexicon.app.defs#platformWeb'
+  | 'community.lexicon.app.defs#platformIOS'
+  | 'community.lexicon.app.defs#platformAndroid'
+  | 'community.lexicon.app.defs#platformMacOS'
+  | 'community.lexicon.app.defs#platformWindows'
+  | 'community.lexicon.app.defs#platformLinux'
+  | 'community.lexicon.app.defs#platformCLI'
+  | l.UnknownString
+
+export type { Platform }
+
+/** Platform where an app is available. */
+const platform = /*#__PURE__*/ l.string<{
+  knownValues: [
+    'community.lexicon.app.defs#platformWeb',
+    'community.lexicon.app.defs#platformIOS',
+    'community.lexicon.app.defs#platformAndroid',
+    'community.lexicon.app.defs#platformMacOS',
+    'community.lexicon.app.defs#platformWindows',
+    'community.lexicon.app.defs#platformLinux',
+    'community.lexicon.app.defs#platformCLI',
+  ]
+}>()
+
+export { platform }
+
+/** Web app or website. */
+type PlatformWeb = 'community.lexicon.app.defs#platformWeb'
+
+export type { PlatformWeb }
+
+/** Web app or website. */
+const platformWeb = /*#__PURE__*/ l.token($nsid, 'platformWeb')
+
+export { platformWeb }
+
+/** iOS app. */
+type PlatformIOS = 'community.lexicon.app.defs#platformIOS'
+
+export type { PlatformIOS as PlatformIos }
+
+/** iOS app. */
+const platformIOS = /*#__PURE__*/ l.token($nsid, 'platformIOS')
+
+export { platformIOS }
+
+/** Android app. */
+type PlatformAndroid = 'community.lexicon.app.defs#platformAndroid'
+
+export type { PlatformAndroid }
+
+/** Android app. */
+const platformAndroid = /*#__PURE__*/ l.token($nsid, 'platformAndroid')
+
+export { platformAndroid }
+
+/** macOS app. */
+type PlatformMacOS = 'community.lexicon.app.defs#platformMacOS'
+
+export type { PlatformMacOS as PlatformMacOs }
+
+/** macOS app. */
+const platformMacOS = /*#__PURE__*/ l.token($nsid, 'platformMacOS')
+
+export { platformMacOS }
+
+/** Windows app. */
+type PlatformWindows = 'community.lexicon.app.defs#platformWindows'
+
+export type { PlatformWindows }
+
+/** Windows app. */
+const platformWindows = /*#__PURE__*/ l.token($nsid, 'platformWindows')
+
+export { platformWindows }
+
+/** Linux app. */
+type PlatformLinux = 'community.lexicon.app.defs#platformLinux'
+
+export type { PlatformLinux }
+
+/** Linux app. */
+const platformLinux = /*#__PURE__*/ l.token($nsid, 'platformLinux')
+
+export { platformLinux }
+
+/** Command line interface. */
+type PlatformCLI = 'community.lexicon.app.defs#platformCLI'
+
+export type { PlatformCLI as PlatformCli }
+
+/** Command line interface. */
+const platformCLI = /*#__PURE__*/ l.token($nsid, 'platformCLI')
+
+export { platformCLI }
+
+/** Self-declared AT Protocol lexicon interoperability signals. */
+type LexiconInterop = {
+  $type?: 'community.lexicon.app.defs#lexiconInterop'
+
+  /**
+   * Lexicon collections this app creates or publishes records for.
+   */
+  produces?: l.NsidString[]
+
+  /**
+   * Lexicon collections this app reads, displays, imports, or otherwise consumes.
+   */
+  consumes?: l.NsidString[]
+}
+
+export type { LexiconInterop }
+
+/** Self-declared AT Protocol lexicon interoperability signals. */
+const lexiconInterop = /*#__PURE__*/ l.typedObject<LexiconInterop>(
+  $nsid,
+  'lexiconInterop',
+  /*#__PURE__*/ l.object({
+    produces: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.array(/*#__PURE__*/ l.string({ format: 'nsid' })),
+    ),
+    consumes: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.array(/*#__PURE__*/ l.string({ format: 'nsid' })),
+    ),
+  }),
+)
+
+export { lexiconInterop }
+
+/** A record whose presence in an account can indicate that the account probably uses this app. */
+type AccountIndicator = {
+  $type?: 'community.lexicon.app.defs#accountIndicator'
+
+  /**
+   * Record collection to look for in an account repository.
+   */
+  collection: l.NsidString
+
+  /**
+   * Optional record key to look for within the collection.
+   */
+  rkey?: l.RecordKeyString
+}
+
+export type { AccountIndicator }
+
+/** A record whose presence in an account can indicate that the account probably uses this app. */
+const accountIndicator = /*#__PURE__*/ l.typedObject<AccountIndicator>(
+  $nsid,
+  'accountIndicator',
+  /*#__PURE__*/ l.object({
+    collection: /*#__PURE__*/ l.string({ format: 'nsid' }),
+    rkey: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.string({ format: 'record-key' }),
+    ),
+  }),
+)
+
+export { accountIndicator }
diff --git a/shared/lex/community/lexicon/app/defs.ts b/shared/lex/community/lexicon/app/defs.ts
new file mode 100644
index 00000000..f3af51b8
--- /dev/null
+++ b/shared/lex/community/lexicon/app/defs.ts
@@ -0,0 +1,5 @@
+/*
+ * THIS FILE WAS GENERATED BY "@atproto/lex". DO NOT EDIT.
+ */
+
+export * from './defs.defs.ts'
diff --git a/shared/lex/dev/roe.ts b/shared/lex/dev/roe.ts
index 388732b6..978eac23 100644
--- a/shared/lex/dev/roe.ts
+++ b/shared/lex/dev/roe.ts
@@ -6,6 +6,8 @@ export * as ama from './roe/ama.ts'
 export * as entity from './roe/entity.ts'
 export * as invite from './roe/invite.ts'
 export * as location from './roe/location.ts'
+export * as project from './roe/project.ts'
+export * as projectCategory from './roe/projectCategory.ts'
 export * as sync from './roe/sync.ts'
 export * as talk from './roe/talk.ts'
 export * as talkGroup from './roe/talkGroup.ts'
diff --git a/shared/lex/dev/roe/project.defs.ts b/shared/lex/dev/roe/project.defs.ts
new file mode 100644
index 00000000..85556572
--- /dev/null
+++ b/shared/lex/dev/roe/project.defs.ts
@@ -0,0 +1,110 @@
+/*
+ * THIS FILE WAS GENERATED BY "@atproto/lex". DO NOT EDIT.
+ */
+
+import { l } from '@atproto/lex'
+import * as RepoStrongRef from '../../com/atproto/repo/strongRef.defs.ts'
+import * as AppDefs from '../../community/lexicon/app/defs.defs.ts'
+
+const $nsid = 'dev.roe.project'
+
+type $nsid = typeof $nsid
+
+export { $nsid }
+
+/** A project on the /projects page, belonging to a dev.roe.projectCategory. */
+type Main = {
+  $type: 'dev.roe.project'
+
+  /**
+   * Strong-ref to the parent dev.roe.projectCategory record.
+   */
+  category: RepoStrongRef.Main
+  name: string
+  description?: string
+
+  /**
+   * Relevant destinations for the project. The site links the card at the first `linkRoleWebsite`, falling back to the first link of any role.
+   */
+  links?: AppDefs.Link[]
+
+  /**
+   * Visual assets for the project. The site renders the first `purposeScreenshot`, falling back to the first image of any purpose.
+   */
+  images?: AppDefs.Image[]
+
+  /**
+   * Release or maintenance status. `unmaintained` and `discontinued` render the card as archived.
+   */
+  status?: AppDefs.Status
+
+  /**
+   * UnoCSS icon class, e.g. `i-ri:rocket-line`. Used when there is no image.
+   */
+  icon?: string
+
+  /**
+   * Lower values render first within the category. Defaults to 100 in the editor.
+   */
+  order?: number
+  createdAt: l.DatetimeString
+}
+
+export type { Main }
+
+/** A project on the /projects page, belonging to a dev.roe.projectCategory. */
+const main = /*#__PURE__*/ l.record<'tid', Main>(
+  'tid',
+  $nsid,
+  /*#__PURE__*/ l.object({
+    category: /*#__PURE__*/ l.ref<RepoStrongRef.Main>(
+      (() => RepoStrongRef.main) as any,
+    ),
+    name: /*#__PURE__*/ l.string({ maxLength: 2560, maxGraphemes: 256 }),
+    description: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.string({ maxLength: 25000, maxGraphemes: 2500 }),
+    ),
+    links: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.array(
+        /*#__PURE__*/ l.ref<AppDefs.Link>((() => AppDefs.link) as any),
+        { maxLength: 12 },
+      ),
+    ),
+    images: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.array(
+        /*#__PURE__*/ l.ref<AppDefs.Image>((() => AppDefs.image) as any),
+        { maxLength: 8 },
+      ),
+    ),
+    status: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.ref<AppDefs.Status>((() => AppDefs.status) as any),
+    ),
+    icon: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.string({ maxLength: 640, maxGraphemes: 64 }),
+    ),
+    order: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.withDefault(/*#__PURE__*/ l.integer(), 100),
+    ),
+    createdAt: /*#__PURE__*/ l.string({ format: 'datetime' }),
+  }),
+)
+
+export { main }
+
+const $type = $nsid
+
+type $type = typeof $type
+
+export { $type }
+
+export const $isTypeOf = /*#__PURE__*/ main.isTypeOf.bind(main)
+export const $build = /*#__PURE__*/ main.build.bind(main)
+export const $assert = /*#__PURE__*/ main.assert.bind(main)
+export const $check = /*#__PURE__*/ main.check.bind(main)
+export const $cast = /*#__PURE__*/ main.cast.bind(main)
+export const $ifMatches = /*#__PURE__*/ main.ifMatches.bind(main)
+export const $matches = /*#__PURE__*/ main.matches.bind(main)
+export const $parse = /*#__PURE__*/ main.parse.bind(main)
+export const $safeParse = /*#__PURE__*/ main.safeParse.bind(main)
+export const $validate = /*#__PURE__*/ main.validate.bind(main)
+export const $safeValidate = /*#__PURE__*/ main.safeValidate.bind(main)
diff --git a/shared/lex/dev/roe/project.ts b/shared/lex/dev/roe/project.ts
new file mode 100644
index 00000000..da441a2e
--- /dev/null
+++ b/shared/lex/dev/roe/project.ts
@@ -0,0 +1,6 @@
+/*
+ * THIS FILE WAS GENERATED BY "@atproto/lex". DO NOT EDIT.
+ */
+
+export * from './project.defs.ts'
+export { main as default } from './project.defs.ts'
diff --git a/shared/lex/dev/roe/projectCategory.defs.ts b/shared/lex/dev/roe/projectCategory.defs.ts
new file mode 100644
index 00000000..bd9205a1
--- /dev/null
+++ b/shared/lex/dev/roe/projectCategory.defs.ts
@@ -0,0 +1,58 @@
+/*
+ * THIS FILE WAS GENERATED BY "@atproto/lex". DO NOT EDIT.
+ */
+
+import { l } from '@atproto/lex'
+
+const $nsid = 'dev.roe.projectCategory'
+
+type $nsid = typeof $nsid
+
+export { $nsid }
+
+/** A category on the /projects page. Projects belong to a category via dev.roe.project.category. */
+type Main = {
+  $type: 'dev.roe.projectCategory'
+  title: string
+
+  /**
+   * Lower values render first. Defaults to 100 in the editor.
+   */
+  order?: number
+  createdAt: l.DatetimeString
+}
+
+export type { Main }
+
+/** A category on the /projects page. Projects belong to a category via dev.roe.project.category. */
+const main = /*#__PURE__*/ l.record<'tid', Main>(
+  'tid',
+  $nsid,
+  /*#__PURE__*/ l.object({
+    title: /*#__PURE__*/ l.string({ maxLength: 2560, maxGraphemes: 256 }),
+    order: /*#__PURE__*/ l.optional(
+      /*#__PURE__*/ l.withDefault(/*#__PURE__*/ l.integer(), 100),
+    ),
+    createdAt: /*#__PURE__*/ l.string({ format: 'datetime' }),
+  }),
+)
+
+export { main }
+
+const $type = $nsid
+
+type $type = typeof $type
+
+export { $type }
+
+export const $isTypeOf = /*#__PURE__*/ main.isTypeOf.bind(main)
+export const $build = /*#__PURE__*/ main.build.bind(main)
+export const $assert = /*#__PURE__*/ main.assert.bind(main)
+export const $check = /*#__PURE__*/ main.check.bind(main)
+export const $cast = /*#__PURE__*/ main.cast.bind(main)
+export const $ifMatches = /*#__PURE__*/ main.ifMatches.bind(main)
+export const $matches = /*#__PURE__*/ main.matches.bind(main)
+export const $parse = /*#__PURE__*/ main.parse.bind(main)
+export const $safeParse = /*#__PURE__*/ main.safeParse.bind(main)
+export const $validate = /*#__PURE__*/ main.validate.bind(main)
+export const $safeValidate = /*#__PURE__*/ main.safeValidate.bind(main)
diff --git a/shared/lex/dev/roe/projectCategory.ts b/shared/lex/dev/roe/projectCategory.ts
new file mode 100644
index 00000000..56b35a6e
--- /dev/null
+++ b/shared/lex/dev/roe/projectCategory.ts
@@ -0,0 +1,6 @@
+/*
+ * THIS FILE WAS GENERATED BY "@atproto/lex". DO NOT EDIT.
+ */
+
+export * from './projectCategory.defs.ts'
+export { main as default } from './projectCategory.defs.ts'
diff --git a/shared/lex/index.ts b/shared/lex/index.ts
index b889d2cd..2242963d 100644
--- a/shared/lex/index.ts
+++ b/shared/lex/index.ts
@@ -3,4 +3,5 @@
  */
 
 export * as com from './com.ts'
+export * as community from './community.ts'
 export * as dev from './dev.ts'
diff --git a/shared/project-icons.ts b/shared/project-icons.ts
new file mode 100644
index 00000000..5c586251
--- /dev/null
+++ b/shared/project-icons.ts
@@ -0,0 +1,41 @@
+/**
+ * Icons offered for `dev.roe.project.icon`. Project records live on the PDS, so
+ * nothing in the source tree references these classes and UnoCSS can't discover
+ * them; `uno.config.ts` safelists this list and the admin editor offers exactly
+ * the same set. Adding an icon here is what makes it available to pick.
+ */
+export const projectIcons = [
+  'i-ri:archive-line',
+  'i-ri:archive-stack-line',
+  'i-ri:arrow-up-circle-line',
+  'i-ri:braces-line',
+  'i-ri:bubble-chart-line',
+  'i-ri:cpu-line',
+  'i-ri:css3-line',
+  'i-ri:dashboard-3-line',
+  'i-ri:database-2-line',
+  'i-ri:database-line',
+  'i-ri:error-warning-line',
+  'i-ri:exchange-line',
+  'i-ri:file-zip-line',
+  'i-ri:filter-off-line',
+  'i-ri:flashlight-line',
+  'i-ri:folder-download-line',
+  'i-ri:font-family',
+  'i-ri:font-size',
+  'i-ri:keyboard-line',
+  'i-ri:link',
+  'i-ri:list-ordered',
+  'i-ri:magic-line',
+  'i-ri:reactjs-line',
+  'i-ri:refresh-line',
+  'i-ri:restaurant-line',
+  'i-ri:route-line',
+  'i-ri:server-line',
+  'i-ri:shield-check-line',
+  'i-ri:shield-keyhole-line',
+  'i-ri:text-spacing',
+  'i-ri:toggle-line',
+  'i-ri:vidicon-line',
+  'i-ri:walk-line',
+] as const
diff --git a/test/unit/bundle.spec.ts b/test/unit/bundle.spec.ts
index 467a6310..cdd1b2ff 100644
--- a/test/unit/bundle.spec.ts
+++ b/test/unit/bundle.spec.ts
@@ -63,7 +63,7 @@ describe('project sizes', () => {
 
     expect
       .soft(roundToKilobytes(stats.client.totalBytes))
-      .toMatchInlineSnapshot(`"268k"`)
+      .toMatchInlineSnapshot(`"269k"`)
     expect.soft(stats.client.files.map(f => f.replace(/\..*\.js/, '.js')).sort())
       .toMatchInlineSnapshot(`
         [
@@ -77,7 +77,7 @@ describe('project sizes', () => {
     stats.server = await analyzeSizes(['**/*.mjs', '!node_modules'], serverDir)
     expect
       .soft(roundToKilobytes(stats.server.totalBytes, 10))
-      .toMatchInlineSnapshot(`"1880k"`)
+      .toMatchInlineSnapshot(`"1940k"`)
 
     const modules = await analyzeSizes('node_modules/**/*', serverDir)
     const portableModules = await analyzeSizes(
diff --git a/uno.config.ts b/uno.config.ts
index 620413d4..c1f856ab 100644
--- a/uno.config.ts
+++ b/uno.config.ts
@@ -1,16 +1,18 @@
 import { defineConfig, presetIcons, presetWind3 } from 'unocss'
 import { createResolver } from 'nuxt/kit'
 
+import { projectIcons } from './shared/project-icons'
+
 const resolver = createResolver(import.meta.url)
 
 export default defineConfig({
   content: {
     filesystem: [
       resolver.resolve('./content/**/*.md'),
-      resolver.resolve('./content/projects.yml'),
       resolver.resolve('./app/**/*.vue'),
     ],
   },
+  safelist: [...projectIcons],
   shortcuts: [
     {
       'underlined-link':
-- 
2.51.2