# antony-beep/holding-reynaga architecture

> Architecture diagram of the GitHub repository antony-beep/holding-reynaga, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-05-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/antony-beep/holding-reynaga
- Repository: https://github.com/antony-beep/holding-reynaga

## Overview

1. This is a Next.js App Router site, built as a mostly static marketing/real-estate presentation project. There are no API routes, server actions, or database layers in the tree, so the architecture is centered on routed pages, reusable React sections, and file-based content/assets.

2. The top-level route structure lives under `src/app`. The root `src/app/layout.tsx` defines the global document shell, while `src/app/(main)/layout.tsx` wraps the public-facing site chrome for the main pages. The route group keeps the marketing pages under a shared layout without affecting the URL.

3. The home page is assembled from composable section components in `src/components/home`. These include `Hero`, `ProjectOverview`, `About`, `Catalog`, `VirtualTour`, `Gallery`, `Location`, `LocationMap`, `FAQ`, and `DossierForm`. The page itself is therefore a composition layer; the business content is split into presentational blocks rather than embedded in one monolith.

4. Property/apartment content is data-driven from `src/data/apartments.ts`. That data appears to feed the dynamic apartment detail route at `src/app/(main)/departamentos/[tipo]/page.tsx` and likely also the catalog and 360-tour links. The architecture implies a single source of truth for apartment types, with pages derived from the dataset by route parameter.

5. The 360 experience is isolated into its own route family under `src/app/vision360/[type]/page.tsx` and a dedicated viewer component at `src/components/vision360/PannellumViewer.tsx`. The presence of `src/types/pannellum.d.ts` shows an external panorama library integration, and the viewer is likely browser-only because it depends on DOM/WebGL-style behavior.

6. Several global UI/utility components are shared across pages in `src/components/global`: `Header`, `Footer`, `CookieConsent`, `WhatsAppFAB`, `Preloader`, `StructuredData`, and `ClientOnlyComponents`. This creates a clear boundary between site shell concerns, compliance/consent, marketing contact affordances, and browser-specific rendering.

7. `ClientOnlyComponents` is an important architectural seam. It suggests some components must not render on the server, probably because they depend on browser APIs, third-party widgets, or dynamic media behavior. That boundary keeps the SSR/App Router structure stable while still supporting interactive features.

8. The content and media layer is asset-heavy and file-based. `public/images`, `public/videos`, and `public/docs/dosier_informativo.pdf` hold the visual collateral, while the apartment-type folders under images and videos indicate each unit type has its own media set. This repo is therefore designed around large static media delivery rather than dynamic content generation.

9. `src/app/terminos-y-condiciones/page.tsx` is a separate static compliance page. Combined with cookie consent and structured data, this indicates the site has deliberate legal/SEO/marketing support rather than only brochure content.

10. Global styling is handled through `src/app/globals.css` plus Next.js configuration files (`postcss.config.mjs`, `eslint.config.mjs`, `next.config.ts`). The README also shows the app uses `next/font` to load Geist, so typography and global presentation are configured centrally rather than per-page.

11. The likely data flow is: route parameter or page load → page component under `src/app` → content pulled from `src/data/apartments.ts` and/or static assets in `public` → section components render the page → global shell components add navigation, legal prompts, WhatsApp contact, and structured metadata. The 360 pages add one extra client-side viewer layer on top of that flow.

12. Deployment/runtime-wise, this is a standard Next.js site intended for Vercel-like hosting, with static assets and server-rendered pages optimized by the framework. The architecture is best understood as a content-rich, route-driven frontend with isolated interactive modules and no visible backend service boundary.

