# yashashwi-s/website architecture

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

- Interactive diagram: https://gitdiagram.com/yashashwi-s/website
- Repository: https://github.com/yashashwi-s/website

## Overview

This repository serves a developer portfolio, the PureMac publisher site, and the Arras macOS-app site, alongside Fadeo product and licensing endpoints. The user-facing portfolio workflow presents selected work and links to the CV; PureMac and Arras provide product discovery and support information; Fadeo supports diagnostics, feedback, subscriptions, and license issuance. The graph preserves documented site capabilities, but several route implementations were not sampled, so their internal connections are omitted rather than inferred.

Main entry points: [`app/puremac/arras/page.jsx`](https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/page.jsx) (Arras product pages), [`app/api/stripe-webhook/route.js`](https://github.com/yashashwi-s/website/blob/main/app/api/stripe-webhook/route.js) (Payment webhooks), [`lib/fadeo-license.js`](https://github.com/yashashwi-s/website/blob/main/lib/fadeo-license.js) (License signing), [`lib/redis.js`](https://github.com/yashashwi-s/website/blob/main/lib/redis.js) (Redis operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portfolio["Portfolio and CV"]
  node_portfolio_site["Portfolio experience<br/>[home-client.jsx]"]
  node_portfolio_motion["Interaction effects"]
  node_project_data["Project content<br/>[projects.js]"]
  node_cv_route["CV route<br/>[page.jsx]"]
  node_cv_view["CV presentation<br/>[cv-client.jsx]"]
  node_resume_parser["Resume parser<br/>[parse-resume.js]"]
end

subgraph group_publisher["PureMac and Fadeo"]
  node_puremac_site["Publisher site<br/>[puremac-client.jsx]"]
  node_product_catalog["Mac app catalog<br/>[mac-products.js]"]
  node_fadeo_site["Fadeo product page<br/>[fadeo-client.jsx]"]
  node_fadeo_diagnostics_ui["Diagnostics interface"]
  node_faq_content["Product FAQs<br/>[faq-section.jsx]"]
end

subgraph group_arras["Arras product site"]
  node_arras_site["Arras product pages<br/>[page.jsx]"]
  node_arras_client["Arras interactions<br/>[arras-client.jsx]"]
  node_arras_demo["Product demo<br/>[arras-demo.jsx]"]
  node_arras_navigation["Product navigation"]
  node_arras_faq["Arras FAQs<br/>[page.jsx]"]
  node_arras_security["Security information<br/>[page.jsx]"]
  node_arras_contract["Product contract<br/>[arras-product.js]"]
  node_arras_resolver["Contract resolver<br/>[arras-product.js]"]
  node_arras_install["Install guidance"]
end

subgraph group_fadeo["Fadeo services"]
  node_fadeo_api["Fadeo API routes<br/>[route.js]"]
  node_activation_api["Activation endpoint<br/>[route.js]"]
  node_diagnostics_api["Diagnostics endpoint<br/>[route.js]"]
  node_feedback_api["Feedback endpoint<br/>[route.js]"]
  node_subscribe_api["Subscribe endpoint<br/>[route.js]"]
  node_payment_webhooks["Payment webhooks<br/>[route.js]"]
  node_gumroad_webhook["Gumroad webhook<br/>[route.js]"]
  node_license_signer["License signing<br/>[fadeo-license.js]"]
  node_promo_state["Giveaway management<br/>[fadeo-promo.js]"]
  node_diagnostics_logic["Diagnostics logic"]
  node_redis[("Redis operations<br/>[redis.js]")]
  node_license_email["License email delivery"]
end

node_visitor(("Site visitor"))
node_stripe["Stripe"]

node_visitor -.->|"views portfolio"| node_portfolio_site
node_portfolio_site -->|"uses effects"| node_portfolio_motion
node_portfolio_site -.->|"displays projects"| node_project_data
node_visitor -.->|"opens CV"| node_cv_route
node_cv_route -->|"parses resume"| node_resume_parser
node_cv_route -->|"renders CV"| node_cv_view
node_puremac_site -->|"reads catalog"| node_product_catalog
node_fadeo_site -->|"reads product data"| node_product_catalog
node_fadeo_site -->|"renders FAQs"| node_faq_content
node_visitor -.->|"browses product"| node_arras_site
node_arras_client -->|"renders navigation"| node_arras_navigation
node_arras_client -->|"renders demo"| node_arras_demo
node_arras_client -->|"uses install guidance"| node_arras_install
node_arras_navigation -->|"reads product data"| node_arras_contract
node_arras_site -.->|"uses product facts"| node_arras_contract
node_arras_site -.->|"offers FAQs"| node_arras_faq
node_arras_site -.->|"offers security details"| node_arras_security
node_arras_resolver -->|"resolves product data"| node_arras_contract
node_visitor -.->|"opens diagnostics"| node_fadeo_diagnostics_ui
node_diagnostics_api -->|"runs diagnostics"| node_diagnostics_logic
node_activation_api -->|"verifies license"| node_license_signer
node_fadeo_api -->|"signs licenses"| node_license_signer
node_fadeo_api -->|"manages claims"| node_promo_state
node_fadeo_api -->|"sends license email"| node_license_email
node_promo_state -->|"stores claim state"| node_redis
node_diagnostics_logic -->|"stores diagnostics state"| node_redis
node_payment_webhooks -->|"signs licenses"| node_license_signer
node_payment_webhooks -->|"sends license email"| node_license_email
node_payment_webhooks -->|"claims event once"| node_redis
node_stripe -->|"posts events"| node_payment_webhooks
node_gumroad_webhook -->|"signs licenses"| node_license_signer
node_gumroad_webhook -->|"sends license email"| node_license_email
node_gumroad_webhook -->|"claims sale once"| node_redis

click node_portfolio_site "https://github.com/yashashwi-s/website/blob/main/app/home-client.jsx"
click node_portfolio_motion "https://github.com/yashashwi-s/website/blob/main/components/HorizontalGallery.jsx"
click node_project_data "https://github.com/yashashwi-s/website/blob/main/data/projects.js"
click node_cv_route "https://github.com/yashashwi-s/website/blob/main/app/cv/page.jsx"
click node_cv_view "https://github.com/yashashwi-s/website/blob/main/app/cv/cv-client.jsx"
click node_resume_parser "https://github.com/yashashwi-s/website/blob/main/lib/parse-resume.js"
click node_puremac_site "https://github.com/yashashwi-s/website/blob/main/app/puremac/puremac-client.jsx"
click node_product_catalog "https://github.com/yashashwi-s/website/blob/main/data/mac-products.js"
click node_fadeo_site "https://github.com/yashashwi-s/website/blob/main/app/puremac/fadeo/fadeo-client.jsx"
click node_fadeo_diagnostics_ui "https://github.com/yashashwi-s/website/blob/main/app/puremac/fadeo/diagnostics/diagnostics-client.jsx"
click node_faq_content "https://github.com/yashashwi-s/website/blob/main/app/puremac/faq-section.jsx"
click node_arras_site "https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/page.jsx"
click node_arras_client "https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/arras-client.jsx"
click node_arras_demo "https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/arras-demo.jsx"
click node_arras_navigation "https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/arras-navigation.jsx"
click node_arras_faq "https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/faqs/page.jsx"
click node_arras_security "https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/security/page.jsx"
click node_arras_contract "https://github.com/yashashwi-s/website/blob/main/data/arras-product.js"
click node_arras_resolver "https://github.com/yashashwi-s/website/blob/main/lib/arras-product.js"
click node_arras_install "https://github.com/yashashwi-s/website/blob/main/lib/arras-installation.mjs"
click node_fadeo_api "https://github.com/yashashwi-s/website/blob/main/app/api/fadeo-license/route.js"
click node_activation_api "https://github.com/yashashwi-s/website/blob/main/app/api/fadeo-activate/route.js"
click node_diagnostics_api "https://github.com/yashashwi-s/website/blob/main/app/api/fadeo-diagnostics/route.js"
click node_feedback_api "https://github.com/yashashwi-s/website/blob/main/app/api/fadeo-feedback/route.js"
click node_subscribe_api "https://github.com/yashashwi-s/website/blob/main/app/api/fadeo-subscribe/route.js"
click node_payment_webhooks "https://github.com/yashashwi-s/website/blob/main/app/api/stripe-webhook/route.js"
click node_gumroad_webhook "https://github.com/yashashwi-s/website/blob/main/app/api/gumroad-webhook/route.js"
click node_license_signer "https://github.com/yashashwi-s/website/blob/main/lib/fadeo-license.js"
click node_promo_state "https://github.com/yashashwi-s/website/blob/main/lib/fadeo-promo.js"
click node_diagnostics_logic "https://github.com/yashashwi-s/website/blob/main/lib/fadeo-diagnostics.js"
click node_redis "https://github.com/yashashwi-s/website/blob/main/lib/redis.js"
click node_license_email "https://github.com/yashashwi-s/website/blob/main/lib/send-license-email.js"

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_portfolio_site,node_portfolio_motion,node_project_data,node_cv_route,node_cv_view,node_resume_parser toneBlue
class node_puremac_site,node_product_catalog,node_fadeo_site,node_fadeo_diagnostics_ui,node_faq_content toneAmber
class node_arras_site,node_arras_client,node_arras_demo,node_arras_navigation,node_arras_faq,node_arras_security,node_arras_contract,node_arras_resolver,node_arras_install toneMint
class node_fadeo_api,node_activation_api,node_diagnostics_api,node_feedback_api,node_subscribe_api,node_payment_webhooks,node_gumroad_webhook,node_license_signer,node_promo_state,node_diagnostics_logic,node_redis,node_license_email toneRose
class node_visitor,node_stripe toneIndigo
```

## Components

### Portfolio and CV

- [Portfolio experience](https://github.com/yashashwi-s/website/blob/main/app/home-client.jsx): `app/home-client.jsx`
- [Interaction effects](https://github.com/yashashwi-s/website/blob/main/components/HorizontalGallery.jsx): `components/HorizontalGallery.jsx`
- [Project content](https://github.com/yashashwi-s/website/blob/main/data/projects.js): `data/projects.js`
- [CV route](https://github.com/yashashwi-s/website/blob/main/app/cv/page.jsx): `app/cv/page.jsx`
- [CV presentation](https://github.com/yashashwi-s/website/blob/main/app/cv/cv-client.jsx): `app/cv/cv-client.jsx`
- [Resume parser](https://github.com/yashashwi-s/website/blob/main/lib/parse-resume.js): `lib/parse-resume.js`

### PureMac and Fadeo

- [Publisher site](https://github.com/yashashwi-s/website/blob/main/app/puremac/puremac-client.jsx): `app/puremac/puremac-client.jsx`
- [Mac app catalog](https://github.com/yashashwi-s/website/blob/main/data/mac-products.js): `data/mac-products.js`
- [Fadeo product page](https://github.com/yashashwi-s/website/blob/main/app/puremac/fadeo/fadeo-client.jsx): `app/puremac/fadeo/fadeo-client.jsx`
- [Diagnostics interface](https://github.com/yashashwi-s/website/blob/main/app/puremac/fadeo/diagnostics/diagnostics-client.jsx): `app/puremac/fadeo/diagnostics/diagnostics-client.jsx`
- [Product FAQs](https://github.com/yashashwi-s/website/blob/main/app/puremac/faq-section.jsx): `app/puremac/faq-section.jsx`

### Arras product site

- [Arras product pages](https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/page.jsx): `app/puremac/arras/page.jsx`
- [Arras interactions](https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/arras-client.jsx): `app/puremac/arras/arras-client.jsx`
- [Product demo](https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/arras-demo.jsx): `app/puremac/arras/arras-demo.jsx`
- [Product navigation](https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/arras-navigation.jsx): `app/puremac/arras/arras-navigation.jsx`
- [Arras FAQs](https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/faqs/page.jsx): `app/puremac/arras/faqs/page.jsx`
- [Security information](https://github.com/yashashwi-s/website/blob/main/app/puremac/arras/security/page.jsx): `app/puremac/arras/security/page.jsx`
- [Product contract](https://github.com/yashashwi-s/website/blob/main/data/arras-product.js): `data/arras-product.js`
- [Contract resolver](https://github.com/yashashwi-s/website/blob/main/lib/arras-product.js): `lib/arras-product.js`
- [Install guidance](https://github.com/yashashwi-s/website/blob/main/lib/arras-installation.mjs): `lib/arras-installation.mjs`

### Fadeo services

- [Fadeo API routes](https://github.com/yashashwi-s/website/blob/main/app/api/fadeo-license/route.js): `app/api/fadeo-license/route.js`
- [Activation endpoint](https://github.com/yashashwi-s/website/blob/main/app/api/fadeo-activate/route.js): `app/api/fadeo-activate/route.js`
- [Diagnostics endpoint](https://github.com/yashashwi-s/website/blob/main/app/api/fadeo-diagnostics/route.js): `app/api/fadeo-diagnostics/route.js`
- [Feedback endpoint](https://github.com/yashashwi-s/website/blob/main/app/api/fadeo-feedback/route.js): `app/api/fadeo-feedback/route.js`
- [Subscribe endpoint](https://github.com/yashashwi-s/website/blob/main/app/api/fadeo-subscribe/route.js): `app/api/fadeo-subscribe/route.js`
- [Payment webhooks](https://github.com/yashashwi-s/website/blob/main/app/api/stripe-webhook/route.js): `app/api/stripe-webhook/route.js`
- [Gumroad webhook](https://github.com/yashashwi-s/website/blob/main/app/api/gumroad-webhook/route.js): `app/api/gumroad-webhook/route.js`
- [License signing](https://github.com/yashashwi-s/website/blob/main/lib/fadeo-license.js): `lib/fadeo-license.js`
- [Giveaway management](https://github.com/yashashwi-s/website/blob/main/lib/fadeo-promo.js): `lib/fadeo-promo.js`
- [Diagnostics logic](https://github.com/yashashwi-s/website/blob/main/lib/fadeo-diagnostics.js): `lib/fadeo-diagnostics.js`
- [Redis operations](https://github.com/yashashwi-s/website/blob/main/lib/redis.js): `lib/redis.js`
- [License email delivery](https://github.com/yashashwi-s/website/blob/main/lib/send-license-email.js): `lib/send-license-email.js`

### Other components

- **Site visitor**
- **Stripe**

## Connections

- Site visitor → Portfolio experience: views portfolio (evidence: `README.md`)
- Portfolio experience → Interaction effects: uses effects (evidence: `app/home-client.jsx`)
- Portfolio experience → Project content: displays projects (evidence: `README.md`)
- Site visitor → CV route: opens CV
- CV route → Resume parser: parses resume (evidence: `app/cv/page.jsx`)
- CV route → CV presentation: renders CV (evidence: `app/cv/page.jsx`)
- Publisher site → Mac app catalog: reads catalog (evidence: `app/puremac/puremac-client.jsx`)
- Fadeo product page → Mac app catalog: reads product data (evidence: `app/puremac/fadeo/fadeo-client.jsx`)
- Fadeo product page → Product FAQs: renders FAQs (evidence: `app/puremac/fadeo/fadeo-client.jsx`)
- Site visitor → Arras product pages: browses product (evidence: `README.md`)
- Arras interactions → Product navigation: renders navigation (evidence: `app/puremac/arras/arras-client.jsx`)
- Arras interactions → Product demo: renders demo (evidence: `app/puremac/arras/arras-client.jsx`)
- Arras interactions → Install guidance: uses install guidance (evidence: `app/puremac/arras/arras-client.jsx`)
- Product navigation → Product contract: reads product data (evidence: `app/puremac/arras/arras-navigation.jsx`)
- Arras product pages → Product contract: uses product facts (evidence: `README.md`)
- Arras product pages → Arras FAQs: offers FAQs (evidence: `README.md`)
- Arras product pages → Security information: offers security details (evidence: `README.md`)
- Contract resolver → Product contract: resolves product data (evidence: `app/puremac/arras/llms.txt/route.js`)
- Site visitor → Diagnostics interface: opens diagnostics (evidence: `app/puremac/fadeo/diagnostics/diagnostics-client.jsx`)
- Diagnostics endpoint → Diagnostics logic: runs diagnostics (evidence: `app/api/fadeo-diagnostics/route.js`)
- Activation endpoint → License signing: verifies license (evidence: `lib/fadeo-license.js`)
- Fadeo API routes → License signing: signs licenses (evidence: `app/api/fadeo-license/route.js`)
- Fadeo API routes → Giveaway management: manages claims (evidence: `app/api/fadeo-license/route.js`)
- Fadeo API routes → License email delivery: sends license email (evidence: `app/api/fadeo-license/route.js`)
- Giveaway management → Redis operations: stores claim state (evidence: `lib/fadeo-promo.js`)
- Diagnostics logic → Redis operations: stores diagnostics state (evidence: `lib/fadeo-diagnostics.js`)
- Payment webhooks → License signing: signs licenses (evidence: `app/api/stripe-webhook/route.js`)
- Payment webhooks → License email delivery: sends license email (evidence: `app/api/stripe-webhook/route.js`)
- Payment webhooks → Redis operations: claims event once (evidence: `app/api/stripe-webhook/route.js`)
- Stripe → Payment webhooks: posts events (evidence: `app/api/stripe-webhook/route.js`)
- Gumroad webhook → License signing: signs licenses (evidence: `app/api/gumroad-webhook/route.js`)
- Gumroad webhook → License email delivery: sends license email (evidence: `app/api/gumroad-webhook/route.js`)
- Gumroad webhook → Redis operations: claims sale once (evidence: `app/api/gumroad-webhook/route.js`)
