# thummalamani567-dot/aetrix_ai architecture

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

- Interactive diagram: https://gitdiagram.com/thummalamani567-dot/aetrix_ai
- Repository: https://github.com/thummalamani567-dot/aetrix_ai

## Overview

Aetrix AI is a browser-based AI workspace combining chat, specialized tools, account features, and user-managed content. The main user workflow enters the routed workspace, starts or manages a conversation, and can navigate to tools and saved-content areas. App.tsx is the visible UI orchestrator; login and signup use Supabase authentication when configured. The excerpts do not establish how chat requests reach an AI service or how projects and library items are persisted, so those connections are omitted. server.ts is substantial, but its behavior was not excerpted.

Main entry points: [`src/App.tsx`](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/App.tsx) (App routing), [`src/components/AetrixLogin.tsx`](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixLogin.tsx) (Sign in), [`src/components/AetrixSignUp.tsx`](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixSignUp.tsx) (Sign up), [`src/components/AetrixFeaturesPage.tsx`](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixFeaturesPage.tsx) (Features catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace and navigation"]
  node_app["App routing<br/>[App.tsx]"]
  node_chat["Chat workspace"]
  node_features["Features catalog"]
  node_projects["Projects<br/>[AetrixProjects.tsx]"]
  node_library["Saved library<br/>[AetrixLibrary.tsx]"]
end

subgraph group_tools["AI tools"]
  node_toolpages["Tool experiences"]
end

subgraph group_account["Account and preferences"]
  node_login["Sign in<br/>[AetrixLogin.tsx]"]
  node_signup["Sign up<br/>[AetrixSignUp.tsx]"]
  node_profile["Profile<br/>[AetrixProfile.tsx]"]
  node_settings["Settings<br/>[AetrixSettings.tsx]"]
end

subgraph group_services["Runtime services and presentation"]
  node_supabase_client["Supabase client<br/>[supabase.ts]"]
  node_supabase[("Supabase service")]
  node_server["Server runtime<br/>[server.ts]"]
  node_toast["Toast notifications<br/>[Toast.tsx]"]
  node_logo["Brand logo<br/>[AetrixLogo.tsx]"]
  node_spacebg["Space background"]
  node_backgroundfx["Background effects"]
end

node_user(("User"))
node_features_actor(("Tool discovery"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_chat
node_app -->|"routes to"| node_features
node_app -->|"routes to"| node_projects
node_app -->|"routes to"| node_library
node_app -->|"routes to"| node_toolpages
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_signup
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_settings
node_login -->|"authenticates via"| node_supabase_client
node_signup -->|"checks configuration"| node_supabase_client
node_supabase_client -.->|"connects to"| node_supabase
node_features_actor -->|"explores tools"| node_features
node_app -->|"renders"| node_toast
node_login -->|"renders"| node_logo
node_signup -->|"renders"| node_logo
node_library -->|"renders"| node_logo
node_features -->|"renders"| node_spacebg
node_toolpages -->|"renders"| node_spacebg

click node_app "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/App.tsx"
click node_chat "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixChatWorkspace.tsx"
click node_features "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixFeaturesPage.tsx"
click node_projects "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixProjects.tsx"
click node_library "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixLibrary.tsx"
click node_toolpages "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixToolPages.tsx"
click node_login "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixLogin.tsx"
click node_signup "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixSignUp.tsx"
click node_profile "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixProfile.tsx"
click node_settings "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixSettings.tsx"
click node_supabase_client "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/supabase.ts"
click node_server "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/server.ts"
click node_toast "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/Toast.tsx"
click node_logo "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixLogo.tsx"
click node_spacebg "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/PremiumSpaceBackground.tsx"
click node_backgroundfx "https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/BackgroundEffects.tsx"

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_app,node_chat,node_features,node_projects,node_library,node_user toneBlue
class node_toolpages toneAmber
class node_login,node_signup,node_profile,node_settings toneMint
class node_supabase_client,node_supabase,node_server,node_toast,node_logo,node_spacebg,node_backgroundfx toneRose
class node_features_actor toneIndigo
```

## Components

### Workspace and navigation

- [App routing](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/App.tsx): `src/App.tsx`
- [Chat workspace](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixChatWorkspace.tsx): `src/components/AetrixChatWorkspace.tsx`
- [Features catalog](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixFeaturesPage.tsx): `src/components/AetrixFeaturesPage.tsx`
- [Projects](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixProjects.tsx): `src/components/AetrixProjects.tsx`
- [Saved library](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixLibrary.tsx): `src/components/AetrixLibrary.tsx`

### AI tools

- [Tool experiences](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixToolPages.tsx): `src/components/AetrixToolPages.tsx`

### Account and preferences

- [Sign in](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixLogin.tsx): `src/components/AetrixLogin.tsx`
- [Sign up](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixSignUp.tsx): `src/components/AetrixSignUp.tsx`
- [Profile](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixProfile.tsx): `src/components/AetrixProfile.tsx`
- [Settings](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixSettings.tsx): `src/components/AetrixSettings.tsx`

### Runtime services and presentation

- [Supabase client](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/supabase.ts): `src/supabase.ts`
- **Supabase service**
- [Server runtime](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/server.ts): `server.ts`
- [Toast notifications](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/Toast.tsx): `src/components/Toast.tsx`
- [Brand logo](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/AetrixLogo.tsx): `src/components/AetrixLogo.tsx`
- [Space background](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/PremiumSpaceBackground.tsx): `src/components/PremiumSpaceBackground.tsx`
- [Background effects](https://github.com/thummalamani567-dot/aetrix_ai/blob/main/src/components/BackgroundEffects.tsx): `src/components/BackgroundEffects.tsx`

### Other components

- **User**
- **Tool discovery**

## Connections

- User → App routing: uses
- App routing → Chat workspace: routes to (evidence: `src/App.tsx`)
- App routing → Features catalog: routes to (evidence: `src/App.tsx`)
- App routing → Projects: routes to (evidence: `src/App.tsx`)
- App routing → Saved library: routes to (evidence: `src/App.tsx`)
- App routing → Tool experiences: routes to (evidence: `src/App.tsx`)
- App routing → Sign in: routes to (evidence: `src/App.tsx`)
- App routing → Sign up: routes to (evidence: `src/App.tsx`)
- App routing → Profile: routes to (evidence: `src/App.tsx`)
- App routing → Settings: routes to (evidence: `src/App.tsx`)
- Sign in → Supabase client: authenticates via (evidence: `src/components/AetrixLogin.tsx`)
- Sign up → Supabase client: checks configuration (evidence: `src/components/AetrixSignUp.tsx`)
- Supabase client → Supabase service: connects to
- Tool discovery → Features catalog: explores tools (evidence: `src/components/AetrixFeaturesPage.tsx`)
- App routing → Toast notifications: renders (evidence: `src/App.tsx`)
- Sign in → Brand logo: renders (evidence: `src/components/AetrixLogin.tsx`)
- Sign up → Brand logo: renders (evidence: `src/components/AetrixSignUp.tsx`)
- Saved library → Brand logo: renders (evidence: `src/components/AetrixLibrary.tsx`)
- Features catalog → Space background: renders (evidence: `src/components/AetrixFeaturesPage.tsx`)
- Tool experiences → Space background: renders (evidence: `src/components/AetrixToolPages.tsx`)