Skip to content

Agent skills for useful HTML artifacts, wireframes, interactive prototypes, plans, and diagrams.

Isolate the website under site (#17)

Michael Ramos6530b0c38c88
diff --git a/.gitignore b/.gitignore
index 84621d1..9b5ba35 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,15 +1,20 @@
# dependencies
/node_modules
+/site/node_modules
# Next.js
/.next
/out
+/site/.next
+/site/out
# Fumadocs
/.source
+/site/.source
# production
/build
+/site/build
# local
.DS_Store
@@ -18,10 +23,11 @@
# Vercel
.vercel
+/site/.vercel
# local visual review material
/art/banner-candidates/
-/.impeccable/screenshots/
+/site/.impeccable/screenshots/
# TypeScript
*.tsbuildinfo
diff --git a/.impeccable/surfaces/app-catalog-folio-page-tsx.md b/.impeccable/surfaces/app-catalog-folio-page-tsx.md
deleted file mode 100644
index 6811f4e..0000000
--- a/.impeccable/surfaces/app-catalog-folio-page-tsx.md
+++ /dev/null
@@ -1,30 +0,0 @@
----
-version: 1
-slug: "app-catalog-folio-page-tsx"
-primary_target: "app/catalog/folio/page.tsx"
-related_targets: ["components/catalog-folio.tsx", "components/catalog-folio.module.css"]
----
-
-# Retired catalog folio route
-
-Approved visual reference: `.impeccable/mocks/catalog-editorial-category-bands.png`
-
-## Status and visitor mode
-
-Retired route `/catalog/folio`; Experience mode. The separate comparison page no longer exists because its compact folio behavior is now a mode of the primary catalog.
-
-## Redirect behavior
-
-Requests redirect to `/catalog#catalog-collection`, placing the visitor at the primary catalog controls and shared collection. The redirect preserves old review links while avoiding two divergent catalog implementations.
-
-All twenty-eight entries, filters, source actions, and Expanded / Compact presentation now live at `/catalog`. Compact is a state of that route, not a separate URL or reduced evidence set.
-
-## Retired implementation guidance
-
-- Do not rebuild or maintain a second catalog at this route.
-- Do not encode the active catalog view in this legacy path.
-- Make catalog layout, motion, accessibility, and responsive changes in the primary `/catalog` surface and its shared explorer.
-
-## Reviewer verdict
-
-PASS
diff --git a/README.md b/README.md
index e09f053..3c5902f 100644
--- a/README.md
+++ b/README.md
@@ -107,8 +107,16 @@ examples/
├── wireframe.html
├── prototype.html
└── screenshots/
+
+site/
+├── app/ # Next.js routes
+├── content/docs/ # Fumadocs guide
+└── public/ # Deployed catalog artifacts
```
+The installable skills and their examples stay at the repository root. The
+website is isolated under `site/` and deployed from that directory.
+
This project was inspired by Thariq Shihipar's [The unreasonable effectiveness of HTML](https://thariqs.github.io/html-effectiveness).
<p align="center">
diff --git a/components/catalog-folio.module.css b/components/catalog-folio.module.css
deleted file mode 100644
index 142c24f..0000000
--- a/components/catalog-folio.module.css
+++ /dev/null
@@ -1,805 +0,0 @@
-.folioPage {
- min-height: 100vh;
- overflow: clip;
- background: var(--ink);
- color: var(--paper-bright);
-}
-
-.hero {
- display: grid;
- grid-template-columns: minmax(15rem, 2.35fr) minmax(28rem, 5.15fr) minmax(18rem, 3fr);
- gap: clamp(1.5rem, 3vw, 3.5rem);
- align-items: center;
- width: min(calc(100% - 4rem), var(--content-max));
- min-height: 20rem;
- margin: 0 auto;
- padding: 1.5rem 0 2rem;
-}
-
-.heroTitle h1 {
- margin: 0;
- font-size: clamp(4.6rem, 6vw, 5.2rem);
- font-weight: 830;
- letter-spacing: -0.04em;
- line-height: 0.84;
-}
-
-.heroTitle p {
- max-width: 22rem;
- margin: 1.5rem 0 0;
- color: #cfc2b2;
- font-size: 0.88rem;
- line-height: 1.55;
-}
-
-.heroTitle > a {
- display: inline-flex;
- align-items: center;
- gap: 0.45rem;
- margin-top: 1.35rem;
- border-bottom: 1px solid var(--green);
- font-size: 0.75rem;
- font-weight: 720;
-}
-
-.heroTitle svg,
-.specimenLinks svg,
-.nativeStrip article > div a svg {
- width: 0.85rem;
-}
-
-.folioStage {
- position: relative;
- min-height: 18rem;
-}
-
-.folioSheet {
- position: absolute;
- overflow: hidden;
- border: 1px solid rgba(20, 20, 19, 0.72);
- border-radius: 0.34rem;
- background: var(--paper);
- box-shadow: 0 16px 30px rgba(0, 0, 0, 0.34);
-}
-
-.folioSheet img {
- display: block;
- width: 100%;
- height: 100%;
- object-fit: contain;
-}
-
-.folioSheet:nth-child(1) {
- z-index: 1;
- top: 3.8rem;
- left: 0;
- width: 23%;
- height: 12.5rem;
- transform: rotate(-5deg);
-}
-
-.folioSheet:nth-child(2) {
- z-index: 4;
- top: 1.8rem;
- left: 19%;
- width: 24%;
- height: 15.5rem;
- transform: rotate(-1deg);
-}
-
-.folioSheet:nth-child(3) {
- z-index: 3;
- top: 0;
- left: 42%;
- width: 30%;
- height: 14.5rem;
- transform: rotate(3deg);
-}
-
-.folioSheet:nth-child(4) {
- z-index: 5;
- right: 1%;
- bottom: 0.5rem;
- width: 22%;
- height: 13.5rem;
- transform: rotate(5deg);
-}
-
-.folioSheet:nth-child(5) {
- z-index: 2;
- right: 20%;
- bottom: 0;
- width: 20%;
- height: 10.5rem;
- transform: rotate(-3deg);
-}
-
-.sourceIndex > label {
- display: flex;
- align-items: center;
- gap: 0.65rem;
- min-height: 3rem;
- padding: 0 0.85rem;
- border: 1px solid rgba(243, 230, 210, 0.32);
- border-radius: 0.4rem;
- background: var(--ink-soft);
-}
-
-.sourceIndex > label:focus-within {
- border-color: var(--lilac);
- box-shadow: inset 0 0 0 2px var(--lilac);
-}
-
-.sourceIndex label svg {
- width: 1rem;
- color: #b7aa99;
-}
-
-.sourceIndex input {
- width: 100%;
- min-width: 0;
- border: 0;
- outline: 0;
- background: transparent;
- color: var(--paper-bright);
- font-size: 0.78rem;
-}
-
-.sourceIndex input::placeholder {
- color: #a99c8c;
-}
-
-.sourceHeading {
- display: flex;
- align-items: baseline;
- justify-content: space-between;
- margin: 1.5rem 0 0.85rem;
-}
-
-.sourceHeading h2 {
- margin: 0;
- font-size: 1rem;
-}
-
-.sourceHeading span {
- color: #a99c8c;
- font-size: 0.65rem;
-}
-
-.sourceIndex nav {
- display: grid;
- grid-template-columns: repeat(3, minmax(0, 1fr));
- gap: 0.55rem;
-}
-
-.sourceIndex nav a {
- display: grid;
- grid-template-columns: auto 1fr auto;
- gap: 0.4rem;
- align-items: center;
- min-height: 3rem;
- padding: 0.45rem 0.55rem;
- border: 1px solid rgba(243, 230, 210, 0.25);
- border-radius: 0.32rem;
- color: #cfc2b2;
-}
-
-.sourceIndex nav a:hover {
- border-color: var(--green);
- color: var(--paper-bright);
-}
-
-.sourceIndex nav svg {
- width: 0.95rem;
-}
-
-.sourceIndex nav span {
- overflow: hidden;
- font-size: 0.58rem;
- text-overflow: ellipsis;
- white-space: nowrap;
-}
-
-.sourceIndex nav small {
- color: var(--green);
- font-size: 0.58rem;
-}
-
-.bands {
- display: grid;
- gap: 0.7rem;
- width: min(calc(100% - 4rem), var(--content-max));
- margin: 0 auto;
- padding-bottom: 0.7rem;
-}
-
-.band {
- display: grid;
- grid-template-columns: minmax(14rem, 2.25fr) minmax(0, 9.75fr);
- min-height: 14.5rem;
- overflow: hidden;
- border-radius: 0.5rem;
- background: var(--folio-band);
- color: var(--folio-foreground);
- scroll-margin-top: 1rem;
-}
-
-.bandRail {
- display: flex;
- flex-direction: column;
- justify-content: space-between;
- padding: 1.15rem 1.2rem;
- border-right: 1px solid color-mix(in srgb, currentColor 35%, transparent);
-}
-
-.bandRail h2 {
- margin: 0;
- font-size: clamp(2rem, 2.6vw, 2.75rem);
- font-weight: 790;
- letter-spacing: -0.04em;
- line-height: 0.9;
-}
-
-.bandRail > div > span {
- display: block;
- margin-top: 0.8rem;
- font-size: 0.65rem;
- opacity: 0.8;
-}
-
-.bandModes {
- display: grid;
- border-top: 1px solid color-mix(in srgb, currentColor 45%, transparent);
-}
-
-.bandModes a,
-.bandModes button {
- display: flex;
- align-items: center;
- gap: 0.6rem;
- min-height: 2.4rem;
- padding: 0.3rem 0;
- border: 0;
- border-bottom: 1px solid color-mix(in srgb, currentColor 32%, transparent);
- outline-offset: -3px;
- background: transparent;
- color: inherit;
- cursor: pointer;
- font-size: 0.68rem;
- text-align: left;
-}
-
-.bandModes button[aria-pressed="true"] {
- font-weight: 780;
-}
-
-.bandModes button[aria-pressed="true"]::after {
- width: 0.45rem;
- height: 0.45rem;
- margin-left: auto;
- border-radius: 50%;
- background: currentColor;
- content: "";
-}
-
-.bandModes svg {
- width: 1rem;
-}
-
-.specimenShelf {
- display: grid;
- gap: clamp(0.75rem, 1.2vw, 1.2rem);
- align-items: stretch;
- padding: 1rem;
-}
-
-.specimenShelf[data-count="3"] {
- grid-template-columns: minmax(0, 1fr) minmax(0, 1.45fr) minmax(0, 0.82fr);
-}
-
-.specimenShelf[data-count="2"] {
- grid-template-columns: minmax(0, 1fr) minmax(0, 1.35fr);
-}
-
-.specimenShelf[data-count="1"] {
- grid-template-columns: minmax(22rem, 42rem);
-}
-
-.specimen {
- display: grid;
- grid-template-columns: minmax(7rem, 0.85fr) minmax(0, 1.15fr);
- min-width: 0;
- overflow: hidden;
- border: 1px solid rgba(20, 20, 19, 0.58);
- border-radius: 0.38rem;
- background: var(--paper-bright);
- color: var(--ink);
- box-shadow: 0 14px 24px rgba(20, 20, 19, 0.18);
-}
-
-.specimenShelf[data-count="3"] .specimen:nth-child(3) {
- grid-template-columns: 1fr;
-}
-
-.specimenImage {
- display: grid;
- place-items: center;
- min-width: 0;
- padding: 0.8rem;
- border-right: 1px solid rgba(20, 20, 19, 0.24);
- background: var(--paper);
-}
-
-.specimenImage img {
- display: block;
- width: 100%;
- height: 9.5rem;
- object-fit: contain;
-}
-
-.specimenShelf[data-count="3"] .specimen:nth-child(3) .specimenImage {
- min-height: 7rem;
- border-right: 0;
- border-bottom: 1px solid rgba(20, 20, 19, 0.24);
-}
-
-.specimenShelf[data-count="3"] .specimen:nth-child(3) .specimenImage img {
- height: 6.2rem;
-}
-
-.specimenBody {
- display: flex;
- flex-direction: column;
- min-width: 0;
- padding: 0.9rem;
-}
-
-.specimenBody > span {
- color: var(--cobalt);
- font-size: 0.58rem;
- font-weight: 760;
-}
-
-.specimenBody h3 {
- margin: 0.45rem 0 0;
- font-size: clamp(0.95rem, 1.35vw, 1.35rem);
- font-weight: 760;
- letter-spacing: -0.025em;
- line-height: 1.05;
-}
-
-.specimenBody p {
- display: -webkit-box;
- margin: 0.6rem 0 0;
- overflow: hidden;
- color: #575149;
- font-size: 0.67rem;
- line-height: 1.45;
- -webkit-box-orient: vertical;
- -webkit-line-clamp: 3;
-}
-
-.specimenLinks {
- display: flex;
- flex-wrap: wrap;
- gap: 0.8rem;
- margin-top: auto;
- padding-top: 0.7rem;
-}
-
-.specimenLinks a {
- display: inline-flex;
- align-items: center;
- gap: 0.2rem;
- min-height: 1.8rem;
- font-size: 0.62rem;
- font-weight: 750;
-}
-
-.nativeStrip,
-.skillStrip {
- width: min(calc(100% - 4rem), var(--content-max));
- margin: 0.7rem auto 0;
-}
-
-.nativeStrip {
- display: grid;
- grid-template-columns: minmax(14rem, 2.25fr) minmax(0, 9.75fr);
- overflow: hidden;
- border: 1px solid rgba(243, 230, 210, 0.24);
- border-radius: 0.5rem;
- background: var(--ink-soft);
-}
-
-.nativeStrip > header {
- padding: 1.55rem 1.35rem;
- border-right: 1px solid rgba(243, 230, 210, 0.22);
-}
-
-.nativeStrip h2,
-.skillStrip h2 {
- margin: 0;
- font-size: 1.15rem;
-}
-
-.nativeStrip header p {
- margin: 0.8rem 0 0;
- color: #b7aa99;
- font-size: 0.7rem;
- line-height: 1.5;
-}
-
-.nativeStrip > div {
- display: grid;
- grid-template-columns: repeat(2, minmax(0, 1fr));
- gap: 1rem;
- padding: 1rem;
-}
-
-.nativeStrip article {
- display: grid;
- grid-template-columns: minmax(8rem, 1.2fr) minmax(0, 1fr);
- overflow: hidden;
- border-radius: 0.35rem;
- background: var(--paper-bright);
- color: var(--ink);
-}
-
-.nativeStrip article > a {
- min-height: 9rem;
- overflow: hidden;
-}
-
-.nativeStrip article img {
- display: block;
- width: 100%;
- height: 100%;
- object-fit: cover;
- object-position: top;
-}
-
-.nativeStrip article > div {
- display: flex;
- flex-direction: column;
- padding: 0.9rem;
-}
-
-.nativeStrip article > div span {
- color: var(--cobalt);
- font-size: 0.6rem;
- font-weight: 760;
-}
-
-.nativeStrip article h3 {
- margin: 0.45rem 0 0;
- font-size: 1rem;
-}
-
-.nativeStrip article > div a {
- display: inline-flex;
- align-items: center;
- gap: 0.3rem;
- margin-top: auto;
- font-size: 0.65rem;
- font-weight: 740;
-}
-
-.skillStrip {
- display: grid;
- grid-template-columns: minmax(14rem, 2.25fr) minmax(0, 9.75fr);
- align-items: start;
- margin-bottom: 0;
- padding: 1.6rem 1.35rem 2rem;
- background: var(--paper);
- color: var(--ink);
-}
-
-.skillStrip > div {
- display: grid;
- grid-template-columns: repeat(5, minmax(0, 1fr));
-}
-
-.skillStrip article {
- display: grid;
- grid-template-columns: auto minmax(0, 1fr);
- gap: 0.6rem;
- min-width: 0;
- padding: 0 1rem;
- border-left: 1px solid rgba(20, 20, 19, 0.34);
-}
-
-.skillStrip article > span {
- width: 0.7rem;
- height: 0.7rem;
- margin-top: 0.18rem;
- border-radius: 50%;
- background: var(--cobalt);
-}
-
-.skillStrip article > span[data-color="green"] {
- border-radius: 0.05rem;
- background: var(--green);
-}
-
-.skillStrip article > span[data-color="lilac"] {
- background: var(--lilac);
-}
-
-.skillStrip article > span[data-color="pink"] {
- background: var(--pink);
-}
-
-.skillStrip article > span[data-color="coral"] {
- border-radius: 0.05rem;
- background: var(--coral);
- transform: rotate(45deg);
-}
-
-.skillStrip h3 {
- margin: 0;
- font-size: 0.78rem;
-}
-
-.skillStrip p {
- display: -webkit-box;
- margin: 0.35rem 0 0;
- overflow: hidden;
- color: var(--muted);
- font-size: 0.62rem;
- line-height: 1.4;
- -webkit-box-orient: vertical;
- -webkit-line-clamp: 2;
-}
-
-.skillLinks {
- display: flex;
- gap: 0.55rem;
- margin-top: 0.55rem;
-}
-
-.skillLinks a {
- display: inline-flex;
- align-items: center;
- gap: 0.2rem;
- font-size: 0.58rem;
- font-weight: 730;
-}
-
-.skillLinks svg {
- width: 0.7rem;
-}
-
-.emptyState {
- display: grid;
- justify-items: start;
- width: min(calc(100% - 4rem), var(--content-max));
- min-height: 24rem;
- margin: 0 auto;
- padding: 5rem 0;
-}
-
-.emptyState > svg {
- width: 2.5rem;
-}
-
-.emptyState h2 {
- max-width: 12ch;
- margin: 1.2rem 0;
- font-size: 2.7rem;
- line-height: 0.95;
-}
-
-.emptyState button {
- min-height: 2.75rem;
- padding: 0 0.9rem;
- border: 0;
- border-radius: 0.35rem;
- background: var(--green);
- color: var(--ink);
- cursor: pointer;
- font-weight: 740;
-}
-
-.visuallyHidden {
- position: absolute;
- width: 1px;
- height: 1px;
- padding: 0;
- overflow: hidden;
- clip: rect(0, 0, 0, 0);
- white-space: nowrap;
- border: 0;
-}
-
-@media (max-width: 1160px) {
- .hero {
- grid-template-columns: minmax(13rem, 2fr) minmax(28rem, 5fr);
- }
-
- .sourceIndex {
- grid-column: 1 / -1;
- display: grid;
- grid-template-columns: minmax(16rem, 1fr) minmax(0, 2fr);
- gap: 1rem 2rem;
- }
-
- .sourceHeading {
- align-self: end;
- margin: 0;
- }
-
- .sourceIndex nav {
- grid-column: 1 / -1;
- grid-template-columns: repeat(9, minmax(0, 1fr));
- }
-
- .sourceIndex nav a {
- grid-template-columns: 1fr;
- justify-items: center;
- }
-
- .sourceIndex nav span {
- display: none;
- }
-
- .band {
- grid-template-columns: minmax(12rem, 2.5fr) minmax(0, 9.5fr);
- }
-
- .specimenShelf[data-count="3"] {
- grid-template-columns: repeat(3, minmax(14rem, 1fr));
- overflow-x: auto;
- }
-
- .specimenShelf[data-count="2"] {
- grid-template-columns: repeat(2, minmax(18rem, 1fr));
- }
-
- .specimen,
- .specimenShelf[data-count="3"] .specimen:nth-child(3) {
- grid-template-columns: 1fr;
- }
-
- .specimenImage,
- .specimenShelf[data-count="3"] .specimen:nth-child(3) .specimenImage {
- min-height: 8rem;
- border-right: 0;
- border-bottom: 1px solid rgba(20, 20, 19, 0.24);
- }
-
- .specimenImage img,
- .specimenShelf[data-count="3"] .specimen:nth-child(3) .specimenImage img {
- height: 7rem;
- }
-
- .skillStrip {
- grid-template-columns: 1fr;
- gap: 1.2rem;
- }
-}
-
-@media (max-width: 760px) {
- .hero,
- .bands,
- .nativeStrip,
- .skillStrip,
- .emptyState {
- width: calc(100% - 2rem);
- }
-
- .hero {
- grid-template-columns: 1fr;
- padding-top: 1.5rem;
- }
-
- .heroTitle h1 {
- font-size: clamp(4rem, 21vw, 5.5rem);
- }
-
- .folioStage {
- min-height: 17rem;
- }
-
- .sourceIndex {
- grid-column: 1;
- grid-template-columns: 1fr;
- }
-
- .sourceIndex nav {
- grid-column: 1;
- display: flex;
- overflow-x: auto;
- scroll-snap-type: x mandatory;
- }
-
- .sourceIndex nav a {
- width: 4.6rem;
- flex: none;
- scroll-snap-align: start;
- }
-
- .band,
- .nativeStrip {
- grid-template-columns: 1fr;
- }
-
- .bandRail {
- display: grid;
- grid-template-columns: 1fr minmax(10rem, 0.9fr);
- gap: 1rem;
- border-right: 0;
- border-bottom: 1px solid color-mix(in srgb, currentColor 35%, transparent);
- }
-
- .specimenShelf,
- .specimenShelf[data-count="1"],
- .specimenShelf[data-count="2"],
- .specimenShelf[data-count="3"] {
- display: flex;
- overflow-x: auto;
- scroll-snap-type: x mandatory;
- }
-
- .specimen {
- min-width: min(19rem, 82vw);
- scroll-snap-align: start;
- }
-
- .nativeStrip > header {
- border-right: 0;
- border-bottom: 1px solid rgba(243, 230, 210, 0.22);
- }
-
- .skillStrip > div {
- grid-template-columns: 1fr;
- }
-
- .skillStrip article {
- padding: 0.9rem 0;
- border-top: 1px solid rgba(20, 20, 19, 0.34);
- border-left: 0;
- }
-}
-
-@media (max-width: 520px) {
- .folioSheet:nth-child(1) {
- width: 28%;
- }
-
- .folioSheet:nth-child(2) {
- left: 15%;
- width: 30%;
- }
-
- .folioSheet:nth-child(3) {
- left: 40%;
- width: 35%;
- }
-
- .folioSheet:nth-child(4) {
- width: 28%;
- }
-
- .folioSheet:nth-child(5) {
- display: none;
- }
-
- .bandRail {
- grid-template-columns: 1fr;
- }
-
- .nativeStrip > div {
- grid-template-columns: 1fr;
- }
-
- .nativeStrip article {
- grid-template-columns: 1.3fr 1fr;
- }
-}
-
-@media (prefers-reduced-motion: reduce) {
- .sourceIndex a,
- .heroTitle a {
- scroll-behavior: auto;
- }
-}
diff --git a/components/catalog-folio.tsx b/components/catalog-folio.tsx
deleted file mode 100644
index b7bed62..0000000
--- a/components/catalog-folio.tsx
+++ /dev/null
@@ -1,361 +0,0 @@
-"use client";
-
-import {
- catalogArtifacts,
- catalogCategories,
- catalogSkills,
- featuredNativeArtifact,
- nativeExamples,
- type CatalogArtifact,
- type CatalogCategory,
-} from "@/lib/catalog-data";
-import { FeaturedSequence } from "@/components/featured-sequence";
-import {
- ArrowUpRight,
- BookOpen,
- Boxes,
- ChartNoAxesCombined,
- Code2,
- FileCode2,
- GitCompareArrows,
- Image as ImageIcon,
- MousePointer2,
- PanelsTopLeft,
- Presentation,
- ScanSearch,
- Search,
- Sparkles,
- SwatchBook,
- Workflow,
-} from "lucide-react";
-import Image from "next/image";
-import Link from "next/link";
-import type { CSSProperties, ComponentType } from "react";
-import { useMemo, useState } from "react";
-import styles from "./catalog-folio.module.css";
-
-const categoryIcons: Record<string, ComponentType<{ "aria-hidden"?: boolean }>> = {
- exploration: GitCompareArrows,
- review: ScanSearch,
- design: SwatchBook,
- prototyping: MousePointer2,
- diagrams: Workflow,
- decks: Presentation,
- research: BookOpen,
- reports: ChartNoAxesCombined,
- editors: PanelsTopLeft,
-};
-
-const folioAssets = [
- "/catalog/effective-svg/static/16-implementation-plan.svg",
- "/catalog/effective-svg/animated/18-editor-triage-board.svg",
- "/catalog/effective-svg/static/08-prototype-interaction.svg",
- "/catalog/effective-svg/static/13-flowchart-diagram.svg",
- "/catalog/effective-svg/animated/15-research-concept-explainer.svg",
-];
-
-function matchesQuery(values: string[], query: string) {
- return !query || values.join(" ").toLowerCase().includes(query);
-}
-
-function FolioSpecimen({
- artifact,
- animated,
-}: {
- artifact: CatalogArtifact;
- animated: boolean;
-}) {
- const svg = animated ? artifact.animatedSvg : artifact.staticSvg;
- const sourceUrl = animated
- ? artifact.animatedSourceUrl
- : artifact.staticSourceUrl;
-
- return (
- <article className={styles.specimen}>
- <a
- className={styles.specimenImage}
- href={svg}
- target="_blank"
- rel="noreferrer"
- aria-label={`Open ${animated ? "animated" : "static"} SVG for ${artifact.title}`}
- >
- <Image
- src={svg}
- alt={`${animated ? "Animated" : "Static"} SVG interpretation of ${artifact.title}`}
- width={165}
- height={202}
- unoptimized
- />
- </a>
- <div className={styles.specimenBody}>
- <span>{String(artifact.order).padStart(2, "0")}</span>
- <h3>{artifact.title}</h3>
- <p>{artifact.description}</p>
- <div className={styles.specimenLinks}>
- <a href={artifact.htmlUrl} target="_blank" rel="noreferrer">
- Original HTML
- <ArrowUpRight aria-hidden="true" />
- </a>
- <a href={sourceUrl} target="_blank" rel="noreferrer">
- Effective SVG
- <ArrowUpRight aria-hidden="true" />
- </a>
- </div>
- </div>
- </article>
- );
-}
-
-function FolioBand({
- category,
- artifacts,
-}: {
- category: CatalogCategory;
- artifacts: CatalogArtifact[];
-}) {
- const [animated, setAnimated] = useState(false);
- const bandStyle = {
- "--folio-band": category.color,
- "--folio-foreground": category.foreground,
- } as CSSProperties;
-
- return (
- <section
- className={styles.band}
- id={`folio-${category.id}`}
- style={bandStyle}
- >
- <header className={styles.bandRail}>
- <div>
- <h2>{category.shortLabel}</h2>
- <span>{artifacts.length} in this subject</span>
- </div>
- <div className={styles.bandModes} aria-label={`${category.label} preview mode`}>
- <a href={artifacts[0]?.htmlUrl} target="_blank" rel="noreferrer">
- <Code2 aria-hidden="true" />
- Original HTML
- </a>
- <button
- type="button"
- aria-pressed={!animated}
- onClick={() => setAnimated(false)}
- >
- <ImageIcon aria-hidden="true" />
- Static SVG
- </button>
- <button
- type="button"
- aria-pressed={animated}
- onClick={() => setAnimated(true)}
- >
- <Sparkles aria-hidden="true" />
- Animated SVG
- </button>
- </div>
- </header>
- <div className={styles.specimenShelf} data-count={artifacts.length}>
- {artifacts.map((artifact) => (
- <FolioSpecimen
- artifact={artifact}
- animated={animated}
- key={artifact.id}
- />
- ))}
- </div>
- </section>
- );
-}
-
-export function CatalogFolio() {
- const [query, setQuery] = useState("");
- const normalizedQuery = query.trim().toLowerCase();
-
- const groupedArtifacts = useMemo(
- () =>
- catalogCategories
- .map((category) => ({
- category,
- artifacts: catalogArtifacts.filter(
- (artifact) =>
- artifact.category === category.id &&
- matchesQuery(
- [artifact.title, artifact.description, category.label, ...artifact.keywords],
- normalizedQuery,
- ),
- ),
- }))
- .filter((group) => group.artifacts.length > 0),
- [normalizedQuery],
- );
-
- const visibleSkills = catalogSkills.filter((skill) =>
- matchesQuery([skill.title, skill.description], normalizedQuery),
- );
- const visibleNative = nativeExamples.filter((example) =>
- matchesQuery([example.title, example.mode, example.description], normalizedQuery),
- );
- const featuredSequenceVisible = matchesQuery(
- [
- featuredNativeArtifact.title,
- featuredNativeArtifact.eyebrow,
- featuredNativeArtifact.description,
- ...featuredNativeArtifact.flowLabels,
- ...featuredNativeArtifact.keywords,
- ],
- normalizedQuery,
- );
- const visibleCount =
- groupedArtifacts.reduce((total, group) => total + group.artifacts.length, 0) +
- visibleSkills.length +
- visibleNative.length +
- Number(featuredSequenceVisible);
-
- return (
- <div className={styles.folioPage}>
- <section className={styles.hero}>
- <div className={styles.heroTitle}>
- <h1>Catalog</h1>
- <p>
- A compact folio of references, SVG interpretations, native HTML,
- and the skills behind them.
- </p>
- <Link href="/catalog">
- View the current catalog
- <ArrowUpRight aria-hidden="true" />
- </Link>
- </div>
-
- <div className={styles.folioStage} aria-label="Effective HTML artifact folio">
- {folioAssets.map((asset) => (
- <div className={styles.folioSheet} key={asset}>
- <Image
- src={asset}
- alt=""
- aria-hidden="true"
- width={165}
- height={202}
- unoptimized
- loading="eager"
- />
- </div>
- ))}
- </div>
-
- <aside className={styles.sourceIndex}>
- <label>
- <Search aria-hidden="true" />
- <span className={styles.visuallyHidden}>Search this catalog view</span>
- <input
- type="search"
- value={query}
- onChange={(event) => setQuery(event.target.value)}
- placeholder="Search the source index"
- />
- </label>
- <div className={styles.sourceHeading}>
- <h2>Source index</h2>
- <span>{visibleCount} entries</span>
- </div>
- <nav aria-label="Catalog subjects">
- {catalogCategories.map((category) => {
- const Icon = categoryIcons[category.id] ?? Boxes;
- const count = catalogArtifacts.filter(
- (artifact) => artifact.category === category.id,
- ).length;
- return (
- <a
- href={`#folio-${category.id}`}
- key={category.id}
- aria-label={`${category.shortLabel}, ${count} ${count === 1 ? "artifact" : "artifacts"}`}
- >
- <Icon aria-hidden={true} />
- <span>{category.shortLabel}</span>
- <small>{count}</small>
- </a>
- );
- })}
- </nav>
- </aside>
- </section>
-
- {featuredSequenceVisible && (
- <FeaturedSequence artifact={featuredNativeArtifact} density="folio" />
- )}
-
- <div className={styles.bands}>
- {groupedArtifacts.map((group) => (
- <FolioBand
- category={group.category}
- artifacts={group.artifacts}
- key={group.category.id}
- />
- ))}
- </div>
-
- {visibleNative.length > 0 && (
- <section className={styles.nativeStrip}>
- <header>
- <h2>Native HTML</h2>
- <p>Two additional same-origin examples, served as the work itself.</p>
- </header>
- <div>
- {visibleNative.map((example) => (
- <article key={example.id}>
- <Link href={example.liveUrl}>
- <Image
- src={example.screenshot}
- alt={`Screenshot of ${example.title}`}
- width={example.screenshotWidth}
- height={example.screenshotHeight}
- />
- </Link>
- <div>
- <span>{example.mode}</span>
- <h3>{example.title}</h3>
- <Link href={example.liveUrl}>
- Open HTML
- <ArrowUpRight aria-hidden="true" />
- </Link>
- </div>
- </article>
- ))}
- </div>
- </section>
- )}
-
- {visibleSkills.length > 0 && (
- <section className={styles.skillStrip}>
- <h2>Effective HTML skills</h2>
- <div>
- {visibleSkills.map((skill) => (
- <article key={skill.id}>
- <span data-color={skill.color} aria-hidden="true" />
- <div>
- <h3>{skill.title}</h3>
- <p>{skill.description}</p>
- </div>
- <div className={styles.skillLinks}>
- <Link href={skill.guideUrl}>Guide</Link>
- <a href={skill.sourceUrl} target="_blank" rel="noreferrer">
- <FileCode2 aria-hidden="true" />
- Source
- </a>
- </div>
- </article>
- ))}
- </div>
- </section>
- )}
-
- {visibleCount === 0 && (
- <section className={styles.emptyState}>
- <Search aria-hidden="true" />
- <h2>No entry matches that search.</h2>
- <button type="button" onClick={() => setQuery("")}>
- Clear search
- </button>
- </section>
- )}
- </div>
- );
-}
diff --git a/.impeccable/audit/2026-07-31T21-08-49Z__app.md b/site/.impeccable/audit/2026-07-31T21-08-49Z__app.md
similarity index 100%
rename from .impeccable/audit/2026-07-31T21-08-49Z__app.md
rename to site/.impeccable/audit/2026-07-31T21-08-49Z__app.md
diff --git a/.impeccable/critique/2026-07-31T20-36-45Z__app.md b/site/.impeccable/critique/2026-07-31T20-36-45Z__app.md
similarity index 100%
rename from .impeccable/critique/2026-07-31T20-36-45Z__app.md
rename to site/.impeccable/critique/2026-07-31T20-36-45Z__app.md
diff --git a/.impeccable/critique/2026-07-31T21-52-32Z__app.md b/site/.impeccable/critique/2026-07-31T21-52-32Z__app.md
similarity index 100%
rename from .impeccable/critique/2026-07-31T21-52-32Z__app.md
rename to site/.impeccable/critique/2026-07-31T21-52-32Z__app.md
diff --git a/.impeccable/design.json b/site/.impeccable/design.json
similarity index 100%
rename from .impeccable/design.json
rename to site/.impeccable/design.json
diff --git a/.impeccable/mocks/catalog-editorial-category-bands.png b/site/.impeccable/mocks/catalog-editorial-category-bands.png
similarity index 100%
rename from .impeccable/mocks/catalog-editorial-category-bands.png
rename to site/.impeccable/mocks/catalog-editorial-category-bands.png
diff --git a/.impeccable/mocks/catalog-editorial-category-bands.png.json b/site/.impeccable/mocks/catalog-editorial-category-bands.png.json
similarity index 100%
rename from .impeccable/mocks/catalog-editorial-category-bands.png.json
rename to site/.impeccable/mocks/catalog-editorial-category-bands.png.json
diff --git a/.impeccable/mocks/catalog-paired-proof-ledger.png b/site/.impeccable/mocks/catalog-paired-proof-ledger.png
similarity index 100%
rename from .impeccable/mocks/catalog-paired-proof-ledger.png
rename to site/.impeccable/mocks/catalog-paired-proof-ledger.png
diff --git a/.impeccable/mocks/catalog-paired-proof-ledger.png.json b/site/.impeccable/mocks/catalog-paired-proof-ledger.png.json
similarity index 100%
rename from .impeccable/mocks/catalog-paired-proof-ledger.png.json
rename to site/.impeccable/mocks/catalog-paired-proof-ledger.png.json
diff --git a/.impeccable/mocks/catalog-sticky-specimen-stage.png b/site/.impeccable/mocks/catalog-sticky-specimen-stage.png
similarity index 100%
rename from .impeccable/mocks/catalog-sticky-specimen-stage.png
rename to site/.impeccable/mocks/catalog-sticky-specimen-stage.png
diff --git a/.impeccable/mocks/catalog-sticky-specimen-stage.png.json b/site/.impeccable/mocks/catalog-sticky-specimen-stage.png.json
similarity index 100%
rename from .impeccable/mocks/catalog-sticky-specimen-stage.png.json
rename to site/.impeccable/mocks/catalog-sticky-specimen-stage.png.json
diff --git a/.impeccable/mocks/landing-field-guide-spread.png b/site/.impeccable/mocks/landing-field-guide-spread.png
similarity index 100%
rename from .impeccable/mocks/landing-field-guide-spread.png
rename to site/.impeccable/mocks/landing-field-guide-spread.png
diff --git a/.impeccable/mocks/landing-field-guide-spread.png.json b/site/.impeccable/mocks/landing-field-guide-spread.png.json
similarity index 100%
rename from .impeccable/mocks/landing-field-guide-spread.png.json
rename to site/.impeccable/mocks/landing-field-guide-spread.png.json
diff --git a/.impeccable/mocks/landing-field-guide-spread.prompt.txt b/site/.impeccable/mocks/landing-field-guide-spread.prompt.txt
similarity index 100%
rename from .impeccable/mocks/landing-field-guide-spread.prompt.txt
rename to site/.impeccable/mocks/landing-field-guide-spread.prompt.txt
diff --git a/.impeccable/mocks/landing-open-specimen.png b/site/.impeccable/mocks/landing-open-specimen.png
similarity index 100%
rename from .impeccable/mocks/landing-open-specimen.png
rename to site/.impeccable/mocks/landing-open-specimen.png
diff --git a/.impeccable/mocks/landing-open-specimen.png.json b/site/.impeccable/mocks/landing-open-specimen.png.json
similarity index 100%
rename from .impeccable/mocks/landing-open-specimen.png.json
rename to site/.impeccable/mocks/landing-open-specimen.png.json
diff --git a/.impeccable/mocks/landing-open-specimen.prompt.txt b/site/.impeccable/mocks/landing-open-specimen.prompt.txt
similarity index 100%
rename from .impeccable/mocks/landing-open-specimen.prompt.txt
rename to site/.impeccable/mocks/landing-open-specimen.prompt.txt
diff --git a/.impeccable/mocks/landing-specimen-rail.png b/site/.impeccable/mocks/landing-specimen-rail.png
similarity index 100%
rename from .impeccable/mocks/landing-specimen-rail.png
rename to site/.impeccable/mocks/landing-specimen-rail.png
diff --git a/.impeccable/mocks/landing-specimen-rail.png.json b/site/.impeccable/mocks/landing-specimen-rail.png.json
similarity index 100%
rename from .impeccable/mocks/landing-specimen-rail.png.json
rename to site/.impeccable/mocks/landing-specimen-rail.png.json
diff --git a/.impeccable/mocks/landing-specimen-rail.prompt.txt b/site/.impeccable/mocks/landing-specimen-rail.prompt.txt
similarity index 100%
rename from .impeccable/mocks/landing-specimen-rail.prompt.txt
rename to site/.impeccable/mocks/landing-specimen-rail.prompt.txt
diff --git a/.impeccable/mocks/open-specimen-surface-brief.md b/site/.impeccable/mocks/open-specimen-surface-brief.md
similarity index 100%
rename from .impeccable/mocks/open-specimen-surface-brief.md
rename to site/.impeccable/mocks/open-specimen-surface-brief.md
diff --git a/.impeccable/surfaces/app-catalog-page-tsx.md b/site/.impeccable/surfaces/app-catalog-page-tsx.md
similarity index 100%
rename from .impeccable/surfaces/app-catalog-page-tsx.md
rename to site/.impeccable/surfaces/app-catalog-page-tsx.md
diff --git a/.impeccable/surfaces/content-docs-choosing-fidelity-mdx.md b/site/.impeccable/surfaces/content-docs-choosing-fidelity-mdx.md
similarity index 100%
rename from .impeccable/surfaces/content-docs-choosing-fidelity-mdx.md
rename to site/.impeccable/surfaces/content-docs-choosing-fidelity-mdx.md
diff --git a/.impeccable/surfaces/route.md b/site/.impeccable/surfaces/route.md
similarity index 100%
rename from .impeccable/surfaces/route.md
rename to site/.impeccable/surfaces/route.md
diff --git a/PRODUCT.md b/site/PRODUCT.md
similarity index 89%
rename from PRODUCT.md
rename to site/PRODUCT.md
index 426f25d..d979405 100644
--- a/PRODUCT.md
+++ b/site/PRODUCT.md
@@ -10,9 +10,9 @@ web
- Fumadocs with Fumadocs MDX.
- Next.js App Router.
-- Vercel as the conventional production deployment target.
-- The application lives in the Effective HTML repository alongside the skills
- and examples it documents.
+- Vercel deploys the self-contained application from the repository's `site/`
+ directory.
+- The skills and their source examples remain at the repository root.
## Users
@@ -85,7 +85,7 @@ and custom interfaces that it teaches people to create.
- Product name: **Effective HTML**.
- The existing attribution is **by Plannotator**.
- The approved Working Atlas direction in `design.md` is binding.
-- Approved assets include `assets/effective-html-banner.png` and
+- Approved assets include `public/brand/effective-html-banner.png` and
`art/brand-concepts/working-atlas-v1-refined.png`.
- The site should feel practitioner-led, tactile, graphic, technically calm,
and generous with examples.
@@ -96,12 +96,12 @@ and custom interfaces that it teaches people to create.
## Evidence on Hand
-- `README.md` describes the five Effective HTML skills and their intended uses.
-- `skills/` contains the current wireframe, prototype, plan, diagram, and broad
+- `../README.md` describes the five Effective HTML skills and their intended uses.
+- `../skills/` contains the current wireframe, prototype, plan, diagram, and broad
HTML guidance.
-- `examples/release-readiness/` contains standalone wireframe and prototype
+- `../examples/release-readiness/` contains standalone wireframe and prototype
examples with desktop and mobile screenshots.
-- `assets/effective-html-banner.png` is the current repository banner.
+- `public/brand/effective-html-banner.png` is the deployed site banner.
- `art/brand-concepts/working-atlas-v1-refined.png` is the approved site concept
plate.
- `/Users/ramos/oss/effective-svg/svg/` and
diff --git a/site/README.md b/site/README.md
new file mode 100644
index 0000000..49f51cf
--- /dev/null
+++ b/site/README.md
@@ -0,0 +1,22 @@
+# EffectiveHTML.com
+
+This directory contains the Next.js and Fumadocs application deployed at
+[effectivehtml.com](https://www.effectivehtml.com/). The installable skills,
+plugin manifests, and source examples remain at the repository root.
+
+## Develop locally
+
+```bash
+pnpm install
+pnpm dev
+```
+
+Run the production checks from this directory:
+
+```bash
+pnpm lint
+pnpm build
+```
+
+The Vercel project uses `site/` as its Root Directory. Files under `public/`
+are the deployable catalog and example assets used by the application.
diff --git a/app/api/search/route.ts b/site/app/api/search/route.ts
similarity index 100%
rename from app/api/search/route.ts
rename to site/app/api/search/route.ts
diff --git a/app/catalog/folio/page.tsx b/site/app/catalog/folio/page.tsx
similarity index 100%
rename from app/catalog/folio/page.tsx
rename to site/app/catalog/folio/page.tsx
diff --git a/app/catalog/page.tsx b/site/app/catalog/page.tsx
similarity index 100%
rename from app/catalog/page.tsx
rename to site/app/catalog/page.tsx
diff --git a/app/docs/[[...slug]]/page.tsx b/site/app/docs/[[...slug]]/page.tsx
similarity index 100%
rename from app/docs/[[...slug]]/page.tsx
rename to site/app/docs/[[...slug]]/page.tsx
diff --git a/app/docs/layout.tsx b/site/app/docs/layout.tsx
similarity index 100%
rename from app/docs/layout.tsx
rename to site/app/docs/layout.tsx
diff --git a/app/examples/page.tsx b/site/app/examples/page.tsx
similarity index 100%
rename from app/examples/page.tsx
rename to site/app/examples/page.tsx
diff --git a/app/global.css b/site/app/global.css
similarity index 100%
rename from app/global.css
rename to site/app/global.css
diff --git a/app/layout.tsx b/site/app/layout.tsx
similarity index 100%
rename from app/layout.tsx
rename to site/app/layout.tsx
diff --git a/app/page.tsx b/site/app/page.tsx
similarity index 100%
rename from app/page.tsx
rename to site/app/page.tsx
diff --git a/art/brand-concepts/working-atlas-v1-refined.png b/site/art/brand-concepts/working-atlas-v1-refined.png
similarity index 100%
rename from art/brand-concepts/working-atlas-v1-refined.png
rename to site/art/brand-concepts/working-atlas-v1-refined.png
diff --git a/art/brand-concepts/working-atlas-v1.png b/site/art/brand-concepts/working-atlas-v1.png
similarity index 100%
rename from art/brand-concepts/working-atlas-v1.png
rename to site/art/brand-concepts/working-atlas-v1.png
diff --git a/components/catalog-explorer.module.css b/site/components/catalog-explorer.module.css
similarity index 100%
rename from components/catalog-explorer.module.css
rename to site/components/catalog-explorer.module.css
diff --git a/components/catalog-explorer.tsx b/site/components/catalog-explorer.tsx
similarity index 100%
rename from components/catalog-explorer.tsx
rename to site/components/catalog-explorer.tsx
diff --git a/components/featured-sequence.module.css b/site/components/featured-sequence.module.css
similarity index 100%
rename from components/featured-sequence.module.css
rename to site/components/featured-sequence.module.css
diff --git a/components/featured-sequence.tsx b/site/components/featured-sequence.tsx
similarity index 100%
rename from components/featured-sequence.tsx
rename to site/components/featured-sequence.tsx
diff --git a/components/guide-evidence.module.css b/site/components/guide-evidence.module.css
similarity index 100%
rename from components/guide-evidence.module.css
rename to site/components/guide-evidence.module.css
diff --git a/components/guide-evidence.tsx b/site/components/guide-evidence.tsx
similarity index 100%
rename from components/guide-evidence.tsx
rename to site/components/guide-evidence.tsx
diff --git a/components/mdx.tsx b/site/components/mdx.tsx
similarity index 100%
rename from components/mdx.tsx
rename to site/components/mdx.tsx
diff --git a/components/site-footer.tsx b/site/components/site-footer.tsx
similarity index 100%
rename from components/site-footer.tsx
rename to site/components/site-footer.tsx
diff --git a/components/site-header.tsx b/site/components/site-header.tsx
similarity index 100%
rename from components/site-header.tsx
rename to site/components/site-header.tsx
diff --git a/components/specimen-stack.tsx b/site/components/specimen-stack.tsx
similarity index 100%
rename from components/specimen-stack.tsx
rename to site/components/specimen-stack.tsx
diff --git a/content/docs/choosing-fidelity.mdx b/site/content/docs/choosing-fidelity.mdx
similarity index 100%
rename from content/docs/choosing-fidelity.mdx
rename to site/content/docs/choosing-fidelity.mdx
diff --git a/content/docs/decks.mdx b/site/content/docs/decks.mdx
similarity index 100%
rename from content/docs/decks.mdx
rename to site/content/docs/decks.mdx
diff --git a/content/docs/diagrams.mdx b/site/content/docs/diagrams.mdx
similarity index 100%
rename from content/docs/diagrams.mdx
rename to site/content/docs/diagrams.mdx
diff --git a/content/docs/index.mdx b/site/content/docs/index.mdx
similarity index 100%
rename from content/docs/index.mdx
rename to site/content/docs/index.mdx
diff --git a/content/docs/meta.json b/site/content/docs/meta.json
similarity index 100%
rename from content/docs/meta.json
rename to site/content/docs/meta.json
diff --git a/content/docs/plans.mdx b/site/content/docs/plans.mdx
similarity index 100%
rename from content/docs/plans.mdx
rename to site/content/docs/plans.mdx
diff --git a/content/docs/prototypes.mdx b/site/content/docs/prototypes.mdx
similarity index 100%
rename from content/docs/prototypes.mdx
rename to site/content/docs/prototypes.mdx
diff --git a/content/docs/why-html.mdx b/site/content/docs/why-html.mdx
similarity index 100%
rename from content/docs/why-html.mdx
rename to site/content/docs/why-html.mdx
diff --git a/content/docs/wireframes.mdx b/site/content/docs/wireframes.mdx
similarity index 100%
rename from content/docs/wireframes.mdx
rename to site/content/docs/wireframes.mdx
diff --git a/design.md b/site/design.md
similarity index 100%
rename from design.md
rename to site/design.md
diff --git a/eslint.config.mjs b/site/eslint.config.mjs
similarity index 100%
rename from eslint.config.mjs
rename to site/eslint.config.mjs
diff --git a/lib/catalog-data.ts b/site/lib/catalog-data.ts
similarity index 100%
rename from lib/catalog-data.ts
rename to site/lib/catalog-data.ts
diff --git a/lib/layout.shared.tsx b/site/lib/layout.shared.tsx
similarity index 100%
rename from lib/layout.shared.tsx
rename to site/lib/layout.shared.tsx
diff --git a/lib/source.ts b/site/lib/source.ts
similarity index 100%
rename from lib/source.ts
rename to site/lib/source.ts
diff --git a/next-env.d.ts b/site/next-env.d.ts
similarity index 100%
rename from next-env.d.ts
rename to site/next-env.d.ts
diff --git a/next.config.mjs b/site/next.config.mjs
similarity index 100%
rename from next.config.mjs
rename to site/next.config.mjs
diff --git a/package.json b/site/package.json
similarity index 100%
rename from package.json
rename to site/package.json
diff --git a/pnpm-lock.yaml b/site/pnpm-lock.yaml
similarity index 100%
rename from pnpm-lock.yaml
rename to site/pnpm-lock.yaml
diff --git a/postcss.config.mjs b/site/postcss.config.mjs
similarity index 100%
rename from postcss.config.mjs
rename to site/postcss.config.mjs
diff --git a/public/brand/effective-html-banner.png b/site/public/brand/effective-html-banner.png
similarity index 100%
rename from public/brand/effective-html-banner.png
rename to site/public/brand/effective-html-banner.png
diff --git a/public/brand/working-atlas.png b/site/public/brand/working-atlas.png
similarity index 100%
rename from public/brand/working-atlas.png
rename to site/public/brand/working-atlas.png
diff --git a/public/catalog/effective-svg/animated/01-exploration-code-approaches.svg b/site/public/catalog/effective-svg/animated/01-exploration-code-approaches.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/01-exploration-code-approaches.svg
rename to site/public/catalog/effective-svg/animated/01-exploration-code-approaches.svg
diff --git a/public/catalog/effective-svg/animated/02-exploration-visual-designs.svg b/site/public/catalog/effective-svg/animated/02-exploration-visual-designs.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/02-exploration-visual-designs.svg
rename to site/public/catalog/effective-svg/animated/02-exploration-visual-designs.svg
diff --git a/public/catalog/effective-svg/animated/03-code-review-pr.svg b/site/public/catalog/effective-svg/animated/03-code-review-pr.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/03-code-review-pr.svg
rename to site/public/catalog/effective-svg/animated/03-code-review-pr.svg
diff --git a/public/catalog/effective-svg/animated/04-code-understanding.svg b/site/public/catalog/effective-svg/animated/04-code-understanding.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/04-code-understanding.svg
rename to site/public/catalog/effective-svg/animated/04-code-understanding.svg
diff --git a/public/catalog/effective-svg/animated/05-design-system.svg b/site/public/catalog/effective-svg/animated/05-design-system.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/05-design-system.svg
rename to site/public/catalog/effective-svg/animated/05-design-system.svg
diff --git a/public/catalog/effective-svg/animated/06-component-variants.svg b/site/public/catalog/effective-svg/animated/06-component-variants.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/06-component-variants.svg
rename to site/public/catalog/effective-svg/animated/06-component-variants.svg
diff --git a/public/catalog/effective-svg/animated/07-prototype-animation.svg b/site/public/catalog/effective-svg/animated/07-prototype-animation.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/07-prototype-animation.svg
rename to site/public/catalog/effective-svg/animated/07-prototype-animation.svg
diff --git a/public/catalog/effective-svg/animated/08-prototype-interaction.svg b/site/public/catalog/effective-svg/animated/08-prototype-interaction.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/08-prototype-interaction.svg
rename to site/public/catalog/effective-svg/animated/08-prototype-interaction.svg
diff --git a/public/catalog/effective-svg/animated/09-slide-deck.svg b/site/public/catalog/effective-svg/animated/09-slide-deck.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/09-slide-deck.svg
rename to site/public/catalog/effective-svg/animated/09-slide-deck.svg
diff --git a/public/catalog/effective-svg/animated/10-svg-illustrations.svg b/site/public/catalog/effective-svg/animated/10-svg-illustrations.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/10-svg-illustrations.svg
rename to site/public/catalog/effective-svg/animated/10-svg-illustrations.svg
diff --git a/public/catalog/effective-svg/animated/11-status-report.svg b/site/public/catalog/effective-svg/animated/11-status-report.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/11-status-report.svg
rename to site/public/catalog/effective-svg/animated/11-status-report.svg
diff --git a/public/catalog/effective-svg/animated/12-incident-report.svg b/site/public/catalog/effective-svg/animated/12-incident-report.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/12-incident-report.svg
rename to site/public/catalog/effective-svg/animated/12-incident-report.svg
diff --git a/public/catalog/effective-svg/animated/13-flowchart-diagram.svg b/site/public/catalog/effective-svg/animated/13-flowchart-diagram.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/13-flowchart-diagram.svg
rename to site/public/catalog/effective-svg/animated/13-flowchart-diagram.svg
diff --git a/public/catalog/effective-svg/animated/14-research-feature-explainer.svg b/site/public/catalog/effective-svg/animated/14-research-feature-explainer.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/14-research-feature-explainer.svg
rename to site/public/catalog/effective-svg/animated/14-research-feature-explainer.svg
diff --git a/public/catalog/effective-svg/animated/15-research-concept-explainer.svg b/site/public/catalog/effective-svg/animated/15-research-concept-explainer.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/15-research-concept-explainer.svg
rename to site/public/catalog/effective-svg/animated/15-research-concept-explainer.svg
diff --git a/public/catalog/effective-svg/animated/16-implementation-plan.svg b/site/public/catalog/effective-svg/animated/16-implementation-plan.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/16-implementation-plan.svg
rename to site/public/catalog/effective-svg/animated/16-implementation-plan.svg
diff --git a/public/catalog/effective-svg/animated/17-pr-writeup.svg b/site/public/catalog/effective-svg/animated/17-pr-writeup.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/17-pr-writeup.svg
rename to site/public/catalog/effective-svg/animated/17-pr-writeup.svg
diff --git a/public/catalog/effective-svg/animated/18-editor-triage-board.svg b/site/public/catalog/effective-svg/animated/18-editor-triage-board.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/18-editor-triage-board.svg
rename to site/public/catalog/effective-svg/animated/18-editor-triage-board.svg
diff --git a/public/catalog/effective-svg/animated/19-editor-feature-flags.svg b/site/public/catalog/effective-svg/animated/19-editor-feature-flags.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/19-editor-feature-flags.svg
rename to site/public/catalog/effective-svg/animated/19-editor-feature-flags.svg
diff --git a/public/catalog/effective-svg/animated/20-editor-prompt-tuner.svg b/site/public/catalog/effective-svg/animated/20-editor-prompt-tuner.svg
similarity index 100%
rename from public/catalog/effective-svg/animated/20-editor-prompt-tuner.svg
rename to site/public/catalog/effective-svg/animated/20-editor-prompt-tuner.svg
diff --git a/public/catalog/effective-svg/static/01-exploration-code-approaches.svg b/site/public/catalog/effective-svg/static/01-exploration-code-approaches.svg
similarity index 100%
rename from public/catalog/effective-svg/static/01-exploration-code-approaches.svg
rename to site/public/catalog/effective-svg/static/01-exploration-code-approaches.svg
diff --git a/public/catalog/effective-svg/static/02-exploration-visual-designs.svg b/site/public/catalog/effective-svg/static/02-exploration-visual-designs.svg
similarity index 100%
rename from public/catalog/effective-svg/static/02-exploration-visual-designs.svg
rename to site/public/catalog/effective-svg/static/02-exploration-visual-designs.svg
diff --git a/public/catalog/effective-svg/static/03-code-review-pr.svg b/site/public/catalog/effective-svg/static/03-code-review-pr.svg
similarity index 100%
rename from public/catalog/effective-svg/static/03-code-review-pr.svg
rename to site/public/catalog/effective-svg/static/03-code-review-pr.svg
diff --git a/public/catalog/effective-svg/static/04-code-understanding.svg b/site/public/catalog/effective-svg/static/04-code-understanding.svg
similarity index 100%
rename from public/catalog/effective-svg/static/04-code-understanding.svg
rename to site/public/catalog/effective-svg/static/04-code-understanding.svg
diff --git a/public/catalog/effective-svg/static/05-design-system.svg b/site/public/catalog/effective-svg/static/05-design-system.svg
similarity index 100%
rename from public/catalog/effective-svg/static/05-design-system.svg
rename to site/public/catalog/effective-svg/static/05-design-system.svg
diff --git a/public/catalog/effective-svg/static/06-component-variants.svg b/site/public/catalog/effective-svg/static/06-component-variants.svg
similarity index 100%
rename from public/catalog/effective-svg/static/06-component-variants.svg
rename to site/public/catalog/effective-svg/static/06-component-variants.svg
diff --git a/public/catalog/effective-svg/static/07-prototype-animation.svg b/site/public/catalog/effective-svg/static/07-prototype-animation.svg
similarity index 100%
rename from public/catalog/effective-svg/static/07-prototype-animation.svg
rename to site/public/catalog/effective-svg/static/07-prototype-animation.svg
diff --git a/public/catalog/effective-svg/static/08-prototype-interaction.svg b/site/public/catalog/effective-svg/static/08-prototype-interaction.svg
similarity index 100%
rename from public/catalog/effective-svg/static/08-prototype-interaction.svg
rename to site/public/catalog/effective-svg/static/08-prototype-interaction.svg
diff --git a/public/catalog/effective-svg/static/09-slide-deck.svg b/site/public/catalog/effective-svg/static/09-slide-deck.svg
similarity index 100%
rename from public/catalog/effective-svg/static/09-slide-deck.svg
rename to site/public/catalog/effective-svg/static/09-slide-deck.svg
diff --git a/public/catalog/effective-svg/static/10-svg-illustrations.svg b/site/public/catalog/effective-svg/static/10-svg-illustrations.svg
similarity index 100%
rename from public/catalog/effective-svg/static/10-svg-illustrations.svg
rename to site/public/catalog/effective-svg/static/10-svg-illustrations.svg
diff --git a/public/catalog/effective-svg/static/11-status-report.svg b/site/public/catalog/effective-svg/static/11-status-report.svg
similarity index 100%
rename from public/catalog/effective-svg/static/11-status-report.svg
rename to site/public/catalog/effective-svg/static/11-status-report.svg
diff --git a/public/catalog/effective-svg/static/12-incident-report.svg b/site/public/catalog/effective-svg/static/12-incident-report.svg
similarity index 100%
rename from public/catalog/effective-svg/static/12-incident-report.svg
rename to site/public/catalog/effective-svg/static/12-incident-report.svg
diff --git a/public/catalog/effective-svg/static/13-flowchart-diagram.svg b/site/public/catalog/effective-svg/static/13-flowchart-diagram.svg
similarity index 100%
rename from public/catalog/effective-svg/static/13-flowchart-diagram.svg
rename to site/public/catalog/effective-svg/static/13-flowchart-diagram.svg
diff --git a/public/catalog/effective-svg/static/14-research-feature-explainer.svg b/site/public/catalog/effective-svg/static/14-research-feature-explainer.svg
similarity index 100%
rename from public/catalog/effective-svg/static/14-research-feature-explainer.svg
rename to site/public/catalog/effective-svg/static/14-research-feature-explainer.svg
diff --git a/public/catalog/effective-svg/static/15-research-concept-explainer.svg b/site/public/catalog/effective-svg/static/15-research-concept-explainer.svg
similarity index 100%
rename from public/catalog/effective-svg/static/15-research-concept-explainer.svg
rename to site/public/catalog/effective-svg/static/15-research-concept-explainer.svg
diff --git a/public/catalog/effective-svg/static/16-implementation-plan.svg b/site/public/catalog/effective-svg/static/16-implementation-plan.svg
similarity index 100%
rename from public/catalog/effective-svg/static/16-implementation-plan.svg
rename to site/public/catalog/effective-svg/static/16-implementation-plan.svg
diff --git a/public/catalog/effective-svg/static/17-pr-writeup.svg b/site/public/catalog/effective-svg/static/17-pr-writeup.svg
similarity index 100%
rename from public/catalog/effective-svg/static/17-pr-writeup.svg
rename to site/public/catalog/effective-svg/static/17-pr-writeup.svg
diff --git a/public/catalog/effective-svg/static/18-editor-triage-board.svg b/site/public/catalog/effective-svg/static/18-editor-triage-board.svg
similarity index 100%
rename from public/catalog/effective-svg/static/18-editor-triage-board.svg
rename to site/public/catalog/effective-svg/static/18-editor-triage-board.svg
diff --git a/public/catalog/effective-svg/static/19-editor-feature-flags.svg b/site/public/catalog/effective-svg/static/19-editor-feature-flags.svg
similarity index 100%
rename from public/catalog/effective-svg/static/19-editor-feature-flags.svg
rename to site/public/catalog/effective-svg/static/19-editor-feature-flags.svg
diff --git a/public/catalog/effective-svg/static/20-editor-prompt-tuner.svg b/site/public/catalog/effective-svg/static/20-editor-prompt-tuner.svg
similarity index 100%
rename from public/catalog/effective-svg/static/20-editor-prompt-tuner.svg
rename to site/public/catalog/effective-svg/static/20-editor-prompt-tuner.svg
diff --git a/public/catalog/featured/workspaces-architecture-demo.mp4 b/site/public/catalog/featured/workspaces-architecture-demo.mp4
similarity index 100%
rename from public/catalog/featured/workspaces-architecture-demo.mp4
rename to site/public/catalog/featured/workspaces-architecture-demo.mp4
diff --git a/public/catalog/featured/workspaces-architecture-poster.jpg b/site/public/catalog/featured/workspaces-architecture-poster.jpg
similarity index 100%
rename from public/catalog/featured/workspaces-architecture-poster.jpg
rename to site/public/catalog/featured/workspaces-architecture-poster.jpg
diff --git a/public/catalog/featured/workspaces-architecture-sequence.svg b/site/public/catalog/featured/workspaces-architecture-sequence.svg
similarity index 100%
rename from public/catalog/featured/workspaces-architecture-sequence.svg
rename to site/public/catalog/featured/workspaces-architecture-sequence.svg
diff --git a/public/catalog/featured/workspaces-architecture.html b/site/public/catalog/featured/workspaces-architecture.html
similarity index 100%
rename from public/catalog/featured/workspaces-architecture.html
rename to site/public/catalog/featured/workspaces-architecture.html
diff --git a/public/examples/product-studies/README.md b/site/public/examples/product-studies/README.md
similarity index 100%
rename from public/examples/product-studies/README.md
rename to site/public/examples/product-studies/README.md
diff --git a/public/examples/product-studies/linear-issue-workspace.html b/site/public/examples/product-studies/linear-issue-workspace.html
similarity index 100%
rename from public/examples/product-studies/linear-issue-workspace.html
rename to site/public/examples/product-studies/linear-issue-workspace.html
diff --git a/public/examples/product-studies/linear-issue-workspace.png b/site/public/examples/product-studies/linear-issue-workspace.png
similarity index 100%
rename from public/examples/product-studies/linear-issue-workspace.png
rename to site/public/examples/product-studies/linear-issue-workspace.png
diff --git a/public/examples/product-studies/notion-project-space.html b/site/public/examples/product-studies/notion-project-space.html
similarity index 100%
rename from public/examples/product-studies/notion-project-space.html
rename to site/public/examples/product-studies/notion-project-space.html
diff --git a/public/examples/product-studies/notion-project-space.png b/site/public/examples/product-studies/notion-project-space.png
similarity index 100%
rename from public/examples/product-studies/notion-project-space.png
rename to site/public/examples/product-studies/notion-project-space.png
diff --git a/public/examples/product-studies/vercel-deployment-dashboard.html b/site/public/examples/product-studies/vercel-deployment-dashboard.html
similarity index 100%
rename from public/examples/product-studies/vercel-deployment-dashboard.html
rename to site/public/examples/product-studies/vercel-deployment-dashboard.html
diff --git a/public/examples/product-studies/vercel-deployment-dashboard.png b/site/public/examples/product-studies/vercel-deployment-dashboard.png
similarity index 100%
rename from public/examples/product-studies/vercel-deployment-dashboard.png
rename to site/public/examples/product-studies/vercel-deployment-dashboard.png
diff --git a/public/examples/release-readiness/prototype-desktop.png b/site/public/examples/release-readiness/prototype-desktop.png
similarity index 100%
rename from public/examples/release-readiness/prototype-desktop.png
rename to site/public/examples/release-readiness/prototype-desktop.png
diff --git a/public/examples/release-readiness/prototype.html b/site/public/examples/release-readiness/prototype.html
similarity index 100%
rename from public/examples/release-readiness/prototype.html
rename to site/public/examples/release-readiness/prototype.html
diff --git a/public/examples/release-readiness/wireframe-desktop.png b/site/public/examples/release-readiness/wireframe-desktop.png
similarity index 100%
rename from public/examples/release-readiness/wireframe-desktop.png
rename to site/public/examples/release-readiness/wireframe-desktop.png
diff --git a/public/examples/release-readiness/wireframe.html b/site/public/examples/release-readiness/wireframe.html
similarity index 100%
rename from public/examples/release-readiness/wireframe.html
rename to site/public/examples/release-readiness/wireframe.html
diff --git a/tsconfig.json b/site/tsconfig.json
similarity index 100%
rename from tsconfig.json
rename to site/tsconfig.json