# nzube123/business-os architecture

> Architecture diagram of the GitHub repository nzube123/business-os, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nzube123/business-os
- Repository: https://github.com/nzube123/business-os

## Overview

Business OS is an architecture proposal for a multi-tenant SME operations platform, but the README says application code and endpoints are not yet implemented. The repository currently includes a Next.js marketing site: visitors view a composed landing page, explore its capability and AI messaging, and can navigate to a blog route. The operations, customer portal, AI, and infrastructure stages below are documented product intent, not running subsystems. Source excerpts establish the landing-page composition and theme wiring; other implementation relationships are not shown.

Main entry points: [`apps/web/app/(landing)/page.tsx`](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/page.tsx) (Marketing site), [`README.md`](https://github.com/nzube123/business-os/blob/main/README.md) (Business OS), [`apps/web/app/(landing)/_components/sections/navbar.tsx`](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/navbar.tsx) (Navigation), [`docs/ARCHITECTURE.md`](https://github.com/nzube123/business-os/blob/main/docs/ARCHITECTURE.md) (Business operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_proposal["Documented product"]
  node_product["Business OS<br/>[README.md]"]
  node_operations["Business operations<br/>[ARCHITECTURE.md]"]
  node_ai["AI assistant<br/>[ARCHITECTURE.md]"]
  node_customer["Customer portal<br/>[ARCHITECTURE.md]"]
end

subgraph group_web["Marketing website"]
  node_webapp["Marketing site<br/>[page.tsx]"]
  node_navbar["Navigation<br/>[navbar.tsx]"]
  node_hero["Hero section<br/>[hero.tsx]"]
  node_workflow["Workflow section<br/>[workflow.tsx]"]
  node_challenges["Challenges section<br/>[challenges.tsx]"]
  node_capabilities["Capabilities section<br/>[capabilities.tsx]"]
  node_preview["Product preview"]
  node_ai_section["AI section<br/>[ai-section.tsx]"]
  node_cta["Call to action<br/>[cta.tsx]"]
  node_footer["Footer<br/>[footer.tsx]"]
  node_theme_provider["Theme provider<br/>[ThemeProvider.tsx]"]
  node_theme_toggle["Theme toggle<br/>[ThemeToggle.tsx]"]
end

subgraph group_blog["Blog surface"]
  node_blog_page["Blog page<br/>[page.tsx]"]
  node_blog_api["Blog API route<br/>[route.ts]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"visits"| node_webapp
node_webapp -->|"renders"| node_navbar
node_webapp -->|"renders"| node_hero
node_webapp -->|"renders"| node_workflow
node_webapp -->|"renders"| node_challenges
node_webapp -->|"renders"| node_capabilities
node_webapp -->|"renders"| node_preview
node_webapp -->|"renders"| node_ai_section
node_webapp -->|"renders"| node_cta
node_webapp -->|"renders"| node_footer
node_navbar -->|"renders"| node_theme_toggle
node_webapp -->|"wraps"| node_theme_provider
node_product -->|"includes"| node_operations
node_product -->|"includes"| node_ai
node_product -->|"includes"| node_customer

click node_product "https://github.com/nzube123/business-os/blob/main/README.md"
click node_operations "https://github.com/nzube123/business-os/blob/main/docs/ARCHITECTURE.md"
click node_ai "https://github.com/nzube123/business-os/blob/main/docs/ARCHITECTURE.md"
click node_customer "https://github.com/nzube123/business-os/blob/main/docs/ARCHITECTURE.md"
click node_webapp "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/page.tsx"
click node_navbar "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/navbar.tsx"
click node_hero "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/hero.tsx"
click node_workflow "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/workflow.tsx"
click node_challenges "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/challenges.tsx"
click node_capabilities "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/capabilities.tsx"
click node_preview "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/product-preview.tsx"
click node_ai_section "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/ai-section.tsx"
click node_cta "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/cta.tsx"
click node_footer "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/footer.tsx"
click node_theme_provider "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/ThemeProvider.tsx"
click node_theme_toggle "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/ThemeToggle.tsx"
click node_blog_page "https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/blog/page.tsx"
click node_blog_api "https://github.com/nzube123/business-os/blob/main/apps/web/app/api/blog/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_product,node_operations,node_ai,node_customer toneBlue
class node_webapp,node_navbar,node_hero,node_workflow,node_challenges,node_capabilities,node_preview,node_ai_section,node_cta,node_footer,node_theme_provider,node_theme_toggle toneAmber
class node_blog_page,node_blog_api toneMint
class node_visitor toneIndigo
```

## Components

### Documented product

- [Business OS](https://github.com/nzube123/business-os/blob/main/README.md): `README.md`
- [Business operations](https://github.com/nzube123/business-os/blob/main/docs/ARCHITECTURE.md): `docs/ARCHITECTURE.md`
- [AI assistant](https://github.com/nzube123/business-os/blob/main/docs/ARCHITECTURE.md): `docs/ARCHITECTURE.md`
- [Customer portal](https://github.com/nzube123/business-os/blob/main/docs/ARCHITECTURE.md): `docs/ARCHITECTURE.md`

### Marketing website

- [Marketing site](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/page.tsx): `apps/web/app/(landing)/page.tsx`
- [Navigation](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/navbar.tsx): `apps/web/app/(landing)/_components/sections/navbar.tsx`
- [Hero section](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/hero.tsx): `apps/web/app/(landing)/_components/sections/hero.tsx`
- [Workflow section](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/workflow.tsx): `apps/web/app/(landing)/_components/sections/workflow.tsx`
- [Challenges section](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/challenges.tsx): `apps/web/app/(landing)/_components/sections/challenges.tsx`
- [Capabilities section](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/capabilities.tsx): `apps/web/app/(landing)/_components/sections/capabilities.tsx`
- [Product preview](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/product-preview.tsx): `apps/web/app/(landing)/_components/sections/product-preview.tsx`
- [AI section](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/ai-section.tsx): `apps/web/app/(landing)/_components/sections/ai-section.tsx`
- [Call to action](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/cta.tsx): `apps/web/app/(landing)/_components/sections/cta.tsx`
- [Footer](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/sections/footer.tsx): `apps/web/app/(landing)/_components/sections/footer.tsx`
- [Theme provider](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/ThemeProvider.tsx): `apps/web/app/(landing)/_components/ThemeProvider.tsx`
- [Theme toggle](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/_components/ThemeToggle.tsx): `apps/web/app/(landing)/_components/ThemeToggle.tsx`

### Blog surface

- [Blog page](https://github.com/nzube123/business-os/blob/main/apps/web/app/(landing)/blog/page.tsx): `apps/web/app/(landing)/blog/page.tsx`
- [Blog API route](https://github.com/nzube123/business-os/blob/main/apps/web/app/api/blog/route.ts): `apps/web/app/api/blog/route.ts`

### Other components

- **Site visitor**

## Connections

- Site visitor → Marketing site: visits (evidence: `README.md`)
- Marketing site → Navigation: renders (evidence: `apps/web/app/(landing)/page.tsx`)
- Marketing site → Hero section: renders (evidence: `apps/web/app/(landing)/page.tsx`)
- Marketing site → Workflow section: renders (evidence: `apps/web/app/(landing)/page.tsx`)
- Marketing site → Challenges section: renders (evidence: `apps/web/app/(landing)/page.tsx`)
- Marketing site → Capabilities section: renders (evidence: `apps/web/app/(landing)/page.tsx`)
- Marketing site → Product preview: renders (evidence: `apps/web/app/(landing)/page.tsx`)
- Marketing site → AI section: renders (evidence: `apps/web/app/(landing)/page.tsx`)
- Marketing site → Call to action: renders (evidence: `apps/web/app/(landing)/page.tsx`)
- Marketing site → Footer: renders (evidence: `apps/web/app/(landing)/page.tsx`)
- Navigation → Theme toggle: renders (evidence: `apps/web/app/(landing)/_components/sections/navbar.tsx`)
- Marketing site → Theme provider: wraps
- Business OS → Business operations: includes (evidence: `README.md`)
- Business OS → AI assistant: includes (evidence: `README.md`)
- Business OS → Customer portal: includes (evidence: `README.md`)