# ayushsoni86/music-website-next-js architecture

> Architecture diagram of the GitHub repository ayushsoni86/music-website-next-js, 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/ayushsoni86/music-website-next-js
- Repository: https://github.com/ayushsoni86/music-website-next-js

## Overview

##### Project type and purpose
- This is a Next.js–based web application (a JAMstack-style marketing site) bootstrapped with `create-next-app`.
- Purpose: render a static/SSR site showcasing courses, webinars, testimonials, contact page, etc., using React components, local JSON data, and Tailwind CSS.

##### File structure
- Top-level files:
- `next.config.ts`, `eslint.config.mjs`, `tailwind.config.ts`, `postcss.config.mjs`, `tsconfig.json` – build, lint, and framework configs.
- `package.json` – dependencies and scripts.
- `/public` – static assets (images, courses folder).
- Source tree (`/src`):
- `/app` – Next.js App Router (folder-based routing). Contains pages: `page.tsx`, `/contact`, `/courses`.
- `/components` – UI building blocks (layout, navbar, hero, footer, sectional components).
- `/components/ui` – low-level presentational and interactive widgets (animations, 3D cards, tooltips, backgrounds).
- `/data` – local JSON data sources (courses, webinars, testimonials, people, “why choose us” content).
- `/utils` – shared utility functions.

