# ayjed/motekra architecture

> Architecture diagram of the GitHub repository ayjed/motekra, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ayjed/motekra
- Repository: https://github.com/ayjed/motekra

## Overview

MOTEKRA is a static-first company and founder portfolio site. Visitors explore the home, services, work, about and insights pages, then can submit a project inquiry through the sole request-time email endpoint. Typed local content and publication approval govern what appears and what SEO can expose. An internal, build-gated motion lab demonstrates interaction and 3D behavior. The graph follows documented routes and sampled imports; unsampled page implementations and integrations are represented only where the README or source index supports them.

Main entry points: [`src/components/services/service-detail.tsx`](https://github.com/ayjed/motekra/blob/main/src/components/services/service-detail.tsx) (Service detail view), [`src/content/services/index.ts`](https://github.com/ayjed/motekra/blob/main/src/content/services/index.ts) (Service collection), [`src/lib/seo/routes.ts`](https://github.com/ayjed/motekra/blob/main/src/lib/seo/routes.ts) (Approved SEO routes), [`src/app/services/page.tsx`](https://github.com/ayjed/motekra/blob/main/src/app/services/page.tsx) (Service routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_pages["Public pages"]
  node_home["Home page<br/>[page.tsx]"]
  node_about["About page<br/>[page.tsx]"]
  node_services_routes["Service routes<br/>[page.tsx]"]
  node_service_detail_route["Service detail route<br/>[page.tsx]"]
  node_work_routes["Work routes<br/>[page.tsx]"]
  node_project_route["Project detail route<br/>[page.tsx]"]
  node_contact_page["Contact page<br/>[page.tsx]"]
  node_insights_routes["Insights routes<br/>[page.tsx]"]
  node_team_route["Team profile route<br/>[page.tsx]"]
end

subgraph group_content["Content collections"]
  node_article_data["Article data access<br/>[articles.ts]"]
  node_service_data["Service collection<br/>[index.ts]"]
  node_service_details_data["Service descriptions<br/>[details.ts]"]
  node_project_data["Project collections<br/>[case-studies.ts]"]
  node_content_models["Publication models<br/>[models.ts]"]
end

subgraph group_inquiry["Contact inquiry"]
  node_inquiry_form["Inquiry form<br/>[inquiry-form.tsx]"]
  node_contact_api["Contact endpoint<br/>[route.ts]"]
  node_inquiry_handler["Inquiry processing<br/>[handler.ts]"]
  node_mail_delivery["Email delivery<br/>[mail.ts]"]
end

subgraph group_shared["Shared presentation and SEO"]
  node_services_view["Services presentation<br/>[services-page.tsx]"]
  node_service_detail["Service detail view<br/>[service-detail.tsx]"]
  node_work_view["Work presentation<br/>[work-page.tsx]"]
  node_project_detail["Case study view<br/>[project-detail.tsx]"]
  node_seo_routes["Approved SEO routes<br/>[routes.ts]"]
  node_seo_site["Metadata policy<br/>[site.ts]"]
end

subgraph group_motion["Motion and 3D"]
  node_motion_lab["Motion lab<br/>[page.tsx]"]
  node_motion_hooks["Animation lifecycle<br/>[hooks.ts]"]
  node_reveal["Reveal effects<br/>[reveal.tsx]"]
  node_device_scene["Device scene<br/>[device-scene.tsx]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"visits"| node_home
node_visitor -->|"explores"| node_services_routes
node_visitor -->|"explores"| node_work_routes
node_visitor -->|"starts inquiry"| node_contact_page
node_services_routes -->|"renders"| node_services_view
node_services_routes -->|"reads"| node_service_data
node_service_detail_route -->|"renders"| node_service_detail
node_service_detail -->|"reads"| node_service_details_data
node_service_detail -->|"reads"| node_service_data
node_services_view -->|"reads"| node_service_data
node_services_view -->|"links to"| node_service_detail
node_work_routes -->|"renders"| node_work_view
node_project_route -->|"renders"| node_project_detail
node_project_route -->|"reads"| node_project_data
node_project_detail -->|"reads"| node_project_data
node_project_detail -->|"uses types"| node_content_models
node_contact_page -->|"renders"| node_inquiry_form
node_inquiry_form -.->|"submits to"| node_contact_api
node_contact_api -->|"dispatches"| node_inquiry_handler
node_inquiry_handler -->|"delivers through"| node_mail_delivery
node_insights_routes -->|"reads"| node_article_data
node_seo_routes -->|"filters"| node_service_data
node_seo_routes -->|"filters"| node_project_data
node_seo_routes -->|"filters"| node_article_data
node_motion_lab -->|"uses"| node_reveal
node_motion_lab -->|"shows"| node_device_scene
node_reveal -->|"uses"| node_motion_hooks

click node_home "https://github.com/ayjed/motekra/blob/main/src/app/page.tsx"
click node_about "https://github.com/ayjed/motekra/blob/main/src/app/about/page.tsx"
click node_services_routes "https://github.com/ayjed/motekra/blob/main/src/app/services/page.tsx"
click node_service_detail_route "https://github.com/ayjed/motekra/blob/main/src/app/services/%5Bslug%5D/page.tsx"
click node_work_routes "https://github.com/ayjed/motekra/blob/main/src/app/work/page.tsx"
click node_project_route "https://github.com/ayjed/motekra/blob/main/src/app/work/%5Bslug%5D/page.tsx"
click node_contact_page "https://github.com/ayjed/motekra/blob/main/src/app/contact/page.tsx"
click node_insights_routes "https://github.com/ayjed/motekra/blob/main/src/app/insights/page.tsx"
click node_team_route "https://github.com/ayjed/motekra/blob/main/src/app/team/%5Bslug%5D/page.tsx"
click node_services_view "https://github.com/ayjed/motekra/blob/main/src/components/services/services-page.tsx"
click node_service_detail "https://github.com/ayjed/motekra/blob/main/src/components/services/service-detail.tsx"
click node_work_view "https://github.com/ayjed/motekra/blob/main/src/components/work/work-page.tsx"
click node_project_detail "https://github.com/ayjed/motekra/blob/main/src/components/work/project-detail.tsx"
click node_article_data "https://github.com/ayjed/motekra/blob/main/src/lib/data/articles.ts"
click node_service_data "https://github.com/ayjed/motekra/blob/main/src/content/services/index.ts"
click node_service_details_data "https://github.com/ayjed/motekra/blob/main/src/content/services/details.ts"
click node_project_data "https://github.com/ayjed/motekra/blob/main/src/content/projects/case-studies.ts"
click node_content_models "https://github.com/ayjed/motekra/blob/main/src/content/models.ts"
click node_inquiry_form "https://github.com/ayjed/motekra/blob/main/src/components/contact/inquiry-form.tsx"
click node_contact_api "https://github.com/ayjed/motekra/blob/main/src/app/api/contact/route.ts"
click node_inquiry_handler "https://github.com/ayjed/motekra/blob/main/src/lib/contact/handler.ts"
click node_mail_delivery "https://github.com/ayjed/motekra/blob/main/src/lib/contact/mail.ts"
click node_seo_routes "https://github.com/ayjed/motekra/blob/main/src/lib/seo/routes.ts"
click node_seo_site "https://github.com/ayjed/motekra/blob/main/src/lib/seo/site.ts"
click node_motion_lab "https://github.com/ayjed/motekra/blob/main/src/app/motion-lab/page.tsx"
click node_motion_hooks "https://github.com/ayjed/motekra/blob/main/src/lib/animations/hooks.ts"
click node_reveal "https://github.com/ayjed/motekra/blob/main/src/components/motion/reveal.tsx"
click node_device_scene "https://github.com/ayjed/motekra/blob/main/src/components/three/device-scene.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_home,node_about,node_services_routes,node_service_detail_route,node_work_routes,node_project_route,node_contact_page,node_insights_routes,node_team_route toneBlue
class node_article_data,node_service_data,node_service_details_data,node_project_data,node_content_models toneAmber
class node_inquiry_form,node_contact_api,node_inquiry_handler,node_mail_delivery toneMint
class node_services_view,node_service_detail,node_work_view,node_project_detail,node_seo_routes,node_seo_site toneRose
class node_motion_lab,node_motion_hooks,node_reveal,node_device_scene,node_visitor toneIndigo
```

## Components

### Public pages

- [Home page](https://github.com/ayjed/motekra/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [About page](https://github.com/ayjed/motekra/blob/main/src/app/about/page.tsx): `src/app/about/page.tsx`
- [Service routes](https://github.com/ayjed/motekra/blob/main/src/app/services/page.tsx): `src/app/services/page.tsx`
- [Service detail route](https://github.com/ayjed/motekra/blob/main/src/app/services/%5Bslug%5D/page.tsx): `src/app/services/[slug]/page.tsx`
- [Work routes](https://github.com/ayjed/motekra/blob/main/src/app/work/page.tsx): `src/app/work/page.tsx`
- [Project detail route](https://github.com/ayjed/motekra/blob/main/src/app/work/%5Bslug%5D/page.tsx): `src/app/work/[slug]/page.tsx`
- [Contact page](https://github.com/ayjed/motekra/blob/main/src/app/contact/page.tsx): `src/app/contact/page.tsx`
- [Insights routes](https://github.com/ayjed/motekra/blob/main/src/app/insights/page.tsx): `src/app/insights/page.tsx`
- [Team profile route](https://github.com/ayjed/motekra/blob/main/src/app/team/%5Bslug%5D/page.tsx): `src/app/team/[slug]/page.tsx`

### Content collections

- [Article data access](https://github.com/ayjed/motekra/blob/main/src/lib/data/articles.ts): `src/lib/data/articles.ts`
- [Service collection](https://github.com/ayjed/motekra/blob/main/src/content/services/index.ts): `src/content/services/index.ts`
- [Service descriptions](https://github.com/ayjed/motekra/blob/main/src/content/services/details.ts): `src/content/services/details.ts`
- [Project collections](https://github.com/ayjed/motekra/blob/main/src/content/projects/case-studies.ts): `src/content/projects/case-studies.ts`
- [Publication models](https://github.com/ayjed/motekra/blob/main/src/content/models.ts): `src/content/models.ts`

### Contact inquiry

- [Inquiry form](https://github.com/ayjed/motekra/blob/main/src/components/contact/inquiry-form.tsx): `src/components/contact/inquiry-form.tsx`
- [Contact endpoint](https://github.com/ayjed/motekra/blob/main/src/app/api/contact/route.ts): `src/app/api/contact/route.ts`
- [Inquiry processing](https://github.com/ayjed/motekra/blob/main/src/lib/contact/handler.ts): `src/lib/contact/handler.ts`
- [Email delivery](https://github.com/ayjed/motekra/blob/main/src/lib/contact/mail.ts): `src/lib/contact/mail.ts`

### Shared presentation and SEO

- [Services presentation](https://github.com/ayjed/motekra/blob/main/src/components/services/services-page.tsx): `src/components/services/services-page.tsx`
- [Service detail view](https://github.com/ayjed/motekra/blob/main/src/components/services/service-detail.tsx): `src/components/services/service-detail.tsx`
- [Work presentation](https://github.com/ayjed/motekra/blob/main/src/components/work/work-page.tsx): `src/components/work/work-page.tsx`
- [Case study view](https://github.com/ayjed/motekra/blob/main/src/components/work/project-detail.tsx): `src/components/work/project-detail.tsx`
- [Approved SEO routes](https://github.com/ayjed/motekra/blob/main/src/lib/seo/routes.ts): `src/lib/seo/routes.ts`
- [Metadata policy](https://github.com/ayjed/motekra/blob/main/src/lib/seo/site.ts): `src/lib/seo/site.ts`

### Motion and 3D

- [Motion lab](https://github.com/ayjed/motekra/blob/main/src/app/motion-lab/page.tsx): `src/app/motion-lab/page.tsx`
- [Animation lifecycle](https://github.com/ayjed/motekra/blob/main/src/lib/animations/hooks.ts): `src/lib/animations/hooks.ts`
- [Reveal effects](https://github.com/ayjed/motekra/blob/main/src/components/motion/reveal.tsx): `src/components/motion/reveal.tsx`
- [Device scene](https://github.com/ayjed/motekra/blob/main/src/components/three/device-scene.tsx): `src/components/three/device-scene.tsx`

### Other components

- **Site visitor**

## Connections

- Site visitor → Home page: visits
- Site visitor → Service routes: explores
- Site visitor → Work routes: explores
- Site visitor → Contact page: starts inquiry (evidence: `src/app/contact/page.tsx`)
- Service routes → Services presentation: renders (evidence: `src/app/services/page.tsx`)
- Service routes → Service collection: reads (evidence: `src/app/services/page.tsx`)
- Service detail route → Service detail view: renders
- Service detail view → Service descriptions: reads (evidence: `src/components/services/service-detail.tsx`)
- Service detail view → Service collection: reads (evidence: `src/components/services/service-detail.tsx`)
- Services presentation → Service collection: reads (evidence: `src/components/services/services-page.tsx`)
- Services presentation → Service detail view: links to (evidence: `src/components/services/services-page.tsx`)
- Work routes → Work presentation: renders (evidence: `src/app/work/page.tsx`)
- Project detail route → Case study view: renders (evidence: `src/app/work/[slug]/page.tsx`)
- Project detail route → Project collections: reads (evidence: `src/app/work/[slug]/page.tsx`)
- Case study view → Project collections: reads (evidence: `src/components/work/project-detail.tsx`)
- Case study view → Publication models: uses types (evidence: `src/components/work/project-detail.tsx`)
- Contact page → Inquiry form: renders (evidence: `src/app/contact/page.tsx`)
- Inquiry form → Contact endpoint: submits to
- Contact endpoint → Inquiry processing: dispatches (evidence: `src/app/api/contact/route.ts`)
- Inquiry processing → Email delivery: delivers through (evidence: `src/lib/contact/handler.ts`)
- Insights routes → Article data access: reads (evidence: `src/app/insights/page.tsx`)
- Approved SEO routes → Service collection: filters (evidence: `src/lib/seo/routes.ts`)
- Approved SEO routes → Project collections: filters (evidence: `src/lib/seo/routes.ts`)
- Approved SEO routes → Article data access: filters (evidence: `src/lib/seo/routes.ts`)
- Motion lab → Reveal effects: uses (evidence: `src/app/motion-lab/page.tsx`)
- Motion lab → Device scene: shows (evidence: `src/app/motion-lab/page.tsx`)
- Reveal effects → Animation lifecycle: uses (evidence: `src/components/motion/reveal.tsx`)
