# imran-s-project/newlook architecture

> Architecture diagram of the GitHub repository imran-s-project/newlook, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/imran-s-project/newlook
- Repository: https://github.com/imran-s-project/newlook

## Overview

This is a bilingual portfolio and content platform. Visitors enter through locale-aware public routes to browse portfolio projects and case studies, read a block-based blog, search, and send contact messages; administrators sign in to manage that content and site settings. The graph preserves the documented CMS, media, SEO, theme, and cinematic nature-engine capabilities. Some subsystem links rely on README descriptions because their implementation files were not sampled; those limits are reflected in the evidence citations.

Main entry points: [`src/app/(admin)/admin/(panel)`](https://github.com/imran-s-project/newlook/tree/main/src/app/(admin)/admin/(panel)) (Admin dashboard), [`src/app/(site)/[locale]`](https://github.com/imran-s-project/newlook/tree/main/src/app/(site)/%5Blocale%5D) (Locale routes), [`src/features/admin/auth.tsx`](https://github.com/imran-s-project/newlook/blob/main/src/features/admin/auth.tsx) (Admin authentication), [`src/lib/nature/engine.ts`](https://github.com/imran-s-project/newlook/blob/main/src/lib/nature/engine.ts) (Engine coordinator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public experience"]
  node_public_routes["Locale routes"]
  node_home_sections["Portfolio home<br/>[page.tsx]"]
  node_project_browse["Project browsing"]
  node_case_studies["Case studies<br/>[CaseStudy.tsx]"]
  node_search["Site search<br/>[CommandPalette.tsx]"]
  node_contact["Contact form<br/>[ContactForm.tsx]"]
end

subgraph group_content["Content platform"]
  node_blog_browse["Blog reading"]
  node_block_rendering["Block rendering<br/>[BlockRenderer.tsx]"]
  node_editor["Block editor<br/>[BlockEditor.tsx]"]
end

subgraph group_admin["Administration"]
  node_admin_routes["Admin dashboard"]
  node_admin_auth["Admin authentication<br/>[auth.tsx]"]
  node_admin_content["Content management<br/>[data.ts]"]
  node_media["Media library<br/>[media.ts]"]
  node_taxonomy["Taxonomy manager"]
  node_site_settings["Site settings<br/>[settings.ts]"]
end

subgraph group_platform["Platform services"]
  node_firestore[("Firestore")]
  node_firebase_client["Firebase client<br/>[client.ts]"]
  node_public_data["Public data access<br/>[public.ts]"]
  node_seo["SEO metadata<br/>[metadata.ts]"]
  node_i18n["Translations<br/>[locales.ts]"]
  node_search_api["Search index API<br/>[route.ts]"]
  node_firebase_auth_service["Firebase Auth"]
  node_firebase_storage_service["Firebase Storage"]
end

subgraph group_nature["Nature engine"]
  node_nature_component["Nature background"]
  node_nature_engine["Engine coordinator<br/>[engine.ts]"]
  node_scene_manager["Scene manager<br/>[scene-manager.ts]"]
  node_quality["Quality profiling<br/>[quality.ts]"]
  node_scenes["Scene definitions<br/>[scenes.ts]"]
end

node_visitor(("Visitor"))
node_administrator(("Administrator"))

node_visitor -->|"visits"| node_public_routes
node_public_routes -->|"renders"| node_home_sections
node_home_sections -->|"loads settings"| node_public_data
node_home_sections -->|"shows projects"| node_project_browse
node_visitor -->|"browses"| node_project_browse
node_project_browse -->|"opens study"| node_case_studies
node_visitor -->|"reads posts"| node_blog_browse
node_blog_browse -->|"renders blocks"| node_block_rendering
node_visitor -->|"searches"| node_search
node_search -->|"fetches index"| node_search_api
node_search_api -->|"gets public content"| node_public_data
node_visitor -->|"sends message"| node_contact
node_administrator -->|"manages site"| node_admin_routes
node_admin_routes -->|"checks access"| node_admin_auth
node_admin_auth -->|"gets clients"| node_firebase_client
node_admin_auth -->|"authenticates"| node_firebase_auth_service
node_admin_auth -->|"checks profile"| node_firestore
node_admin_routes -->|"manages posts"| node_admin_content
node_admin_content -->|"edits blocks"| node_editor
node_admin_routes -->|"manages taxonomy"| node_taxonomy
node_taxonomy -->|"reads and writes"| node_firestore
node_admin_routes -->|"manages media"| node_media
node_media -->|"stores uploads"| node_firebase_storage_service
node_admin_routes -->|"configures site"| node_site_settings
node_firebase_client -->|"initializes client"| node_firestore
node_public_data -->|"reads content"| node_firestore
node_public_routes -->|"creates metadata"| node_seo
node_public_routes -->|"validates locale"| node_i18n
node_visitor -->|"views ambience"| node_nature_component
node_nature_component -.->|"loads engine"| node_nature_engine
node_nature_engine -->|"coordinates scenes"| node_scene_manager
node_nature_engine -->|"profiles device"| node_quality
node_nature_engine -->|"uses definitions"| node_scenes
node_scene_manager -->|"adapts playback"| node_quality

click node_public_routes "https://github.com/imran-s-project/newlook/tree/main/src/app/(site)/%5Blocale%5D"
click node_home_sections "https://github.com/imran-s-project/newlook/blob/main/src/app/(site)/%5Blocale%5D/page.tsx"
click node_project_browse "https://github.com/imran-s-project/newlook/blob/main/src/components/projects/ProjectExplorer.tsx"
click node_case_studies "https://github.com/imran-s-project/newlook/blob/main/src/components/projects/CaseStudy.tsx"
click node_blog_browse "https://github.com/imran-s-project/newlook/tree/main/src/app/(site)/%5Blocale%5D/blog"
click node_block_rendering "https://github.com/imran-s-project/newlook/blob/main/src/components/blog/BlockRenderer.tsx"
click node_search "https://github.com/imran-s-project/newlook/blob/main/src/components/search/CommandPalette.tsx"
click node_contact "https://github.com/imran-s-project/newlook/blob/main/src/components/contact/ContactForm.tsx"
click node_editor "https://github.com/imran-s-project/newlook/blob/main/src/features/editor/BlockEditor.tsx"
click node_admin_routes "https://github.com/imran-s-project/newlook/tree/main/src/app/(admin)/admin/(panel)"
click node_admin_auth "https://github.com/imran-s-project/newlook/blob/main/src/features/admin/auth.tsx"
click node_admin_content "https://github.com/imran-s-project/newlook/blob/main/src/features/admin/data.ts"
click node_media "https://github.com/imran-s-project/newlook/blob/main/src/features/admin/media.ts"
click node_taxonomy "https://github.com/imran-s-project/newlook/blob/main/src/features/admin/TaxonomyManager.tsx"
click node_site_settings "https://github.com/imran-s-project/newlook/blob/main/src/features/admin/settings.ts"
click node_firebase_client "https://github.com/imran-s-project/newlook/blob/main/src/lib/firebase/client.ts"
click node_public_data "https://github.com/imran-s-project/newlook/blob/main/src/lib/firestore/public.ts"
click node_seo "https://github.com/imran-s-project/newlook/blob/main/src/lib/seo/metadata.ts"
click node_i18n "https://github.com/imran-s-project/newlook/blob/main/src/i18n/locales.ts"
click node_nature_component "https://github.com/imran-s-project/newlook/blob/main/src/components/nature/NatureBackground.tsx"
click node_nature_engine "https://github.com/imran-s-project/newlook/blob/main/src/lib/nature/engine.ts"
click node_scene_manager "https://github.com/imran-s-project/newlook/blob/main/src/lib/nature/scene-manager.ts"
click node_quality "https://github.com/imran-s-project/newlook/blob/main/src/lib/nature/quality.ts"
click node_scenes "https://github.com/imran-s-project/newlook/blob/main/src/data/scenes.ts"
click node_search_api "https://github.com/imran-s-project/newlook/blob/main/src/app/api/search-index/route.ts"

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_public_routes,node_home_sections,node_project_browse,node_case_studies,node_search,node_contact toneBlue
class node_blog_browse,node_block_rendering,node_editor toneAmber
class node_admin_routes,node_admin_auth,node_admin_content,node_media,node_taxonomy,node_site_settings toneMint
class node_firestore,node_firebase_client,node_public_data,node_seo,node_i18n,node_search_api,node_firebase_auth_service,node_firebase_storage_service toneRose
class node_nature_component,node_nature_engine,node_scene_manager,node_quality,node_scenes,node_visitor,node_administrator toneIndigo
```

## Components

### Public experience

- [Locale routes](https://github.com/imran-s-project/newlook/tree/main/src/app/(site)/%5Blocale%5D): `src/app/(site)/[locale]`
- [Portfolio home](https://github.com/imran-s-project/newlook/blob/main/src/app/(site)/%5Blocale%5D/page.tsx): `src/app/(site)/[locale]/page.tsx`
- [Project browsing](https://github.com/imran-s-project/newlook/blob/main/src/components/projects/ProjectExplorer.tsx): `src/components/projects/ProjectExplorer.tsx`
- [Case studies](https://github.com/imran-s-project/newlook/blob/main/src/components/projects/CaseStudy.tsx): `src/components/projects/CaseStudy.tsx`
- [Site search](https://github.com/imran-s-project/newlook/blob/main/src/components/search/CommandPalette.tsx): `src/components/search/CommandPalette.tsx`
- [Contact form](https://github.com/imran-s-project/newlook/blob/main/src/components/contact/ContactForm.tsx): `src/components/contact/ContactForm.tsx`

### Content platform

- [Blog reading](https://github.com/imran-s-project/newlook/tree/main/src/app/(site)/%5Blocale%5D/blog): `src/app/(site)/[locale]/blog`
- [Block rendering](https://github.com/imran-s-project/newlook/blob/main/src/components/blog/BlockRenderer.tsx): `src/components/blog/BlockRenderer.tsx`
- [Block editor](https://github.com/imran-s-project/newlook/blob/main/src/features/editor/BlockEditor.tsx): `src/features/editor/BlockEditor.tsx`

### Administration

- [Admin dashboard](https://github.com/imran-s-project/newlook/tree/main/src/app/(admin)/admin/(panel)): `src/app/(admin)/admin/(panel)`
- [Admin authentication](https://github.com/imran-s-project/newlook/blob/main/src/features/admin/auth.tsx): `src/features/admin/auth.tsx`
- [Content management](https://github.com/imran-s-project/newlook/blob/main/src/features/admin/data.ts): `src/features/admin/data.ts`
- [Media library](https://github.com/imran-s-project/newlook/blob/main/src/features/admin/media.ts): `src/features/admin/media.ts`
- [Taxonomy manager](https://github.com/imran-s-project/newlook/blob/main/src/features/admin/TaxonomyManager.tsx): `src/features/admin/TaxonomyManager.tsx`
- [Site settings](https://github.com/imran-s-project/newlook/blob/main/src/features/admin/settings.ts): `src/features/admin/settings.ts`

### Platform services

- **Firestore**
- [Firebase client](https://github.com/imran-s-project/newlook/blob/main/src/lib/firebase/client.ts): `src/lib/firebase/client.ts`
- [Public data access](https://github.com/imran-s-project/newlook/blob/main/src/lib/firestore/public.ts): `src/lib/firestore/public.ts`
- [SEO metadata](https://github.com/imran-s-project/newlook/blob/main/src/lib/seo/metadata.ts): `src/lib/seo/metadata.ts`
- [Translations](https://github.com/imran-s-project/newlook/blob/main/src/i18n/locales.ts): `src/i18n/locales.ts`
- [Search index API](https://github.com/imran-s-project/newlook/blob/main/src/app/api/search-index/route.ts): `src/app/api/search-index/route.ts`
- **Firebase Auth**
- **Firebase Storage**

### Nature engine

- [Nature background](https://github.com/imran-s-project/newlook/blob/main/src/components/nature/NatureBackground.tsx): `src/components/nature/NatureBackground.tsx`
- [Engine coordinator](https://github.com/imran-s-project/newlook/blob/main/src/lib/nature/engine.ts): `src/lib/nature/engine.ts`
- [Scene manager](https://github.com/imran-s-project/newlook/blob/main/src/lib/nature/scene-manager.ts): `src/lib/nature/scene-manager.ts`
- [Quality profiling](https://github.com/imran-s-project/newlook/blob/main/src/lib/nature/quality.ts): `src/lib/nature/quality.ts`
- [Scene definitions](https://github.com/imran-s-project/newlook/blob/main/src/data/scenes.ts): `src/data/scenes.ts`

### Other components

- **Visitor**
- **Administrator**

## Connections

- Visitor → Locale routes: visits (evidence: `README.md`)
- Locale routes → Portfolio home: renders (evidence: `src/app/(site)/[locale]/page.tsx`)
- Portfolio home → Public data access: loads settings (evidence: `src/app/(site)/[locale]/page.tsx`)
- Portfolio home → Project browsing: shows projects (evidence: `README.md`)
- Visitor → Project browsing: browses (evidence: `README.md`)
- Project browsing → Case studies: opens study (evidence: `README.md`)
- Visitor → Blog reading: reads posts (evidence: `README.md`)
- Blog reading → Block rendering: renders blocks (evidence: `README.md`)
- Visitor → Site search: searches (evidence: `README.md`)
- Site search → Search index API: fetches index (evidence: `src/components/search/CommandPalette.tsx`)
- Search index API → Public data access: gets public content (evidence: `src/app/api/search-index/route.ts`)
- Visitor → Contact form: sends message (evidence: `README.md`)
- Administrator → Admin dashboard: manages site (evidence: `README.md`)
- Admin dashboard → Admin authentication: checks access (evidence: `README.md`)
- Admin authentication → Firebase client: gets clients (evidence: `src/features/admin/auth.tsx`)
- Admin authentication → Firebase Auth: authenticates (evidence: `src/features/admin/auth.tsx`)
- Admin authentication → Firestore: checks profile (evidence: `src/features/admin/auth.tsx`)
- Admin dashboard → Content management: manages posts (evidence: `README.md`)
- Content management → Block editor: edits blocks (evidence: `src/app/(admin)/admin/(panel)/posts/[id]/page.tsx`)
- Admin dashboard → Taxonomy manager: manages taxonomy (evidence: `README.md`)
- Taxonomy manager → Firestore: reads and writes (evidence: `src/features/admin/TaxonomyManager.tsx`)
- Admin dashboard → Media library: manages media (evidence: `README.md`)
- Media library → Firebase Storage: stores uploads (evidence: `README.md`)
- Admin dashboard → Site settings: configures site (evidence: `README.md`)
- Firebase client → Firestore: initializes client (evidence: `src/lib/firebase/client.ts`)
- Public data access → Firestore: reads content (evidence: `README.md`)
- Locale routes → SEO metadata: creates metadata (evidence: `src/app/(site)/[locale]/page.tsx`)
- Locale routes → Translations: validates locale (evidence: `src/app/(site)/[locale]/page.tsx`)
- Visitor → Nature background: views ambience (evidence: `README.md`)
- Nature background → Engine coordinator: loads engine
- Engine coordinator → Scene manager: coordinates scenes (evidence: `src/lib/nature/engine.ts`)
- Engine coordinator → Quality profiling: profiles device (evidence: `src/lib/nature/engine.ts`)
- Engine coordinator → Scene definitions: uses definitions (evidence: `src/lib/nature/engine.ts`)
- Scene manager → Quality profiling: adapts playback (evidence: `src/lib/nature/scene-manager.ts`)
