# leets-official/zzazo-fe architecture

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

- Interactive diagram: https://gitdiagram.com/leets-official/zzazo-fe
- Repository: https://github.com/leets-official/zzazo-fe

## Overview

1. This repository is a **front-end-only Next.js application** for “ZZAZO” (`ZZAZO-FE`). The repo does not show any backend, database, or API client layer in the checked-in files, so the main architectural boundary is between the browser UI and whatever external services the app may call at runtime.

2. The application uses the **Next.js App Router** structure under `src/app`. The current visible routes are minimal: a root page (`src/app/page.tsx`) and a global layout (`src/app/layout.tsx`). That indicates a single-page entry point with shared application shell concerns centralized in the layout.

3. `src/app/layout.tsx` is the top-level composition layer. In a Next.js App Router app, this is where global HTML structure, metadata, and common providers would live. For an architecture diagram, treat it as the wrapper around all route content.

4. `src/app/page.tsx` is the root UI surface. Since no other route folders are present, the current application surface appears to be a single landing/home page rather than a multi-module front end.

5. Global styling is handled through `src/app/globals.css`, with `postcss.config.mjs` and `src/app/globals.css` indicating a CSS pipeline managed by Next.js/PostCSS. The style layer is global rather than component-scoped, which suggests the app’s visual system is currently lightweight.

6. Static assets are served from `public/`. Anything placed there is exposed directly by Next.js as static files, so this is the boundary for images, icons, and other non-code assets used by the UI.

7. The repo is configured as a **TypeScript** project (`tsconfig.json`) with modern Next.js config (`next.config.ts`). That means the front-end logic is compiled and type-checked, and the architecture should include a build step that transforms source code into production-ready assets.

8. Tooling is a significant part of the repository structure: **pnpm** manages dependencies (`pnpm-workspace.yaml`, `pnpm-lock.yaml`), **ESLint** enforces code quality (`eslint.config.mjs`), and **Prettier** formats code (`.prettierrc`, `.prettierignore`). These are not runtime subsystems, but they define the engineering workflow around the app.

9. **Husky** hooks (`.husky/pre-commit`, `.husky/commit-msg`) enforce checks before commits. Architecturally, this means quality gates exist at the developer workflow boundary rather than in the application runtime.

10. The `.github` folder contains issue and pull request templates, which indicates a lightweight governance/process layer around the codebase. This does not affect runtime architecture, but it shows the repository is organized for team collaboration and standardized contribution flow.

11. Overall, the current architecture is very small and centralized: **Next.js app shell + root page + global CSS + static public assets**, with no visible internal service decomposition. If you are drawing the architecture, the primary boxes are the browser, the Next.js front-end application, and any external services it consumes.