##### README for additional insights
- Confirms it’s a Next.js app optimized with the App Router and next/font.
- No mention of external APIs—data is consumed from local JSON.
- Deployment target is Vercel.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Development Layer
    subgraph "Development"
        Dev["Developer Machine"]:::dev
        Git["Git Repository"]:::dev
        Dev -->|push code| Git
    end

    %% Build & Deploy Layer
    subgraph "Build & Deploy"
        CICD["CI/CD Pipeline"]:::build
        Configs["Build Configurations"]:::build
        Build["Next.js Build Process"]:::build
        Deploy["Deployment Artifacts"]:::build
        Git -->|trigger| CICD
        CICD -->|uses| Configs
        CICD -->|runs| Build
        Build -->|outputs| Deploy
        Deploy -->|deploy to| CDN
    end

    %% Runtime Layer
    subgraph "Runtime"
        CDN["CDN (Vercel)"]:::runtime
        Runtime["Next.js Runtime (SSR/SSG)"]:::runtime
        DataStore["Local JSON Data Store"]:::data
        Assets["Public Static Assets"]:::data

        CDN -->|serves static| Assets
        CDN -->|for SSR| Runtime
        Runtime -->|reads| DataStore
        Runtime -->|reads| Assets
        Runtime -->|serves| CDN
    end

    %% Routing & Components
    subgraph "Next.js App Router & Components"
        subgraph "Routing (src/app)"
            Layout["layout.tsx"]:::router
            Globals["globals.css"]:::router
            Home["page.tsx (/)"]:::router
            Contact["page.tsx (contact)"]:::router
            Courses["page.tsx (courses)"]:::router
            Layout --> Home
            Layout --> Contact
            Layout --> Courses
        end

        subgraph "Sectional Components (src/components)"
            Navbar["Navbar.tsx"]:::comp
            Hero["HeroSection.tsx"]:::comp
            FeaturedCourses["FeaturedCourses.tsx"]:::comp
            UpcomingWebinars["UpcomingWebinars.tsx"]:::comp
            TestimonialCards["TestimonialCards.tsx"]:::comp
            Instructors["Instructors.tsx"]:::comp
            WhyChooseUs["WhyChooseUs.tsx"]:::comp
            Footer["Footer.tsx"]:::comp
        end

        subgraph "UI Primitives (src/components/ui)"
            Card3D["3d-card.tsx"]:::ui
            Spotlight["Spotlight.tsx"]:::ui
            Tooltip["animated-tooltip.tsx"]:::ui
            Beams["background-beams.tsx"]:::ui
            Gradient["background-gradient.tsx"]:::ui
            HoverEffect["card-hover-effect.tsx"]:::ui
            InfiniteCards["infinite-moving-cards.tsx"]:::ui
            Meteors["meteors.tsx"]:::ui
            MovingBorder["moving-border.tsx"]:::ui
            NavbarMenu["navbar-menu.tsx"]:::ui
            ScrollReveal["sticky-scroll-reveal.tsx"]:::ui
            WavyBg["wavy-background.tsx"]:::ui
        end

        subgraph "Utilities & Data"
            Utils["utils.ts"]:::util
            FeaturedWebinars["featured_webinars.json"]:::data
            MusicCourses["music_courses.json"]:::data
            Testimonials["music_school_testimonials.json"]:::data
            People["people.json"]:::data
            WhyChooseUsData["why_choose_us.json"]:::data
        end

        Home --> Navbar & Hero & FeaturedCourses & UpcomingWebinars & TestimonialCards & Instructors & WhyChooseUs & Footer
        Contact --> Navbar & Footer
        Courses --> Navbar & FeaturedCourses & Footer
        FeaturedCourses --> MusicCourses
        UpcomingWebinars --> FeaturedWebinars
        TestimonialCards --> Testimonials
        Instructors --> People
        WhyChooseUs --> WhyChooseUsData
        Navbar --> NavbarMenu
        Hero --> Beams & Gradient & WavyBg
        Card3D & Tooltip & HoverEffect & InfiniteCards & Meteors & MovingBorder & Spotlight & ScrollReveal -->|used by| SectionalComponents
    end

    %% Client Layer
    subgraph "Client"
        Browser["Browser"]:::client
        Browser -->|request page| CDN
        Browser -->|receive HTML/CSS/JS| CDN
        Browser -->|hydrate UI| Runtime
    end

    %% Click Events
    click Configs "https://github.com/ayushsoni86/music-website-next-js/blob/main/next.config.ts"
    click Configs "https://github.com/ayushsoni86/music-website-next-js/blob/main/tailwind.config.ts"
    click Configs "https://github.com/ayushsoni86/music-website-next-js/blob/main/postcss.config.mjs"
    click Configs "https://github.com/ayushsoni86/music-website-next-js/blob/main/eslint.config.mjs"
    click Assets "https://github.com/ayushsoni86/music-website-next-js/tree/main/public/"
    click Assets "https://github.com/ayushsoni86/music-website-next-js/tree/main/public/courses/"
    click FeaturedWebinars "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/data/featured_webinars.json"
    click MusicCourses "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/data/music_courses.json"
    click Testimonials "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/data/music_school_testimonials.json"
    click People "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/data/people.json"
    click WhyChooseUsData "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/data/why_choose_us.json"
    click Layout "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/app/layout.tsx"
    click Globals "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/app/globals.css"
    click Home "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/app/page.tsx"
    click Contact "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/app/contact/page.tsx"
    click Courses "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/app/courses/page.tsx"
    click Navbar "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/Navbar.tsx"
    click Hero "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/HeroSection.tsx"
    click FeaturedCourses "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/FeaturedCourses.tsx"
    click UpcomingWebinars "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/UpcomingWebinars.tsx"
    click TestimonialCards "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/TestimonailCards.tsx"
    click Instructors "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/Instructors.tsx"
    click WhyChooseUs "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/WhyChooseUs.tsx"
    click Footer "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/Footer.tsx"
    click Card3D "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/ui/3d-card.tsx"
    click Spotlight "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/ui/Spotlight.tsx"
    click Tooltip "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/ui/animated-tooltip.tsx"
    click Beams "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/ui/background-beams.tsx"
    click Gradient "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/ui/background-gradient.tsx"
    click HoverEffect "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/ui/card-hover-effect.tsx"
    click InfiniteCards "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/ui/infinite-moving-cards.tsx"
    click Meteors "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/ui/meteors.tsx"
    click MovingBorder "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/ui/moving-border.tsx"
    click NavbarMenu "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/ui/navbar-menu.tsx"
    click ScrollReveal "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/ui/sticky-scroll-reveal.tsx"
    click WavyBg "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/components/ui/wavy-background.tsx"
    click Utils "https://github.com/ayushsoni86/music-website-next-js/blob/main/src/utils/utils.ts"
    click Deploy "https://github.com/ayushsoni86/music-website-next-js/blob/main/package.json"
    click Deploy "https://github.com/ayushsoni86/music-website-next-js/blob/main/tsconfig.json"
    click Deploy "https://github.com/ayushsoni86/music-website-next-js/blob/main/README.md"

    %% Styling
    classDef dev fill:#D0E8FF,stroke:#0366d6,color:#0366d6;
    classDef build fill:#E8F4D0,stroke:#6c9a16,color:#6c9a16;
    classDef runtime fill:#FFE8D0,stroke:#d97706,color:#d97706;
    classDef data fill:#E0FFE0,stroke:#16a34a,color:#16a34a;
    classDef router fill:#DCE7FF,stroke:#2563eb,color:#2563eb;
    classDef comp fill:#F3E8FF,stroke:#9333ea,color:#9333ea;
    classDef ui fill:#FFF0F6,stroke:#db2777,color:#db2777;
    classDef util fill:#F0F9FF,stroke:#0369a1,color:#0369a1;
    classDef client fill:#FEF3C7,stroke:#d97706,color:#d97706;
```
