# masterquiz/brain-street-7 architecture

> Architecture diagram of the GitHub repository masterquiz/brain-street-7, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-07-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/masterquiz/brain-street-7
- Repository: https://github.com/masterquiz/brain-street-7

## Overview

1. This repository is a mostly static Next.js App Router site for presenting a project portfolio/documentation set. There is no visible backend, database, or API layer; the app is driven by local content files and assets.

2. The application structure is centered in `src/app`, using route-based pages:
   - `src/app/page.tsx` for the landing page
   - `src/app/(details)/project/page.tsx`
   - `src/app/(details)/team/page.tsx`
   - `src/app/(details)/assignments/page.tsx`
   
   The `(details)` folder is a route group, so it organizes related pages without affecting the URL path structure.

3. The main information flow appears to be: page components read from `src/data/assignments.ts`, then render content through reusable UI components. That makes the assignments section data-driven rather than hardcoded inside the page itself.

4. Reusable presentation logic lives in `src/components`:
   - `Honeycomb.tsx` and `Honeycomb.module.css` likely implement a custom visual navigation or grid element for the homepage
   - `HomeSection.tsx` looks like a shared layout/content block
   - `ToggleColorScheme.tsx` and its CSS module handle theme switching
   
   These components form the main UI boundaries between page-level composition and shared interaction/visual patterns.

5. Styling is split between global and component-scoped layers:
   - `src/app/globals.css` for app-wide styles
   - CSS Modules for isolated component styling
   - `tailwind.config.ts` indicates Tailwind is part of the styling toolchain, even if some components also use module CSS
   
   This suggests a hybrid styling approach rather than a single CSS system.

6. `src/app/layout.tsx` is the root application shell. In a Next.js App Router repo, this is where the shared document structure, fonts, and top-level providers typically live. The presence of `src/app/fonts` and the README note about `next/font` indicate typography is part of the global shell.

7. Static content is a major part of the app. The `public/assignments` tree contains PDFs organized by milestone (`C1` through `C7`), including needfinding, focus group outputs, prototyping, heuristic evaluation, user testing, and final presentation. These files are meant to be served directly and linked from the site.

8. The `public/profile` directory likely stores profile imagery or team assets used by the team page or homepage. Since it sits under `public`, these assets are available as direct static URLs rather than imported build-time modules.

9. The project pages seem content-oriented rather than interactive business logic. The repo is essentially a structured presentation layer around a set of design/process artifacts, with navigation among project, team, and assignments sections.

10. The architecture boundary is therefore:
   - content/data layer: `src/data/assignments.ts` and PDF/image assets in `public/`
   - presentation layer: `src/components/*`
   - routing/layout layer: `src/app/*`
   
   There is no evidence of server-side persistence or external service integration that would complicate the diagram.

11. Tooling and runtime are standard Next.js/TypeScript:
   - Next.js App Router
   - TypeScript (`tsconfig.json`)
   - ESLint (`.eslintrc.json`)
   - PostCSS/Tailwind (`postcss.config.mjs`, `tailwind.config.ts`)
   
   Deployment is implicitly Vercel-friendly, matching the README guidance.

12. For an architecture diagram, the most important relationship to show is: user browser → Next.js route pages → shared UI components → static content/assets in `public` and local data in `src/data`. That captures the repo’s actual behavior without inventing server-side subsystems.