Main entry points: [`src/app`](https://github.com/leets-official/zzazo-fe/tree/main/src/app) (Next app), [`.husky`](https://github.com/leets-official/zzazo-fe/blob/main/.husky) (Husky hooks), [`eslint.config.mjs`](https://github.com/leets-official/zzazo-fe/blob/main/eslint.config.mjs) (ESLint), [`src/app/globals.css`](https://github.com/leets-official/zzazo-fe/blob/main/src/app/globals.css) (Global CSS)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime"]
  node_browser(("Browser<br/>client"))
  node_next_app["Next app<br/>nextjs app"]
  node_layout["Layout<br/>app shell<br/>[layout.tsx]"]
  node_page["Home page<br/>route page<br/>[page.tsx]"]
  node_styles["Global CSS<br/>style layer<br/>[globals.css]"]
  node_assets[("Public assets<br/>static files")]
  node_external{{"External services<br/>runtime boundary"}}
end

subgraph group_tooling["Tooling"]
  node_build["Next build<br/>build pipeline<br/>[next.config.ts]"]
  node_ts["TypeScript<br/>typecheck<br/>[tsconfig.json]"]
  node_lint["ESLint<br/>code quality<br/>[eslint.config.mjs]"]
  node_format["Prettier<br/>formatting<br/>[.prettierrc]"]
  node_package_mgr["pnpm<br/>package manager"]
  node_styles_build["PostCSS<br/>css pipeline<br/>[postcss.config.mjs]"]
  node_precommit["Husky hooks<br/>git hooks<br/>[.husky]"]
end

subgraph group_governance["Governance"]
  node_templates["GitHub templates<br/>contribution workflow<br/>[.github]"]
end

node_browser -->|"loads"| node_next_app
node_next_app -->|"wraps"| node_layout
node_next_app -->|"serves"| node_page
node_layout -->|"applies"| node_styles
node_page -->|"uses"| node_styles
node_next_app -->|"references"| node_assets
node_next_app -.->|"calls"| node_external
node_build -->|"bundles"| node_next_app
node_ts -->|"types"| node_next_app
node_lint -->|"checks"| node_next_app
node_format -->|"formats"| node_next_app
node_package_mgr -->|"installs"| node_build
node_package_mgr -->|"runs"| node_lint
node_styles_build -->|"processes"| node_styles
node_precommit -->|"gates"| node_lint
node_precommit -->|"gates"| node_format
node_templates -.->|"supports"| node_precommit

click node_next_app "https://github.com/leets-official/zzazo-fe/tree/main/src/app"
click node_layout "https://github.com/leets-official/zzazo-fe/blob/main/src/app/layout.tsx"
click node_page "https://github.com/leets-official/zzazo-fe/blob/main/src/app/page.tsx"
click node_styles "https://github.com/leets-official/zzazo-fe/blob/main/src/app/globals.css"
click node_assets "https://github.com/leets-official/zzazo-fe/tree/main/public"
click node_build "https://github.com/leets-official/zzazo-fe/blob/main/next.config.ts"
click node_ts "https://github.com/leets-official/zzazo-fe/blob/main/tsconfig.json"
click node_lint "https://github.com/leets-official/zzazo-fe/blob/main/eslint.config.mjs"
click node_format "https://github.com/leets-official/zzazo-fe/blob/main/.prettierrc"
click node_package_mgr "https://github.com/leets-official/zzazo-fe/blob/main/pnpm-workspace.yaml"
click node_styles_build "https://github.com/leets-official/zzazo-fe/blob/main/postcss.config.mjs"
click node_precommit "https://github.com/leets-official/zzazo-fe/blob/main/.husky"
click node_templates "https://github.com/leets-official/zzazo-fe/blob/main/.github"

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_browser,node_next_app,node_layout,node_page,node_styles,node_assets,node_external toneBlue
class node_build,node_ts,node_lint,node_format,node_package_mgr,node_styles_build,node_precommit toneAmber
class node_templates toneMint
```

## Components

### Runtime

App code that runs in the browser and Next.js server/runtime

- **Browser**: client · User-facing execution environment that loads the app
- [Next app](https://github.com/leets-official/zzazo-fe/tree/main/src/app): nextjs app · Front-end application built with the Next.js App Router · `src/app`
- [Layout](https://github.com/leets-official/zzazo-fe/blob/main/src/app/layout.tsx): app shell · Shared HTML shell and global wrapper for all routes · `src/app/layout.tsx`
- [Home page](https://github.com/leets-official/zzazo-fe/blob/main/src/app/page.tsx): route page · Root landing page and current main UI surface · `src/app/page.tsx`
- [Global CSS](https://github.com/leets-official/zzazo-fe/blob/main/src/app/globals.css): style layer · Application-wide styling loaded through the App Router · `src/app/globals.css`
- [Public assets](https://github.com/leets-official/zzazo-fe/tree/main/public): static files · Static files served directly by Next.js · `public`
- **External services**: runtime boundary · Any APIs or third-party services consumed by the front end at runtime

### Tooling

Build, lint, format, and package-management workflow

- [Next build](https://github.com/leets-official/zzazo-fe/blob/main/next.config.ts): build pipeline · Compilation and production bundling for the app · `next.config.ts`
- [TypeScript](https://github.com/leets-official/zzazo-fe/blob/main/tsconfig.json): typecheck · Static typing and source compilation support · `tsconfig.json`
- [ESLint](https://github.com/leets-official/zzazo-fe/blob/main/eslint.config.mjs): code quality · Static analysis and linting rules · `eslint.config.mjs`
- [Prettier](https://github.com/leets-official/zzazo-fe/blob/main/.prettierrc): formatting · Code formatting configuration · `.prettierrc`
- [pnpm](https://github.com/leets-official/zzazo-fe/blob/main/pnpm-workspace.yaml): package manager · Dependency and workspace management · `pnpm-workspace.yaml`
- [PostCSS](https://github.com/leets-official/zzazo-fe/blob/main/postcss.config.mjs): css pipeline · Build-time CSS processing for global styles · `postcss.config.mjs`
- [Husky hooks](https://github.com/leets-official/zzazo-fe/blob/main/.husky): git hooks · Pre-commit and commit-message quality gates · `.husky`

### Governance

Repository collaboration and contribution workflow

- [GitHub templates](https://github.com/leets-official/zzazo-fe/blob/main/.github): contribution workflow · Issue and pull request templates for collaboration · `.github`

## Connections

- Browser → Next app: loads · The browser requests and renders the Next.js front end
- Next app → Layout: wraps · The app shell provides shared structure for all routes
- Next app → Home page: serves · The root route maps to the home page
- Layout → Global CSS: applies · Global styles are attached through the top-level layout
- Home page → Global CSS: uses · The home page is styled by the global CSS layer
- Next app → Public assets: references · Routes and UI can consume files from the static public directory
- Next app → External services: calls · Runtime data or integrations would occur outside the checked-in app
- Next build → Next app: bundles · Next.js configuration drives production compilation
- TypeScript → Next app: types · TypeScript defines the source language and type checking
- ESLint → Next app: checks · ESLint validates application source
- Prettier → Next app: formats · Prettier keeps source formatting consistent
- pnpm → Next build: installs · pnpm supplies dependencies for the build and runtime toolchain
- pnpm → ESLint: runs · Package management underpins linting workflows
- PostCSS → Global CSS: processes · PostCSS transforms global CSS during build
- Husky hooks → ESLint: gates · Git hooks enforce code quality before commit
- Husky hooks → Prettier: gates · Git hooks can enforce formatting before commit
- GitHub templates → Husky hooks: supports · Repository templates and hooks shape contribution flow
