# biznessology/vibeathon-landing-page-build architecture

> Architecture diagram of the GitHub repository biznessology/vibeathon-landing-page-build, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/biznessology/vibeathon-landing-page-build
- Repository: https://github.com/biznessology/vibeathon-landing-page-build

## Overview

##### Project type and purpose
- This is a single-page frontend application built with Vite, React, and TypeScript.
- It renders a static marketing/event site (“Lovable”) with sections like Agenda, Prizes, Timeline, RegistrationForm, etc., using shadcn-ui and Tailwind CSS for styling.

##### File structure
- **Top-level files & configs**
- index.html, public/robots.txt – static entry point and public assets
- vite.config.ts, postcss.config.js, tailwind.config.ts – build & CSS pipelines
- tsconfig*.json, eslint.config.js – TypeScript & linting
- **src/**
- main.tsx → mounts the root React App
- App.tsx / App.css → top-level layout & global styles
- pages/Index.tsx, NotFound.tsx → route targets
- components/… → feature sections (Agenda, Hero, Timeline, etc.)
- components/ui/… → shadcn-ui primitives & custom wrapped components
- hooks/… → React hooks (useMobile, useToast)
- lib/utils.ts → shared utilities
- No backend code or database; it’s purely client-side.

##### Key insights from README
- Tech stack: Vite, TypeScript, React, shadcn-ui, Tailwind
- Deployment via Lovable platform (publishes a static bundle)
- Editing via IDE or Lovable’s online editor

a. Main components
- Developer environment
- Code repository (Git + Lovable)
- Build system (Node.js, npm, Vite)
- Static asset pipeline (PostCSS, Tailwind)
- React runtime in browser
- Component hierarchy (App → Pages → Feature Components → UI Primitives)
- External services (Lovable platform for CI/CD & hosting, CDN)
b. Relationships & interactions
- Developer → Git pushes → Lovable CI → Vite build → static bundle
- Browser requests index.html → bundle.js, CSS → React hydrates App
- App uses React Router (implicit via pages/) to switch views
- Pages import and compose feature components → each uses UI primitives
- Components call hooks for responsiveness/toast → utils for helper functions
c. Architectural patterns & design principles
- Component-based architecture (React)
- Atomic design via shadcn-ui primitives → composable UI building blocks
- Single entry point (SPA) with client-side routing
- Separation of concerns: styling (Tailwind), logic (hooks), presentation (components)
d. Key technologies/frameworks
- Vite: fast dev server & bundler
- TypeScript: type safety
- React: UI library
- shadcn-ui: headless/unopinionated component primitives
- Tailwind CSS: utility-first styling
- Lovable: git-integrated hosting/CI

## Diagram (Mermaid)

```mermaid
flowchart TD
  %% Developer Workflow
  subgraph "Developer Workflow" 
    DevIDE["Developer IDE & Git Client"]:::tools
  end

  %% Build Pipeline
  subgraph "Build Pipeline"
    GitPush["Git Push to Lovable CI"]:::tools
    Vite["Vite Dev Server & Bundler"]:::tools
    TSConfig["TypeScript Configs"]:::config
    ESLint["ESLint Config"]:::config
    CSSPipeline["CSS Pipeline (PostCSS & Tailwind)"]:::tools
    Vite -->|uses vite.config.ts| TSConfig
    Vite -->|uses vite.config.ts| TSConfig
    Vite -->|"bundles code"| Bundle
    CSSPipeline -->|"processes CSS"| Bundle
  end

  %% Hosting / CDN
  subgraph "Hosting & CDN"
    LovableCI["Lovable CI/CD & Hosting"]:::tools
    CDN["CDN"]:::tools
    Bundle["Static Bundle (JS & CSS)"]:::runtime
    LovableCI -->|deploys| CDN
    Bundle -->|served from| CDN
  end

  %% Browser Runtime
  subgraph "Browser Runtime"
    Browser["Browser"]:::runtime
    IndexHTML["SPA Entry Point (index.html)"]:::runtime
    MainTSX["React Mount & Dev Server Entry"]:::runtime
    ReactRuntime["React Runtime"]:::runtime
    AppContainer["App Container & Global Styles"]:::code
    Browser -->|loads| CDN
    Browser -->|requests| IndexHTML
    IndexHTML -->|loads bundle| Bundle
    Bundle -->|executes| MainTSX
    MainTSX -->|mounts| ReactRuntime
    ReactRuntime -->|renders| AppContainer
  end

  %% Code Modules
  subgraph "Code Modules"
    subgraph Pages
      IndexPage["Index Page"]:::code
      NotFoundPage["Not Found Page"]:::code
    end
    subgraph "Feature Components"
      Agenda["Agenda"]:::code
      Challenge["ChallengeStructure"]:::code
      Footer["Footer"]:::code
      Hero["Hero"]:::code
      Navbar["Navbar"]:::code
      Prizes["Prizes"]:::code
      Registration["RegistrationForm"]:::code
      ThemeSec["ThemeSection"]:::code
      Timeline["Timeline"]:::code
      WhyVibe["WhyVibeAThon"]:::code
    end
    UIPrimitives["UI Primitives (shadcn-ui wrappers)"]:::code
    subgraph Hooks
      UseMobile["use-mobile"]:::code
      UseToast["use-toast"]:::code
    end
    Utils["Shared Utilities"]:::code
    AppContainer -->|uses| Pages
    Pages -->|imports| FeatureComponents["Feature Components"]
    FeatureComponents -->|use| UIPrimitives
    FeatureComponents -->|use| Hooks
    Hooks -->|use| Utils
  end

  %% Connections
  DevIDE -->|push code| GitPush
  GitPush -->|triggers| LovableCI
  LovableCI -->|runs| Vite
  LovableCI -->|runs| CSSPipeline
  LovableCI -->|runs| TSConfig
  LovableCI -->|runs| ESLint
  Vite -->|outputs| Bundle
  CSSPipeline -->|outputs| Bundle

  %% Click Events
  click IndexHTML "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/index.html"
  click Vite "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/vite.config.ts"
  click CSSPipeline "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/postcss.config.js"
  click CSSPipeline "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/tailwind.config.ts"
  click MainTSX "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/main.tsx"
  click AppContainer "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/App.tsx"
  click AppContainer "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/App.css"
  click IndexPage "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/pages/Index.tsx"
  click NotFoundPage "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/pages/NotFound.tsx"
  click Agenda "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/components/Agenda.tsx"
  click Challenge "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/components/ChallengeStructure.tsx"
  click Footer "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/components/Footer.tsx"
  click Hero "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/components/Hero.tsx"
  click Navbar "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/components/Navbar.tsx"
  click Prizes "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/components/Prizes.tsx"
  click Registration "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/components/RegistrationForm.tsx"
  click ThemeSec "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/components/ThemeSection.tsx"
  click Timeline "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/components/Timeline.tsx"
  click WhyVibe "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/components/WhyVibeAThon.tsx"
  click UIPrimitives "https://github.com/biznessology/vibeathon-landing-page-build/tree/main/src/components/ui/"
  click UseMobile "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/hooks/use-mobile.tsx"
  click UseToast "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/hooks/use-toast.ts"
  click Utils "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/src/lib/utils.ts"
  click Bundle "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/public/robots.txt"
  click TSConfig "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/tsconfig.json"
  click TSConfig "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/tsconfig.app.json"
  click TSConfig "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/tsconfig.node.json"
  click ESLint "https://github.com/biznessology/vibeathon-landing-page-build/blob/main/eslint.config.js"

  %% Styles
  classDef tools fill:#f9f,stroke:#333,stroke-width:1px
  classDef runtime fill:#ff9,stroke:#333,stroke-width:1px
  classDef config fill:#9ff,stroke:#333,stroke-width:1px
  classDef code fill:#9f9,stroke:#333,stroke-width:1px
```
