# rajeshkumawat/bluestone architecture

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

- Interactive diagram: https://gitdiagram.com/rajeshkumawat/bluestone
- Repository: https://github.com/rajeshkumawat/bluestone

## Overview

Bluestone is an Astro front end for a headless investment-firm website: visitors browse firm, investment, team, news, contact, and legal content, which the site renders from either local typed content or WordPress via WPGraphQL. The content access layer selects and maps the source; Astro routes and block components present it. Evidence is limited to the README and sampled/indexed files, so route-to-data calls and detailed rendering links are not asserted where source was not shown.

Main entry points: [`src/pages`](https://github.com/rajeshkumawat/bluestone/tree/main/src/pages) (Astro site), [`src/data/index.ts`](https://github.com/rajeshkumawat/bluestone/blob/main/src/data/index.ts) (Content access), [`src/layouts/BaseLayout.astro`](https://github.com/rajeshkumawat/bluestone/blob/main/src/layouts/BaseLayout.astro) (Base layout), [`src/data/wp/client.ts`](https://github.com/rajeshkumawat/bluestone/blob/main/src/data/wp/client.ts) (GraphQL client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Public site"]
  node_astro_site["Astro site"]
  node_page_routes["Firm pages"]
  node_investment_routes["Investment pages"]
  node_news_routes["News pages"]
  node_sitemap["Sitemap endpoints<br/>[sitemap-0.xml.ts]"]
end

subgraph group_content["Content access"]
  node_content_api["Content access<br/>[index.ts]"]
  node_local_content["Local content"]
  node_domain_types["Content types<br/>[blocks.ts]"]
end

subgraph group_cms["WordPress integration"]
  node_wp_queries["GraphQL queries<br/>[queries.ts]"]
  node_wp_client["GraphQL client<br/>[client.ts]"]
  node_wp_mapper["Response mapper<br/>[map.ts]"]
end

subgraph group_presentation["Presentation"]
  node_base_layout["Base layout<br/>[BaseLayout.astro]"]
  node_block_renderer["Block renderer"]
  node_content_blocks["Page blocks"]
  node_global_chrome["Header and footer"]
  node_animations["Motion effects<br/>[animations.ts]"]
  node_public_media["Public media"]
end

node_visitor(("Site visitor"))
node_wordpress[("WordPress CMS")]

node_visitor -->|"browses"| node_astro_site
node_astro_site -.->|"reads content"| node_content_api
node_content_api -->|"selects local"| node_local_content
node_content_api -->|"runs queries"| node_wp_queries
node_content_api -->|"maps responses"| node_wp_mapper
node_wp_client -->|"fetches GraphQL"| node_wordpress
node_content_api -->|"calls"| node_wp_client
node_wp_mapper -->|"shapes content"| node_domain_types
node_astro_site -.->|"renders through"| node_base_layout
node_base_layout -.->|"includes"| node_global_chrome
node_base_layout -.->|"renders blocks"| node_block_renderer
node_block_renderer -.->|"dispatches blocks"| node_content_blocks
node_base_layout -.->|"uses motion"| node_animations
node_base_layout -.->|"serves assets"| node_public_media
node_page_routes -.->|"serves pages"| node_astro_site
node_investment_routes -.->|"serves pages"| node_astro_site
node_news_routes -.->|"serves pages"| node_astro_site
node_sitemap -.->|"publishes sitemap"| node_astro_site

click node_astro_site "https://github.com/rajeshkumawat/bluestone/tree/main/src/pages"
click node_page_routes "https://github.com/rajeshkumawat/bluestone/tree/main/src/pages"
click node_investment_routes "https://github.com/rajeshkumawat/bluestone/tree/main/src/pages/investments"
click node_news_routes "https://github.com/rajeshkumawat/bluestone/tree/main/src/pages/news"
click node_sitemap "https://github.com/rajeshkumawat/bluestone/blob/main/src/pages/sitemap-0.xml.ts"
click node_content_api "https://github.com/rajeshkumawat/bluestone/blob/main/src/data/index.ts"
click node_local_content "https://github.com/rajeshkumawat/bluestone/tree/main/src/data/local"
click node_domain_types "https://github.com/rajeshkumawat/bluestone/blob/main/src/data/types/blocks.ts"
click node_wp_queries "https://github.com/rajeshkumawat/bluestone/blob/main/src/data/wp/queries.ts"
click node_wp_client "https://github.com/rajeshkumawat/bluestone/blob/main/src/data/wp/client.ts"
click node_wp_mapper "https://github.com/rajeshkumawat/bluestone/blob/main/src/data/wp/map.ts"
click node_base_layout "https://github.com/rajeshkumawat/bluestone/blob/main/src/layouts/BaseLayout.astro"
click node_block_renderer "https://github.com/rajeshkumawat/bluestone/blob/main/src/components/blocks/BlockRenderer.astro"
click node_content_blocks "https://github.com/rajeshkumawat/bluestone/tree/main/src/components/blocks"
click node_global_chrome "https://github.com/rajeshkumawat/bluestone/tree/main/src/components/global"
click node_animations "https://github.com/rajeshkumawat/bluestone/blob/main/src/lib/animations.ts"
click node_public_media "https://github.com/rajeshkumawat/bluestone/tree/main/public"

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_astro_site,node_page_routes,node_investment_routes,node_news_routes,node_sitemap toneBlue
class node_content_api,node_local_content,node_domain_types,node_wordpress toneAmber
class node_wp_queries,node_wp_client,node_wp_mapper toneMint
class node_base_layout,node_block_renderer,node_content_blocks,node_global_chrome,node_animations,node_public_media toneRose
class node_visitor toneIndigo
```

## Components

### Public site

- [Astro site](https://github.com/rajeshkumawat/bluestone/tree/main/src/pages): `src/pages`
- [Firm pages](https://github.com/rajeshkumawat/bluestone/tree/main/src/pages): `src/pages`
- [Investment pages](https://github.com/rajeshkumawat/bluestone/tree/main/src/pages/investments): `src/pages/investments`
- [News pages](https://github.com/rajeshkumawat/bluestone/tree/main/src/pages/news): `src/pages/news`
- [Sitemap endpoints](https://github.com/rajeshkumawat/bluestone/blob/main/src/pages/sitemap-0.xml.ts): `src/pages/sitemap-0.xml.ts`

### Content access

- [Content access](https://github.com/rajeshkumawat/bluestone/blob/main/src/data/index.ts): `src/data/index.ts`
- [Local content](https://github.com/rajeshkumawat/bluestone/tree/main/src/data/local): `src/data/local`
- [Content types](https://github.com/rajeshkumawat/bluestone/blob/main/src/data/types/blocks.ts): `src/data/types/blocks.ts`

### WordPress integration

- [GraphQL queries](https://github.com/rajeshkumawat/bluestone/blob/main/src/data/wp/queries.ts): `src/data/wp/queries.ts`
- [GraphQL client](https://github.com/rajeshkumawat/bluestone/blob/main/src/data/wp/client.ts): `src/data/wp/client.ts`
- [Response mapper](https://github.com/rajeshkumawat/bluestone/blob/main/src/data/wp/map.ts): `src/data/wp/map.ts`

### Presentation

- [Base layout](https://github.com/rajeshkumawat/bluestone/blob/main/src/layouts/BaseLayout.astro): `src/layouts/BaseLayout.astro`
- [Block renderer](https://github.com/rajeshkumawat/bluestone/blob/main/src/components/blocks/BlockRenderer.astro): `src/components/blocks/BlockRenderer.astro`
- [Page blocks](https://github.com/rajeshkumawat/bluestone/tree/main/src/components/blocks): `src/components/blocks`
- [Header and footer](https://github.com/rajeshkumawat/bluestone/tree/main/src/components/global): `src/components/global`
- [Motion effects](https://github.com/rajeshkumawat/bluestone/blob/main/src/lib/animations.ts): `src/lib/animations.ts`
- [Public media](https://github.com/rajeshkumawat/bluestone/tree/main/public): `public`

### Other components

- **Site visitor**
- **WordPress CMS**

## Connections

- Site visitor → Astro site: browses (evidence: `README.md`)
- Astro site → Content access: reads content
- Content access → Local content: selects local (evidence: `src/data/index.ts`)
- Content access → GraphQL queries: runs queries (evidence: `src/data/index.ts`)
- Content access → Response mapper: maps responses (evidence: `src/data/index.ts`)
- GraphQL client → WordPress CMS: fetches GraphQL (evidence: `src/data/wp/client.ts`)
- Content access → GraphQL client: calls (evidence: `src/data/index.ts`)
- Response mapper → Content types: shapes content (evidence: `src/data/wp/map.ts`)
- Astro site → Base layout: renders through
- Base layout → Header and footer: includes
- Base layout → Block renderer: renders blocks
- Block renderer → Page blocks: dispatches blocks
- Base layout → Motion effects: uses motion
- Base layout → Public media: serves assets
- Firm pages → Astro site: serves pages
- Investment pages → Astro site: serves pages
- News pages → Astro site: serves pages
- Sitemap endpoints → Astro site: publishes sitemap