Main entry points: [`src/app/layout.tsx`](https://github.com/antony-beep/holding-reynaga/blob/main/src/app/layout.tsx) (Root layout), [`src/app/(main)/page.tsx`](https://github.com/antony-beep/holding-reynaga/blob/main/src/app/(main)/page.tsx) (Home page), [`src/app/(main)/layout.tsx`](https://github.com/antony-beep/holding-reynaga/blob/main/src/app/(main)/layout.tsx) (Main layout), [`src/components/global/ClientOnlyComponents.tsx`](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/ClientOnlyComponents.tsx) (Client-only)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App routes"]
  node_root_layout["Root layout<br/>Next layout<br/>[layout.tsx]"]
  node_main_layout["Main layout<br/>Route layout<br/>[layout.tsx]"]
  node_home_page["Home page<br/>Marketing page<br/>[page.tsx]"]
  node_dept_page["Apartment page<br/>Dynamic route<br/>[page.tsx]"]
  node_terms_page["Terms page<br/>Static page<br/>[page.tsx]"]
  node_vision_page["360 page<br/>Dynamic route<br/>[page.tsx]"]
end

subgraph group_components["React components"]
  node_header["Header<br/>Site chrome<br/>[Header.tsx]"]
  node_footer["Footer<br/>Site chrome<br/>[Footer.tsx]"]
  node_cookie["Cookie consent<br/>Compliance UI<br/>[CookieConsent.tsx]"]
  node_whatsapp(("WhatsApp FAB<br/>Contact CTA<br/>[WhatsAppFAB.tsx]"))
  node_client_only["Client-only<br/>SSR boundary"]
  node_structured_data["Structured data<br/>SEO helper<br/>[StructuredData.tsx]"]
  node_preloader["Preloader<br/>Loading UI<br/>[Preloader.tsx]"]
  node_hero["Hero<br/>Section<br/>[Hero.tsx]"]
  node_overview["Overview<br/>Section"]
  node_about["About<br/>Section<br/>[About.tsx]"]
  node_catalog["Catalog<br/>Section<br/>[Catalog.tsx]"]
  node_tour["Virtual tour<br/>Section<br/>[VirtualTour.tsx]"]
  node_gallery["Gallery<br/>Section<br/>[Gallery.tsx]"]
  node_location["Location<br/>Section<br/>[Location.tsx]"]
  node_map["Location map<br/>Map section<br/>[LocationMap.tsx]"]
  node_faq["FAQ<br/>Section<br/>[FAQ.tsx]"]
  node_dossier["Dossier form<br/>Lead form<br/>[DossierForm.tsx]"]
  node_viewer["360 viewer<br/>Panorama viewer"]
end

subgraph group_content["Content and media"]
  node_apartments_data[("Apartments data<br/>Content model<br/>[apartments.ts]")]
  node_images["Images<br/>Static assets"]
  node_videos["Videos<br/>Static assets"]
  node_docs["Dossier PDF<br/>Static asset"]
end

subgraph group_config["Project config"]
  node_globals_css["Global styles<br/>Stylesheet<br/>[globals.css]"]
  node_next_config["Next config<br/>Framework config<br/>[next.config.ts]"]
  node_postcss_config["PostCSS config<br/>Build config<br/>[postcss.config.mjs]"]
  node_eslint_config["ESLint config<br/>[eslint.config.mjs]"]
  node_pannellum_types["Pannellum types<br/>Type shim<br/>[pannellum.d.ts]"]
end

node_root_layout -->|"wraps"| node_main_layout
node_main_layout -->|"renders"| node_home_page
node_main_layout -->|"frames"| node_dept_page
node_main_layout -->|"frames"| node_terms_page
node_root_layout -->|"enables"| node_vision_page
node_home_page -->|"composes"| node_hero
node_home_page -->|"composes"| node_overview
node_home_page -->|"composes"| node_about
node_home_page -->|"composes"| node_catalog
node_home_page -->|"composes"| node_tour
node_home_page -->|"composes"| node_gallery
node_home_page -->|"composes"| node_location
node_home_page -->|"composes"| node_map
node_home_page -->|"composes"| node_faq
node_home_page -->|"composes"| node_dossier
node_dept_page -->|"reads"| node_apartments_data
node_catalog -->|"lists"| node_apartments_data
node_tour -->|"links"| node_vision_page
node_vision_page -->|"uses"| node_viewer
node_viewer -->|"types"| node_pannellum_types
node_root_layout -->|"includes"| node_header
node_root_layout -->|"includes"| node_footer
node_root_layout -->|"includes"| node_cookie
node_root_layout -->|"includes"| node_whatsapp
node_root_layout -->|"includes"| node_structured_data
node_root_layout -->|"includes"| node_preloader
node_root_layout -->|"gates"| node_client_only
node_client_only -->|"hosts"| node_viewer
node_client_only -.->|"hosts"| node_cookie
node_client_only -.->|"hosts"| node_whatsapp
node_root_layout -->|"loads"| node_globals_css
node_root_layout -.->|"depends on"| node_next_config
node_root_layout -.->|"depends on"| node_postcss_config
node_root_layout -.->|"depends on"| node_eslint_config
node_home_page -->|"uses"| node_images
node_home_page -->|"uses"| node_videos
node_dossier -->|"downloads"| node_docs

click node_root_layout "https://github.com/antony-beep/holding-reynaga/blob/main/src/app/layout.tsx"
click node_main_layout "https://github.com/antony-beep/holding-reynaga/blob/main/src/app/(main)/layout.tsx"
click node_home_page "https://github.com/antony-beep/holding-reynaga/blob/main/src/app/(main)/page.tsx"
click node_dept_page "https://github.com/antony-beep/holding-reynaga/blob/main/src/app/(main)/departamentos/[tipo]/page.tsx"
click node_terms_page "https://github.com/antony-beep/holding-reynaga/blob/main/src/app/(main)/terminos-y-condiciones/page.tsx"
click node_vision_page "https://github.com/antony-beep/holding-reynaga/blob/main/src/app/vision360/[type]/page.tsx"
click node_header "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/Header.tsx"
click node_footer "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/Footer.tsx"
click node_cookie "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/CookieConsent.tsx"
click node_whatsapp "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/WhatsAppFAB.tsx"
click node_client_only "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/ClientOnlyComponents.tsx"
click node_structured_data "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/StructuredData.tsx"
click node_preloader "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/Preloader.tsx"
click node_hero "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/Hero.tsx"
click node_overview "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/ProjectOverview.tsx"
click node_about "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/About.tsx"
click node_catalog "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/Catalog.tsx"
click node_tour "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/VirtualTour.tsx"
click node_gallery "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/Gallery.tsx"
click node_location "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/Location.tsx"
click node_map "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/LocationMap.tsx"
click node_faq "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/FAQ.tsx"
click node_dossier "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/DossierForm.tsx"
click node_viewer "https://github.com/antony-beep/holding-reynaga/blob/main/src/components/vision360/PannellumViewer.tsx"
click node_apartments_data "https://github.com/antony-beep/holding-reynaga/blob/main/src/data/apartments.ts"
click node_images "https://github.com/antony-beep/holding-reynaga/tree/main/public/images"
click node_videos "https://github.com/antony-beep/holding-reynaga/tree/main/public/videos"
click node_docs "https://github.com/antony-beep/holding-reynaga/blob/main/public/docs/dosier_informativo.pdf"
click node_globals_css "https://github.com/antony-beep/holding-reynaga/blob/main/src/app/globals.css"
click node_next_config "https://github.com/antony-beep/holding-reynaga/blob/main/next.config.ts"
click node_postcss_config "https://github.com/antony-beep/holding-reynaga/blob/main/postcss.config.mjs"
click node_eslint_config "https://github.com/antony-beep/holding-reynaga/blob/main/eslint.config.mjs"
click node_pannellum_types "https://github.com/antony-beep/holding-reynaga/blob/main/src/types/pannellum.d.ts"

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_root_layout,node_main_layout,node_home_page,node_dept_page,node_terms_page,node_vision_page toneBlue
class node_header,node_footer,node_cookie,node_whatsapp,node_client_only,node_structured_data,node_preloader,node_hero,node_overview,node_about,node_catalog,node_tour,node_gallery,node_location,node_map,node_faq,node_dossier,node_viewer toneAmber
class node_apartments_data,node_images,node_videos,node_docs toneMint
class node_globals_css,node_next_config,node_postcss_config,node_eslint_config,node_pannellum_types toneRose
```

## Components

### App routes

Next.js App Router entrypoints and route layouts.

- [Root layout](https://github.com/antony-beep/holding-reynaga/blob/main/src/app/layout.tsx): Next layout · Global document shell for the App Router. · `src/app/layout.tsx`
- [Main layout](https://github.com/antony-beep/holding-reynaga/blob/main/src/app/(main)/layout.tsx): Route layout · Shared chrome for public marketing pages. · `src/app/(main)/layout.tsx`
- [Home page](https://github.com/antony-beep/holding-reynaga/blob/main/src/app/(main)/page.tsx): Marketing page · Main landing page assembled from section components. · `src/app/(main)/page.tsx`
- [Apartment page](https://github.com/antony-beep/holding-reynaga/blob/main/src/app/(main)/departamentos/[tipo]/page.tsx): Dynamic route · Apartment detail page driven by the tipo route param. · `src/app/(main)/departamentos/[tipo]/page.tsx`
- [Terms page](https://github.com/antony-beep/holding-reynaga/blob/main/src/app/(main)/terminos-y-condiciones/page.tsx): Static page · Legal/compliance page for site terms. · `src/app/(main)/terminos-y-condiciones/page.tsx`
- [360 page](https://github.com/antony-beep/holding-reynaga/blob/main/src/app/vision360/[type]/page.tsx): Dynamic route · Dedicated route family for panorama experiences. · `src/app/vision360/[type]/page.tsx`

### React components

Reusable presentation, shell, and interactive UI pieces.

- [Header](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/Header.tsx): Site chrome · Primary navigation and top-level branding. · `src/components/global/Header.tsx`
- [Footer](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/Footer.tsx): Site chrome · Bottom-of-page navigation and contact area. · `src/components/global/Footer.tsx`
- [Cookie consent](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/CookieConsent.tsx): Compliance UI · Consent prompt and tracking preference boundary. · `src/components/global/CookieConsent.tsx`
- [WhatsApp FAB](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/WhatsAppFAB.tsx): Contact CTA · Floating contact affordance for messaging. · `src/components/global/WhatsAppFAB.tsx`
- [Client-only](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/ClientOnlyComponents.tsx): SSR boundary · Wrapper for browser-only components and widgets. · `src/components/global/ClientOnlyComponents.tsx`
- [Structured data](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/StructuredData.tsx): SEO helper · Injects metadata/schema for search visibility. · `src/components/global/StructuredData.tsx`
- [Preloader](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/global/Preloader.tsx): Loading UI · Initial loading/transition state for the site. · `src/components/global/Preloader.tsx`
- [Hero](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/Hero.tsx): Section · Top-fold marketing section for the home page. · `src/components/home/Hero.tsx`
- [Overview](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/ProjectOverview.tsx): Section · Project summary and positioning content. · `src/components/home/ProjectOverview.tsx`
- [About](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/About.tsx): Section · Background and descriptive project content. · `src/components/home/About.tsx`
- [Catalog](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/Catalog.tsx): Section · Apartment listing and entry point to unit details. · `src/components/home/Catalog.tsx`
- [Virtual tour](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/VirtualTour.tsx): Section · Entry point to immersive 360 viewing. · `src/components/home/VirtualTour.tsx`
- [Gallery](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/Gallery.tsx): Section · Image showcase for project and unit visuals. · `src/components/home/Gallery.tsx`
- [Location](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/Location.tsx): Section · Neighborhood and access information. · `src/components/home/Location.tsx`
- [Location map](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/LocationMap.tsx): Map section · Embedded map or map-style location view. · `src/components/home/LocationMap.tsx`
- [FAQ](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/FAQ.tsx): Section · Frequently asked questions and answers. · `src/components/home/FAQ.tsx`
- [Dossier form](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/home/DossierForm.tsx): Lead form · Brochure or document request capture. · `src/components/home/DossierForm.tsx`
- [360 viewer](https://github.com/antony-beep/holding-reynaga/blob/main/src/components/vision360/PannellumViewer.tsx): Panorama viewer · Browser-side panorama renderer for the 360 route. · `src/components/vision360/PannellumViewer.tsx`

### Content and media

Apartment data and static assets used by the site.

- [Apartments data](https://github.com/antony-beep/holding-reynaga/blob/main/src/data/apartments.ts): Content model · Single source of truth for apartment types and details. · `src/data/apartments.ts`
- [Images](https://github.com/antony-beep/holding-reynaga/tree/main/public/images): Static assets · Project imagery, gallery media, and unit visuals. · `public/images`
- [Videos](https://github.com/antony-beep/holding-reynaga/tree/main/public/videos): Static assets · Rendered video assets for apartments and promotion. · `public/videos`
- [Dossier PDF](https://github.com/antony-beep/holding-reynaga/blob/main/public/docs/dosier_informativo.pdf): Static asset · Informational brochure downloaded by users. · `public/docs/dosier_informativo.pdf`

### Project config

Build, styling, and type configuration.

- [Global styles](https://github.com/antony-beep/holding-reynaga/blob/main/src/app/globals.css): Stylesheet · Application-wide CSS foundation. · `src/app/globals.css`
- [Next config](https://github.com/antony-beep/holding-reynaga/blob/main/next.config.ts): Framework config · Next.js build/runtime settings. · `next.config.ts`
- [PostCSS config](https://github.com/antony-beep/holding-reynaga/blob/main/postcss.config.mjs): Build config · CSS processing configuration. · `postcss.config.mjs`
- [ESLint config](https://github.com/antony-beep/holding-reynaga/blob/main/eslint.config.mjs): Lint config · Code quality and linting rules. · `eslint.config.mjs`
- [Pannellum types](https://github.com/antony-beep/holding-reynaga/blob/main/src/types/pannellum.d.ts): Type shim · Type definitions for the panorama library integration. · `src/types/pannellum.d.ts`

## Connections

- Root layout → Main layout: wraps · The root shell delegates public site chrome to the main route group.
- Main layout → Home page: renders · Shared layout frames the landing page.
- Main layout → Apartment page: frames · Shared layout also wraps apartment detail pages.
- Main layout → Terms page: frames · Shared layout also wraps the compliance page.
- Root layout → 360 page: enables · Root App Router layout supports the separate 360 route family.
- Home page → Hero: composes · Home page is assembled from reusable sections.
- Home page → Overview: composes · Home page is assembled from reusable sections.
- Home page → About: composes · Home page is assembled from reusable sections.
- Home page → Catalog: composes · Home page is assembled from reusable sections.
- Home page → Virtual tour: composes · Home page is assembled from reusable sections.
- Home page → Gallery: composes · Home page is assembled from reusable sections.
- Home page → Location: composes · Home page is assembled from reusable sections.
- Home page → Location map: composes · Home page is assembled from reusable sections.
- Home page → FAQ: composes · Home page is assembled from reusable sections.
- Home page → Dossier form: composes · Home page is assembled from reusable sections.
- Apartment page → Apartments data: reads · Apartment details are derived from the shared data model.
- Catalog → Apartments data: lists · Catalog is driven by the same apartment content source.
- Virtual tour → 360 page: links · Virtual tour section points into the 360 route family.
- 360 page → 360 viewer: uses · 360 route renders the dedicated panorama viewer.
- 360 viewer → Pannellum types: types · Viewer relies on the external panorama library typings.
- Root layout → Header: includes · Global shell includes shared header chrome.
- Root layout → Footer: includes · Global shell includes shared footer chrome.
- Root layout → Cookie consent: includes · Global shell includes consent handling.
- Root layout → WhatsApp FAB: includes · Global shell includes contact CTA affordance.
- Root layout → Structured data: includes · Global shell injects SEO structured metadata.
- Root layout → Preloader: includes · Global shell manages initial loading behavior.
- Root layout → Client-only: gates · Browser-only pieces are isolated behind a client boundary.
- Client-only → 360 viewer: hosts · Panorama viewer is a browser-only component.
- Client-only → Cookie consent: hosts · Some interactive consent behavior may be client-only.
- Client-only → WhatsApp FAB: hosts · Floating contact UI may depend on browser APIs.
- Root layout → Global styles: loads · Global document shell loads site-wide styles.
- Root layout → Next config: depends on · Framework behavior is shaped by Next.js config.
- Root layout → PostCSS config: depends on · Styling pipeline is configured centrally.
- Root layout → ESLint config: depends on · Development workflow uses shared lint rules.
- Home page → Images: uses · Sections render static marketing and gallery imagery.
- Home page → Videos: uses · Sections can display promotional apartment videos.
- Dossier form → Dossier PDF: downloads · Lead form connects to the brochure PDF asset.
