How danestimbal/fiatjournal works
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: App.tsx App Coordinator · firebase.ts Firebase Services · AdminPanel.tsx Admin Console · NoteEditorPane.tsx Note Editor
Components 30
Journaling Workspace
- App Coordinator
src/App.tsx - Sign-In Modal
src/components/AuthModal.tsx - Vault Navigator
src/components/VaultNavigator.tsx - Note List
src/components/NoteListPane.tsx - Note Editor
src/components/NoteEditorPane.tsx - Markdown Editor
src/components/LiveMarkdownEditor.tsx - Gemini Copilot
src/components/GeminiCopilotPane.tsx - Tier Limits
src/lib/tierLimits.ts - Export Utilities
src/lib/exportUtils.ts - Journal Templates
src/components/JournalTemplateModal.tsx - Storage Settings
src/components/StorageSettingsModal.tsx
Identity and Services
- Firebase Services
src/lib/firebase.ts - Cloud Firestore
- Firebase Authentication
- Gemini API Client
src/lib/geminiApi.ts - Express API Proxy
server.ts - Gemini Service
- Google Drive
Public Experience
- Navigation
src/components/Navbar.tsx - Landing Page
src/components/LandingPage.tsx - Public Note Reader
src/components/PublicNoteReader.tsx - Public Pages
src/components/pages - Support Intake
src/components/SupportModal.tsx
Administration
- Admin Console
src/components/admin/AdminPanel.tsx - User Management
src/components/admin/UserManagementTab.tsx - Subscription Admin
src/components/admin/SubscriptionsTab.tsx - Public Pages Admin
src/components/admin/PublicPagesAdminTab.tsx - Announcement Admin
src/components/admin/AnnouncementsTab.tsx - Support Admin
src/components/admin/SupportTab.tsx
Other components
- Journal User
Connections 34
- Journal User → App Coordinator: uses
README.md - App Coordinator → Sign-In Modal: opens
src/App.tsx - Sign-In Modal → Firebase Services: authenticates with
src/components/AuthModal.tsx - Firebase Services → Firebase Authentication: signs in through
src/lib/firebase.ts - App Coordinator → Firebase Services: saves sessions
src/App.tsx - Firebase Services → Cloud Firestore: reads and writes
src/lib/firebase.ts - App Coordinator → Vault Navigator: renders
src/App.tsx - App Coordinator → Note List: renders
src/App.tsx - App Coordinator → Note Editor: renders
src/App.tsx - Note Editor → Markdown Editor: uses
src/components/NoteEditorPane.tsx - Note Editor → Export Utilities: exports vault
src/components/NoteEditorPane.tsx - App Coordinator → Gemini Copilot: renders
src/App.tsx - App Coordinator → Gemini API Client: requests reflection
src/App.tsx - Gemini API Client → Express API Proxy: calls proxy
README.md - Express API Proxy → Gemini Service: forwards requests
README.md - Express API Proxy → Gemini Service: summarizes sessions
README.md - App Coordinator → Tier Limits: checks tier
src/App.tsx - App Coordinator → Journal Templates: opens
src/App.tsx - App Coordinator → Storage Settings: opens
src/App.tsx - Storage Settings → Firebase Services: connects account
src/components/StorageSettingsModal.tsx - Storage Settings → Google Drive: syncs notes
- App Coordinator → Navigation: renders
src/App.tsx - App Coordinator → Landing Page: renders
src/App.tsx - App Coordinator → Public Note Reader: renders
src/App.tsx - Navigation → Public Pages: navigates
- App Coordinator → Admin Console: renders for admins
src/App.tsx - Admin Console → User Management: shows tab
src/components/admin/AdminPanel.tsx - Admin Console → Subscription Admin: shows tab
src/components/admin/AdminPanel.tsx - Admin Console → Public Pages Admin: shows tab
src/components/admin/AdminPanel.tsx - Admin Console → Announcement Admin: shows tab
src/components/admin/AdminPanel.tsx - Admin Console → Support Admin: shows tab
src/components/admin/AdminPanel.tsx - App Coordinator → Support Intake: opens
src/App.tsx - Support Intake → Firebase Services: submits ticket
- Public Pages Admin → Firebase Services: updates submission
src/components/admin/PublicPagesAdminTab.tsx