Main entry points: [`src/app/layout.tsx`](https://github.com/masterquiz/brain-street-7/blob/main/src/app/layout.tsx) (Root layout), [`src/app/globals.css`](https://github.com/masterquiz/brain-street-7/blob/main/src/app/globals.css) (Global styles), [`src/app/page.tsx`](https://github.com/masterquiz/brain-street-7/blob/main/src/app/page.tsx) (Home page), [`src/components/HomeSection.tsx`](https://github.com/masterquiz/brain-street-7/blob/main/src/components/HomeSection.tsx) (Home section)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_group_routes["Routing shell"]
  node_node_layout["Root layout<br/>next layout<br/>[layout.tsx]"]
  node_node_home["Home page<br/>route page<br/>[page.tsx]"]
  node_node_project["Project page<br/>route page<br/>[page.tsx]"]
  node_node_team["Team page<br/>route page<br/>[page.tsx]"]
  node_node_assignments["Assignments page<br/>route page<br/>[page.tsx]"]
end

subgraph group_group_ui["UI layer"]
  node_node_honeycomb{{"Honeycomb<br/>visual nav<br/>[Honeycomb.tsx]"}}
  node_node_home_section["Home section<br/>layout block<br/>[HomeSection.tsx]"]
  node_node_theme_toggle["Theme toggle<br/>interaction"]
end

subgraph group_group_content["Content layer"]
  node_node_assignments_data["Assignments data<br/>content model<br/>[assignments.ts]"]
  node_node_assignment_pdfs["Assignment PDFs<br/>static assets"]
  node_node_profile_assets["Profile assets<br/>static assets"]
end

subgraph group_group_tooling["Tooling"]
  node_node_globals["Global styles<br/>stylesheet<br/>[globals.css]"]
  node_node_tailwind["Tailwind config<br/>styling config<br/>[tailwind.config.ts]"]
  node_node_postcss["PostCSS<br/>build config<br/>[postcss.config.mjs]"]
  node_node_next_config["Next config<br/>build config<br/>[next.config.ts]"]
  node_node_tsconfig["TypeScript config<br/>type config<br/>[tsconfig.json]"]
end

node_node_root(("Browser<br/>client"))

node_node_root -->|"loads shell"| node_node_layout
node_node_layout -->|"renders"| node_node_home
node_node_layout -->|"renders"| node_node_project
node_node_layout -->|"renders"| node_node_team
node_node_layout -->|"renders"| node_node_assignments
node_node_home -->|"uses"| node_node_honeycomb
node_node_home -->|"uses"| node_node_home_section
node_node_home -->|"uses"| node_node_theme_toggle
node_node_project -->|"uses"| node_node_home_section
node_node_team -->|"uses"| node_node_home_section
node_node_assignments -->|"reads"| node_node_assignments_data
node_node_assignments -->|"links"| node_node_assignment_pdfs
node_node_team -.->|"uses"| node_node_profile_assets
node_node_layout -->|"applies"| node_node_globals
node_node_home_section -.->|"styles with"| node_node_globals
node_node_honeycomb -.->|"styles with"| node_node_globals
node_node_theme_toggle -.->|"styles with"| node_node_globals
node_node_globals -.->|"coexists with"| node_node_tailwind
node_node_tailwind -->|"processed by"| node_node_postcss
node_node_next_config -.->|"configures"| node_node_layout
node_node_tsconfig -.->|"types"| node_node_layout

click node_node_layout "https://github.com/masterquiz/brain-street-7/blob/main/src/app/layout.tsx"
click node_node_home "https://github.com/masterquiz/brain-street-7/blob/main/src/app/page.tsx"
click node_node_project "https://github.com/masterquiz/brain-street-7/blob/main/src/app/(details)/project/page.tsx"
click node_node_team "https://github.com/masterquiz/brain-street-7/blob/main/src/app/(details)/team/page.tsx"
click node_node_assignments "https://github.com/masterquiz/brain-street-7/blob/main/src/app/(details)/assignments/page.tsx"
click node_node_honeycomb "https://github.com/masterquiz/brain-street-7/blob/main/src/components/Honeycomb.tsx"
click node_node_home_section "https://github.com/masterquiz/brain-street-7/blob/main/src/components/HomeSection.tsx"
click node_node_theme_toggle "https://github.com/masterquiz/brain-street-7/blob/main/src/components/ToggleColorScheme.tsx"
click node_node_assignments_data "https://github.com/masterquiz/brain-street-7/blob/main/src/data/assignments.ts"
click node_node_assignment_pdfs "https://github.com/masterquiz/brain-street-7/tree/main/public/assignments"
click node_node_profile_assets "https://github.com/masterquiz/brain-street-7/tree/main/public/profile"
click node_node_globals "https://github.com/masterquiz/brain-street-7/blob/main/src/app/globals.css"
click node_node_tailwind "https://github.com/masterquiz/brain-street-7/blob/main/tailwind.config.ts"
click node_node_postcss "https://github.com/masterquiz/brain-street-7/blob/main/postcss.config.mjs"
click node_node_next_config "https://github.com/masterquiz/brain-street-7/blob/main/next.config.ts"
click node_node_tsconfig "https://github.com/masterquiz/brain-street-7/blob/main/tsconfig.json"

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_node_layout,node_node_home,node_node_project,node_node_team,node_node_assignments toneBlue
class node_node_honeycomb,node_node_home_section,node_node_theme_toggle toneAmber
class node_node_assignments_data,node_node_assignment_pdfs,node_node_profile_assets toneMint
class node_node_globals,node_node_tailwind,node_node_postcss,node_node_next_config,node_node_tsconfig toneRose
class node_node_root toneNeutral
```

## Components

### Routing shell

Next.js App Router pages and shared document structure.

- [Root layout](https://github.com/masterquiz/brain-street-7/blob/main/src/app/layout.tsx): next layout · Shared App Router shell for document structure, fonts, and top-level providers. · `src/app/layout.tsx`
- [Home page](https://github.com/masterquiz/brain-street-7/blob/main/src/app/page.tsx): route page · Landing page for the portfolio/documentation site. · `src/app/page.tsx`
- [Project page](https://github.com/masterquiz/brain-street-7/blob/main/src/app/(details)/project/page.tsx): route page · Project-focused details page. · `src/app/(details)/project/page.tsx`
- [Team page](https://github.com/masterquiz/brain-street-7/blob/main/src/app/(details)/team/page.tsx): route page · Team-focused details page. · `src/app/(details)/team/page.tsx`
- [Assignments page](https://github.com/masterquiz/brain-street-7/blob/main/src/app/(details)/assignments/page.tsx): route page · Assignments hub rendered from local data and static files. · `src/app/(details)/assignments/page.tsx`

### UI layer

Reusable components and visual interaction patterns.

- [Honeycomb](https://github.com/masterquiz/brain-street-7/blob/main/src/components/Honeycomb.tsx): visual nav · Custom homepage visual grid or navigation element. · `src/components/Honeycomb.tsx`
- [Home section](https://github.com/masterquiz/brain-street-7/blob/main/src/components/HomeSection.tsx): layout block · Reusable content section used to compose page content. · `src/components/HomeSection.tsx`
- [Theme toggle](https://github.com/masterquiz/brain-street-7/blob/main/src/components/ToggleColorScheme.tsx): interaction · Color-scheme switcher and related styling. · `src/components/ToggleColorScheme.tsx`

### Content layer

Local data and static assets that drive the site.

- [Assignments data](https://github.com/masterquiz/brain-street-7/blob/main/src/data/assignments.ts): content model · Typed local data source consumed by the assignments page. · `src/data/assignments.ts`
- [Assignment PDFs](https://github.com/masterquiz/brain-street-7/tree/main/public/assignments): static assets · Milestone documents and deliverables served directly from public/assignments. · `public/assignments`
- [Profile assets](https://github.com/masterquiz/brain-street-7/tree/main/public/profile): static assets · Public profile imagery or team assets available at direct URLs. · `public/profile`

### Tooling

Build, styling, and type-check configuration.

- [Global styles](https://github.com/masterquiz/brain-street-7/blob/main/src/app/globals.css): stylesheet · App-wide CSS baseline for the site. · `src/app/globals.css`
- [Tailwind config](https://github.com/masterquiz/brain-street-7/blob/main/tailwind.config.ts): styling config · Tailwind setup used alongside CSS modules and global styles. · `tailwind.config.ts`
- [PostCSS](https://github.com/masterquiz/brain-street-7/blob/main/postcss.config.mjs): build config · PostCSS pipeline configuration for CSS processing. · `postcss.config.mjs`
- [Next config](https://github.com/masterquiz/brain-street-7/blob/main/next.config.ts): build config · Framework configuration for the Next.js build and runtime. · `next.config.ts`
- [TypeScript config](https://github.com/masterquiz/brain-street-7/blob/main/tsconfig.json): type config · TypeScript compiler configuration for the repository. · `tsconfig.json`

### Other components

- **Browser**: client · User-facing entry point that requests the static site and navigates between pages.

## Connections

- Browser → Root layout: loads shell · The browser loads the shared app shell before route content.
- Root layout → Home page: renders · The root route is composed inside the shared layout.
- Root layout → Project page: renders · Project route content is mounted within the shared layout.
- Root layout → Team page: renders · Team route content is mounted within the shared layout.
- Root layout → Assignments page: renders · Assignments route content is mounted within the shared layout.
- Home page → Honeycomb: uses · The landing page uses the custom honeycomb visual/navigation component.
- Home page → Home section: uses · The landing page is assembled from reusable content sections.
- Home page → Theme toggle: uses · The landing page exposes theme switching via the shared toggle.
- Project page → Home section: uses · Project content is built from shared section blocks.
- Team page → Home section: uses · Team content is built from shared section blocks.
- Assignments page → Assignments data: reads · Assignments page reads structured local data rather than hardcoding entries.
- Assignments page → Assignment PDFs: links · Assignments page references milestone PDFs stored under public assets.
- Team page → Profile assets: uses · Team page likely draws imagery or avatars from public profile assets.
- Root layout → Global styles: applies · The app shell applies global styling to all routes.
- Home section → Global styles: styles with · Reusable sections inherit global styling baseline.
- Honeycomb → Global styles: styles with · Honeycomb component styling is layered over global styles.
- Theme toggle → Global styles: styles with · Theme toggle styling participates in the global CSS layer.
- Global styles → Tailwind config: coexists with · Global CSS is used alongside the Tailwind toolchain.
- Tailwind config → PostCSS: processed by · Tailwind styles are built through the PostCSS pipeline.
- Next config → Root layout: configures · Next.js configuration shapes how the app is built and served.
- TypeScript config → Root layout: types · TypeScript settings govern the App Router source tree.
