# josemacruz/opositandos-web-landing architecture

> Architecture diagram of the GitHub repository josemacruz/opositandos-web-landing, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/josemacruz/opositandos-web-landing
- Repository: https://github.com/josemacruz/opositandos-web-landing

## Overview

##### Project type and purpose
- This is a Next.js (React-based) front-end application—specifically a marketing/landing site with pages for home, FAQ, policy, terms, etc.

##### File structure
- src/app – Next.js App Router entries (page.tsx, layout.tsx, nested routes for /faq, /policy, /term-and-conditions).
- src/components – Reusable UI components organized by domain (landing, layout, modals, faq, ui primitives).
- src/hooks & src/lib – Shared React hooks (e.g. useContactModal) and utility modules.
- public/images – Static assets served by Next.js.
- Config files – tailwind.config.ts, next.config.ts, postcss.config.js, tsconfig.json, eslint.config.mjs.
- package.json & lockfile & pnpm workspace – defines dependencies, scripts, build/deploy commands.

##### README for additional insights
- It was bootstrapped with create-next-app, uses next/font, expects deployment on Vercel.
- All pages auto-update in dev mode; no custom API routes present.

##### Be very detailed—capture every architectural element
– Even though there’s no database, show the public folder as an asset store.
– Include config files as part of the build pipeline.
– Separate each UI domain (landing, faq, modals, ui primitives) to illustrate modularity.
– Show the Next.js routing layer distinctly from the component implementation.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Layer
    subgraph "Client Side" 
        direction TB
        Browser["Web Browser"]:::external
    end

    %% Edge Layer
    subgraph "CDN / Edge Cache" 
        direction TB
        CDN["Vercel CDN / Edge"]:::external
    end

    %% Server Layer
    subgraph "Server Side" 
        direction TB
        NextServer["Next.js Server (SSR/SSG)"]:::server
        subgraph "Routing & Pages"
            direction TB
            LayoutPage["layout.tsx"]:::module
            HomePage["page.tsx"]:::module
            FAQPage["faq/page.tsx"]:::module
            PolicyPage["policy/page.tsx"]:::module
            TermsPage["term-and-conditions/page.tsx"]:::module
            NotFound["not-found.tsx"]:::module
        end
        subgraph "Components"
            direction TB
            subgraph "Landing Components"
                direction TB
                Hero["Hero.tsx"]:::module
                Features["Features.tsx"]:::module
                ContentSection["ContentSection.tsx"]:::module
                Cta["Cta.tsx"]:::module
                Dashboard["Dashboard.tsx"]:::module
            end
            subgraph "FAQ Components"
                direction TB
                FAQItem["FAQItem.tsx"]:::module
            end
            subgraph "Layout Components"
                direction TB
                Header["Header.tsx"]:::module
                Footer["Footer.tsx"]:::module
            end
            subgraph "Modals & Hooks"
                direction TB
                ContactModal["ContactModal.tsx"]:::module
                PricingModal["PricingModal.tsx"]:::module
                useContactModal["useContactModal.ts"]:::module
            end
            subgraph "UI Primitives"
                direction TB
                Accordion["accordion.tsx"]:::module
                Badge["badge.tsx"]:::module
                Button["button.tsx"]:::module
                Card["card.tsx"]:::module
                Dialog["dialog.tsx"]:::module
            end
        end
        subgraph "Utilities & Config"
            direction TB
            Constants["constans.ts"]:::module
            Utils["utils.ts"]:::module
            GlobalsCSS["globals.css"]:::assets
            TailwindConfig["tailwind.config.ts"]:::module
            PostCSSConfig["postcss.config.js"]:::module
            NextConfig["next.config.ts"]:::module
            TSConfig["tsconfig.json"]:::module
            ESLintConfig["eslint.config.mjs"]:::module
            PackageJSON["package.json"]:::module
        end
        subgraph "Static Assets"
            direction TB
            Images["public/images"]:::assets
            Fonts["next/font"]:::assets
        end
    end

    %% Build & Deployment
    subgraph "Build & Deployment" 
        direction TB
        Pipeline["pnpm → SWC → Tailwind/PostCSS → Build"]:::pipeline
        Vercel["Vercel Deployment"]:::external
    end

    %% Connections
    Browser -->|"Request URL"| CDN
    CDN -->|cached static| Browser
    CDN -->|"If miss/proxy"| NextServer
    NextServer -->|"Serve HTML/CSS/JS"| CDN
    CDN -->|delivers assets| Browser
    Browser -->|"Hydrate React"| Hero
    Hero -->|"uses hook"| useContactModal
    Pipeline -->|"Deploy build"| Vercel
    Vercel -->|Edge network| CDN

    %% Click Events
    click LayoutPage "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/app/layout.tsx"
    click HomePage "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/app/page.tsx"
    click FAQPage "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/app/faq/page.tsx"
    click PolicyPage "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/app/policy/page.tsx"
    click TermsPage "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/app/term-and-conditions/page.tsx"
    click NotFound "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/app/not-found.tsx"
    click Hero "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/landing/Hero.tsx"
    click Features "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/landing/Features.tsx"
    click ContentSection "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/landing/ContentSection.tsx"
    click Cta "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/landing/Cta.tsx"
    click Dashboard "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/landing/Dashboard.tsx"
    click FAQItem "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/faq/FAQItem.tsx"
    click Header "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/layout/Header.tsx"
    click Footer "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/layout/Footer.tsx"
    click ContactModal "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/modals/ContactModal.tsx"
    click PricingModal "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/modals/PricingModal.tsx"
    click useContactModal "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/hooks/useContactModal.ts"
    click Accordion "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/ui/accordion.tsx"
    click Badge "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/ui/badge.tsx"
    click Button "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/ui/button.tsx"
    click Card "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/ui/card.tsx"
    click Dialog "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/components/ui/dialog.tsx"
    click Constants "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/lib/constans.ts"
    click Utils "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/lib/utils.ts"
    click GlobalsCSS "https://github.com/josemacruz/opositandos-web-landing/blob/main/src/app/globals.css"
    click TailwindConfig "https://github.com/josemacruz/opositandos-web-landing/blob/main/tailwind.config.ts"
    click PostCSSConfig "https://github.com/josemacruz/opositandos-web-landing/blob/main/postcss.config.js"
    click NextConfig "https://github.com/josemacruz/opositandos-web-landing/blob/main/next.config.ts"
    click TSConfig "https://github.com/josemacruz/opositandos-web-landing/blob/main/tsconfig.json"
    click ESLintConfig "https://github.com/josemacruz/opositandos-web-landing/blob/main/eslint.config.mjs"
    click PackageJSON "https://github.com/josemacruz/opositandos-web-landing/blob/main/package.json"
    click Images "https://github.com/josemacruz/opositandos-web-landing/tree/main/public/images"

    %% Styles
    classDef external fill:#D0E8FF,stroke:#4A90E2,color:#000
    classDef server fill:#D0FFD6,stroke:#34A853,color:#000
    classDef module fill:#FFF7CC,stroke:#F4B400,color:#000
    classDef assets fill:#FFE6CC,stroke:#FB8C00,color:#000
    classDef pipeline fill:#E6FFFA,stroke:#00C4B4,color:#000
```
