# danestimbal/fiatjournal architecture

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

- Interactive diagram: https://gitdiagram.com/danestimbal/fiatjournal
- Repository: https://github.com/danestimbal/fiatjournal

## Overview

Fiat Journal is a user-authenticated journaling and reflection workspace. Users sign in, organize and edit notes, optionally use Gemini for conversational reflection and session synthesis, and save sessions to Firestore; exports, sharing, storage choices, and tier limits extend that workflow. The app also provides public information pages and an admin console for plans, users, announcements, and support. The graph combines sampled call/import evidence with README-documented service behavior; unsampled feature details and links are omitted where evidence is insufficient.

Main entry points: [`src/App.tsx`](https://github.com/danestimbal/fiatjournal/blob/main/src/App.tsx) (App Coordinator), [`src/lib/firebase.ts`](https://github.com/danestimbal/fiatjournal/blob/main/src/lib/firebase.ts) (Firebase Services), [`src/components/admin/AdminPanel.tsx`](https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/AdminPanel.tsx) (Admin Console), [`src/components/NoteEditorPane.tsx`](https://github.com/danestimbal/fiatjournal/blob/main/src/components/NoteEditorPane.tsx) (Note Editor)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_journal["Journaling Workspace"]
  node_app["App Coordinator<br/>[App.tsx]"]
  node_auth["Sign-In Modal<br/>[AuthModal.tsx]"]
  node_vault["Vault Navigator<br/>[VaultNavigator.tsx]"]
  node_note_list["Note List<br/>[NoteListPane.tsx]"]
  node_editor["Note Editor<br/>[NoteEditorPane.tsx]"]
  node_markdown["Markdown Editor"]
  node_copilot["Gemini Copilot"]
  node_limits["Tier Limits<br/>[tierLimits.ts]"]
  node_exports["Export Utilities<br/>[exportUtils.ts]"]
  node_templates["Journal Templates"]
  node_storage_settings["Storage Settings"]
end

subgraph group_services["Identity and Services"]
  node_firebase["Firebase Services<br/>[firebase.ts]"]
  node_firestore[("Cloud Firestore")]
  node_firebase_auth["Firebase Authentication"]
  node_gemini_api["Gemini API Client<br/>[geminiApi.ts]"]
  node_backend["Express API Proxy<br/>[server.ts]"]
  node_gemini["Gemini Service"]
  node_drive[("Google Drive")]
end

subgraph group_public["Public Experience"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_landing["Landing Page<br/>[LandingPage.tsx]"]
  node_public_reader["Public Note Reader"]
  node_pages["Public Pages"]
  node_support_modal["Support Intake<br/>[SupportModal.tsx]"]
end

subgraph group_admin["Administration"]
  node_admin_panel["Admin Console<br/>[AdminPanel.tsx]"]
  node_admin_users["User Management"]
  node_admin_subscriptions["Subscription Admin"]
  node_admin_public["Public Pages Admin"]
  node_admin_announcements["Announcement Admin"]
  node_admin_support["Support Admin<br/>[SupportTab.tsx]"]
end

node_user(("Journal User"))

node_user -->|"uses"| node_app
node_app -->|"opens"| node_auth
node_auth -->|"authenticates with"| node_firebase
node_firebase -->|"signs in through"| node_firebase_auth
node_app -->|"saves sessions"| node_firebase
node_firebase -->|"reads and writes"| node_firestore
node_app -->|"renders"| node_vault
node_app -->|"renders"| node_note_list
node_app -->|"renders"| node_editor
node_editor -->|"uses"| node_markdown
node_editor -->|"exports vault"| node_exports
node_app -->|"renders"| node_copilot
node_app -->|"requests reflection"| node_gemini_api
node_gemini_api -.->|"calls proxy"| node_backend
node_backend -->|"forwards requests"| node_gemini
node_backend -->|"summarizes sessions"| node_gemini
node_app -.->|"checks tier"| node_limits
node_app -.->|"opens"| node_templates
node_app -.->|"opens"| node_storage_settings
node_storage_settings -->|"connects account"| node_firebase
node_storage_settings -.->|"syncs notes"| node_drive
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_landing
node_app -->|"renders"| node_public_reader
node_navbar -.->|"navigates"| node_pages
node_app -->|"renders for admins"| node_admin_panel
node_admin_panel -->|"shows tab"| node_admin_users
node_admin_panel -->|"shows tab"| node_admin_subscriptions
node_admin_panel -->|"shows tab"| node_admin_public
node_admin_panel -->|"shows tab"| node_admin_announcements
node_admin_panel -->|"shows tab"| node_admin_support
node_app -.->|"opens"| node_support_modal
node_support_modal -.->|"submits ticket"| node_firebase
node_admin_public -->|"updates submission"| node_firebase

click node_app "https://github.com/danestimbal/fiatjournal/blob/main/src/App.tsx"
click node_auth "https://github.com/danestimbal/fiatjournal/blob/main/src/components/AuthModal.tsx"
click node_vault "https://github.com/danestimbal/fiatjournal/blob/main/src/components/VaultNavigator.tsx"
click node_note_list "https://github.com/danestimbal/fiatjournal/blob/main/src/components/NoteListPane.tsx"
click node_editor "https://github.com/danestimbal/fiatjournal/blob/main/src/components/NoteEditorPane.tsx"
click node_markdown "https://github.com/danestimbal/fiatjournal/blob/main/src/components/LiveMarkdownEditor.tsx"
click node_copilot "https://github.com/danestimbal/fiatjournal/blob/main/src/components/GeminiCopilotPane.tsx"
click node_limits "https://github.com/danestimbal/fiatjournal/blob/main/src/lib/tierLimits.ts"
click node_exports "https://github.com/danestimbal/fiatjournal/blob/main/src/lib/exportUtils.ts"
click node_templates "https://github.com/danestimbal/fiatjournal/blob/main/src/components/JournalTemplateModal.tsx"
click node_firebase "https://github.com/danestimbal/fiatjournal/blob/main/src/lib/firebase.ts"
click node_gemini_api "https://github.com/danestimbal/fiatjournal/blob/main/src/lib/geminiApi.ts"
click node_backend "https://github.com/danestimbal/fiatjournal/blob/main/server.ts"
click node_storage_settings "https://github.com/danestimbal/fiatjournal/blob/main/src/components/StorageSettingsModal.tsx"
click node_navbar "https://github.com/danestimbal/fiatjournal/blob/main/src/components/Navbar.tsx"
click node_landing "https://github.com/danestimbal/fiatjournal/blob/main/src/components/LandingPage.tsx"
click node_public_reader "https://github.com/danestimbal/fiatjournal/blob/main/src/components/PublicNoteReader.tsx"
click node_pages "https://github.com/danestimbal/fiatjournal/tree/main/src/components/pages"
click node_admin_panel "https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/AdminPanel.tsx"
click node_admin_users "https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/UserManagementTab.tsx"
click node_admin_subscriptions "https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/SubscriptionsTab.tsx"
click node_admin_public "https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/PublicPagesAdminTab.tsx"
click node_admin_announcements "https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/AnnouncementsTab.tsx"
click node_admin_support "https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/SupportTab.tsx"
click node_support_modal "https://github.com/danestimbal/fiatjournal/blob/main/src/components/SupportModal.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_auth,node_vault,node_note_list,node_editor,node_markdown,node_copilot,node_limits,node_exports,node_templates,node_storage_settings,node_user toneBlue
class node_firebase,node_firestore,node_firebase_auth,node_gemini_api,node_backend,node_gemini,node_drive toneAmber
class node_navbar,node_landing,node_public_reader,node_pages,node_support_modal toneMint
class node_admin_panel,node_admin_users,node_admin_subscriptions,node_admin_public,node_admin_announcements,node_admin_support toneRose
```

## Components

### Journaling Workspace

- [App Coordinator](https://github.com/danestimbal/fiatjournal/blob/main/src/App.tsx): `src/App.tsx`
- [Sign-In Modal](https://github.com/danestimbal/fiatjournal/blob/main/src/components/AuthModal.tsx): `src/components/AuthModal.tsx`
- [Vault Navigator](https://github.com/danestimbal/fiatjournal/blob/main/src/components/VaultNavigator.tsx): `src/components/VaultNavigator.tsx`
- [Note List](https://github.com/danestimbal/fiatjournal/blob/main/src/components/NoteListPane.tsx): `src/components/NoteListPane.tsx`
- [Note Editor](https://github.com/danestimbal/fiatjournal/blob/main/src/components/NoteEditorPane.tsx): `src/components/NoteEditorPane.tsx`
- [Markdown Editor](https://github.com/danestimbal/fiatjournal/blob/main/src/components/LiveMarkdownEditor.tsx): `src/components/LiveMarkdownEditor.tsx`
- [Gemini Copilot](https://github.com/danestimbal/fiatjournal/blob/main/src/components/GeminiCopilotPane.tsx): `src/components/GeminiCopilotPane.tsx`
- [Tier Limits](https://github.com/danestimbal/fiatjournal/blob/main/src/lib/tierLimits.ts): `src/lib/tierLimits.ts`
- [Export Utilities](https://github.com/danestimbal/fiatjournal/blob/main/src/lib/exportUtils.ts): `src/lib/exportUtils.ts`
- [Journal Templates](https://github.com/danestimbal/fiatjournal/blob/main/src/components/JournalTemplateModal.tsx): `src/components/JournalTemplateModal.tsx`
- [Storage Settings](https://github.com/danestimbal/fiatjournal/blob/main/src/components/StorageSettingsModal.tsx): `src/components/StorageSettingsModal.tsx`

### Identity and Services

- [Firebase Services](https://github.com/danestimbal/fiatjournal/blob/main/src/lib/firebase.ts): `src/lib/firebase.ts`
- **Cloud Firestore**
- **Firebase Authentication**
- [Gemini API Client](https://github.com/danestimbal/fiatjournal/blob/main/src/lib/geminiApi.ts): `src/lib/geminiApi.ts`
- [Express API Proxy](https://github.com/danestimbal/fiatjournal/blob/main/server.ts): `server.ts`
- **Gemini Service**
- **Google Drive**

### Public Experience

- [Navigation](https://github.com/danestimbal/fiatjournal/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Landing Page](https://github.com/danestimbal/fiatjournal/blob/main/src/components/LandingPage.tsx): `src/components/LandingPage.tsx`
- [Public Note Reader](https://github.com/danestimbal/fiatjournal/blob/main/src/components/PublicNoteReader.tsx): `src/components/PublicNoteReader.tsx`
- [Public Pages](https://github.com/danestimbal/fiatjournal/tree/main/src/components/pages): `src/components/pages`
- [Support Intake](https://github.com/danestimbal/fiatjournal/blob/main/src/components/SupportModal.tsx): `src/components/SupportModal.tsx`

### Administration

- [Admin Console](https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/AdminPanel.tsx): `src/components/admin/AdminPanel.tsx`
- [User Management](https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/UserManagementTab.tsx): `src/components/admin/UserManagementTab.tsx`
- [Subscription Admin](https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/SubscriptionsTab.tsx): `src/components/admin/SubscriptionsTab.tsx`
- [Public Pages Admin](https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/PublicPagesAdminTab.tsx): `src/components/admin/PublicPagesAdminTab.tsx`
- [Announcement Admin](https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/AnnouncementsTab.tsx): `src/components/admin/AnnouncementsTab.tsx`
- [Support Admin](https://github.com/danestimbal/fiatjournal/blob/main/src/components/admin/SupportTab.tsx): `src/components/admin/SupportTab.tsx`

### Other components

- **Journal User**

## Connections

- Journal User → App Coordinator: uses (evidence: `README.md`)
- App Coordinator → Sign-In Modal: opens (evidence: `src/App.tsx`)
- Sign-In Modal → Firebase Services: authenticates with (evidence: `src/components/AuthModal.tsx`)
- Firebase Services → Firebase Authentication: signs in through (evidence: `src/lib/firebase.ts`)
- App Coordinator → Firebase Services: saves sessions (evidence: `src/App.tsx`)
- Firebase Services → Cloud Firestore: reads and writes (evidence: `src/lib/firebase.ts`)
- App Coordinator → Vault Navigator: renders (evidence: `src/App.tsx`)
- App Coordinator → Note List: renders (evidence: `src/App.tsx`)
- App Coordinator → Note Editor: renders (evidence: `src/App.tsx`)
- Note Editor → Markdown Editor: uses (evidence: `src/components/NoteEditorPane.tsx`)
- Note Editor → Export Utilities: exports vault (evidence: `src/components/NoteEditorPane.tsx`)
- App Coordinator → Gemini Copilot: renders (evidence: `src/App.tsx`)
- App Coordinator → Gemini API Client: requests reflection (evidence: `src/App.tsx`)
- Gemini API Client → Express API Proxy: calls proxy (evidence: `README.md`)
- Express API Proxy → Gemini Service: forwards requests (evidence: `README.md`)
- Express API Proxy → Gemini Service: summarizes sessions (evidence: `README.md`)
- App Coordinator → Tier Limits: checks tier (evidence: `src/App.tsx`)
- App Coordinator → Journal Templates: opens (evidence: `src/App.tsx`)
- App Coordinator → Storage Settings: opens (evidence: `src/App.tsx`)
- Storage Settings → Firebase Services: connects account (evidence: `src/components/StorageSettingsModal.tsx`)
- Storage Settings → Google Drive: syncs notes
- App Coordinator → Navigation: renders (evidence: `src/App.tsx`)
- App Coordinator → Landing Page: renders (evidence: `src/App.tsx`)
- App Coordinator → Public Note Reader: renders (evidence: `src/App.tsx`)
- Navigation → Public Pages: navigates
- App Coordinator → Admin Console: renders for admins (evidence: `src/App.tsx`)
- Admin Console → User Management: shows tab (evidence: `src/components/admin/AdminPanel.tsx`)
- Admin Console → Subscription Admin: shows tab (evidence: `src/components/admin/AdminPanel.tsx`)
- Admin Console → Public Pages Admin: shows tab (evidence: `src/components/admin/AdminPanel.tsx`)
- Admin Console → Announcement Admin: shows tab (evidence: `src/components/admin/AdminPanel.tsx`)
- Admin Console → Support Admin: shows tab (evidence: `src/components/admin/AdminPanel.tsx`)
- App Coordinator → Support Intake: opens (evidence: `src/App.tsx`)
- Support Intake → Firebase Services: submits ticket
- Public Pages Admin → Firebase Services: updates submission (evidence: `src/components/admin/PublicPagesAdminTab.tsx`)
