# jcarvajalh/arka---web-development-agency architecture

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

- Interactive diagram: https://gitdiagram.com/jcarvajalh/arka---web-development-agency
- Repository: https://github.com/jcarvajalh/arka---web-development-agency

## Overview

ARKA is a Spanish-language agency marketing site. Visitors can explore the agency’s services and project case studies, review service details, and reach conversion-oriented content; the site also includes privacy and documentation pages. The graph preserves the service and portfolio data models and the animated hero effect. Page-to-component wiring is not shown in the excerpts, so those relationships are marked as unverified rather than asserted as observed calls.

Main entry points: [`src/layouts/BaseLayout.astro`](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/layouts/BaseLayout.astro) (Base layout), [`src/pages/servicios`](https://github.com/jcarvajalh/arka---web-development-agency/tree/master/src/pages/servicios) (Service pages), [`src/pages/index.astro`](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/pages/index.astro) (Agency home), [`src/pages/proyectos.astro`](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/pages/proyectos.astro) (Project listing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site experience"]
  node_home["Agency home<br/>[index.astro]"]
  node_home_sections["Home sections"]
  node_base_layout["Base layout<br/>[BaseLayout.astro]"]
  node_header_footer["Header and footer"]
  node_privacy["Privacy policy"]
end

subgraph group_services["Service pages"]
  node_service_pages["Service pages"]
  node_service_data["Service catalog<br/>[servicios.ts]"]
  node_service_components["Service details"]
end

subgraph group_portfolio["Project portfolio"]
  node_project_list["Project listing<br/>[proyectos.astro]"]
  node_project_detail["Project case study<br/>[&#91;slug&#93;.astro]"]
  node_project_data["Project catalog<br/>[proyectos.ts]"]
end

subgraph group_content["Content and effects"]
  node_docs["Documentation"]
  node_content_config["Docs collection<br/>[content.config.ts]"]
  node_ray_component["Ray burst view<br/>[RayBurst.astro]"]
  node_ray_effect["Ray burst renderer<br/>[ray-burst.js]"]
end

node_visitor(("Site visitor"))

node_visitor -.->|"opens"| node_home
node_visitor -.->|"explores"| node_service_pages
node_visitor -.->|"browses"| node_project_list
node_visitor -.->|"reads"| node_docs
node_home -.->|"renders"| node_home_sections
node_home -.->|"uses layout"| node_base_layout
node_base_layout -.->|"renders"| node_header_footer
node_service_pages -.->|"reads"| node_service_data
node_service_pages -.->|"renders"| node_service_components
node_service_pages -.->|"uses layout"| node_base_layout
node_project_list -.->|"reads"| node_project_data
node_project_detail -.->|"reads"| node_project_data
node_project_list -.->|"uses layout"| node_base_layout
node_project_detail -.->|"uses layout"| node_base_layout
node_content_config -.->|"loads collection"| node_docs
node_ray_component -.->|"uses renderer"| node_ray_effect
node_home_sections -.->|"may render"| node_ray_component

click node_home "https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/pages/index.astro"
click node_home_sections "https://github.com/jcarvajalh/arka---web-development-agency/tree/master/src/components/sections"
click node_base_layout "https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/layouts/BaseLayout.astro"
click node_header_footer "https://github.com/jcarvajalh/arka---web-development-agency/tree/master/src/components/layout"
click node_privacy "https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/pages/politica-de-privacidad.astro"
click node_service_pages "https://github.com/jcarvajalh/arka---web-development-agency/tree/master/src/pages/servicios"
click node_service_data "https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/data/servicios.ts"
click node_service_components "https://github.com/jcarvajalh/arka---web-development-agency/tree/master/src/components/servicios"
click node_project_list "https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/pages/proyectos.astro"
click node_project_detail "https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/pages/proyectos/%5Bslug%5D.astro"
click node_project_data "https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/data/proyectos.ts"
click node_docs "https://github.com/jcarvajalh/arka---web-development-agency/tree/master/src/content/docs"
click node_content_config "https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/content.config.ts"
click node_ray_component "https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/components/RayBurst.astro"
click node_ray_effect "https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/lib/ray-burst.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_home,node_home_sections,node_base_layout,node_header_footer,node_privacy toneBlue
class node_service_pages,node_service_data,node_service_components toneAmber
class node_project_list,node_project_detail,node_project_data toneMint
class node_docs,node_content_config,node_ray_component,node_ray_effect toneRose
class node_visitor toneIndigo
```

## Components

### Site experience

- [Agency home](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/pages/index.astro): `src/pages/index.astro`
- [Home sections](https://github.com/jcarvajalh/arka---web-development-agency/tree/master/src/components/sections): `src/components/sections`
- [Base layout](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/layouts/BaseLayout.astro): `src/layouts/BaseLayout.astro`
- [Header and footer](https://github.com/jcarvajalh/arka---web-development-agency/tree/master/src/components/layout): `src/components/layout`
- [Privacy policy](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/pages/politica-de-privacidad.astro): `src/pages/politica-de-privacidad.astro`

### Service pages

- [Service pages](https://github.com/jcarvajalh/arka---web-development-agency/tree/master/src/pages/servicios): `src/pages/servicios`
- [Service catalog](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/data/servicios.ts): `src/data/servicios.ts`
- [Service details](https://github.com/jcarvajalh/arka---web-development-agency/tree/master/src/components/servicios): `src/components/servicios`

### Project portfolio

- [Project listing](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/pages/proyectos.astro): `src/pages/proyectos.astro`
- [Project case study](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/pages/proyectos/%5Bslug%5D.astro): `src/pages/proyectos/[slug].astro`
- [Project catalog](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/data/proyectos.ts): `src/data/proyectos.ts`

### Content and effects

- [Documentation](https://github.com/jcarvajalh/arka---web-development-agency/tree/master/src/content/docs): `src/content/docs`
- [Docs collection](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/content.config.ts): `src/content.config.ts`
- [Ray burst view](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/components/RayBurst.astro): `src/components/RayBurst.astro`
- [Ray burst renderer](https://github.com/jcarvajalh/arka---web-development-agency/blob/master/src/lib/ray-burst.js): `src/lib/ray-burst.js`

### Other components

- **Site visitor**

## Connections

- Site visitor → Agency home: opens
- Site visitor → Service pages: explores
- Site visitor → Project listing: browses
- Site visitor → Documentation: reads
- Agency home → Home sections: renders
- Agency home → Base layout: uses layout
- Base layout → Header and footer: renders
- Service pages → Service catalog: reads
- Service pages → Service details: renders
- Service pages → Base layout: uses layout
- Project listing → Project catalog: reads
- Project case study → Project catalog: reads
- Project listing → Base layout: uses layout
- Project case study → Base layout: uses layout
- Docs collection → Documentation: loads collection
- Ray burst view → Ray burst renderer: uses renderer
- Home sections → Ray burst view: may render
