Skip to content

Explore app data layer (@explore subagent)

Field Value
Source Obsidian · Claudian plugin
Session ses_f9e57cccfffe1rq0MvJoIoBzeH
Started 2026-09-02 10:26
Messages 6
Parts 60 (text+patch+tool) · 5 reasoning · 40 tool calls
Model opencode:big-pickle
Directory /home/sambasene/dev/idle-zelus local

Thoroughly explore the app at /home/sambasene/dev/idle-zelus local/. I need to understand:

  1. All files that import from firebase.ts or use Firestore/Firebase functions
  2. How articles (notes) and projects are loaded, created, updated, deleted
  3. The data model for notes, projects, community messages, likes, comments
  4. How the AuthContext works (what user data is used)
  5. How the NotificationContext works
  6. How the Home page loads and displays articles
  7. How the Editor and ProjectEditor pages work
  8. How NoteView and ProjectView work
  9. The vite.config.ts setup

Read ALL these files fully:

  • src/contexts/AuthContext.tsx
  • src/contexts/NotificationContext.tsx
  • src/pages/Home.tsx
  • src/pages/Editor.tsx
  • src/pages/ProjectEditor.tsx
  • src/pages/NoteView.tsx
  • src/pages/ProjectView.tsx
  • src/pages/Admin.tsx
  • src/pages/AdminContent.tsx
  • src/pages/Community.tsx
  • src/components/Comments.tsx
  • src/components/LikeButton.tsx
  • src/components/SearchBar.tsx
  • src/components/Layout.tsx
  • src/components/StartupLoader.tsx
  • src/lib/utils.ts
  • vite.config.ts
  • tsconfig.json
  • TODO.md

For each file, tell me:

  • What Firebase/Firestore operations it performs
  • What data shapes it uses
  • Any external API calls

Return ALL of this information in detail so I can rewrite the data layer.

I’ll start by reading all the requested files in parallel, plus finding all Firebase-related imports.

glob — {"pattern": "src/**/*", "path": "/home/sambasene/dev/idle-zelus local"}

/home/sambasene/dev/idle-zelus local/src/main.tsx
/home/sambasene/dev/idle-zelus local/src/index.css
/home/sambasene/dev/idle-zelus local/src/pages/Profile.tsx
/home/sambasene/dev/idle-zelus local/src/pages/Subscriptions.tsx
/home/sambasene/dev/idle-zelus local/src/pages/NoteView.tsx
/home/sambasene/dev/idle-zelus local/src/pages/ProjectEditor.tsx
/home/sambasene/dev/idle-zelus local/src/pages/ProjectView.tsx
/home/sambasene/dev/idle-zelus local/src/pages/SearchResults.tsx
/home/sambasene/dev/idle-zelus local/src/pages/Notifications.tsx
/home/sambasene/dev/idle-zelus local/src/pages/Community.tsx
/home/sambasene/dev/idle-zelus local/src/pages/AdminContent.tsx
/home/sambasene/dev/idle-zelus l
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/contexts/AuthContext.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/contexts/AuthContext.tsx</path>
<type>file</type>
<content>
1: import React, { createContext, useContext, useEffect, useState } from 'react';
2: import { User, onAuthStateChanged } from 'firebase/auth';
3: import { doc, getDoc, setDoc } from 'firebase/firestore';
4: import { auth, db, handleFirestoreError, OperationType } from '../firebase';
5:
6: interface AuthContextType {
7: user: User | null;
8: isAdmin: boolean;
9: loading: boolean;
10: }
11:
12: const AuthContext = createContext<AuthContextType>({
13: user: null,
14: isAdmin: false,
15: loading: true,
16: });
17:
18: export const useAuth = () => useContext(AuthContext);
19:
20: export
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/contexts/NotificationContext.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/contexts/NotificationContext.tsx</path>
<type>file</type>
<content>
1: import React, { createContext, useContext, useEffect, useState, useRef } from 'react';
2: import { collection, query, onSnapshot, where, addDoc, serverTimestamp, getDocs, orderBy } from 'firebase/firestore';
3: import { db, auth, handleFirestoreError, OperationType } from '../firebase';
4: import { useAuth } from './AuthContext';
5:
6: interface NotificationContextType {
7: unreadCount: number;
8: playPublishSound: () => void;
9: requestNotificationPermission: () => Promise<void>;
10: }
11:
12: const NotificationContext = createContext<NotificationContextType>({
13: unreadC
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/Home.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/Home.tsx</path>
<type>file</type>
<content>
1: import { useEffect, useState, useMemo } from 'react';
2: import { collection, query, where, onSnapshot, orderBy } from 'firebase/firestore';
3: import { db, handleFirestoreError, OperationType } from '../firebase';
4: import { Link } from 'react-router-dom';
5: import { useTheme } from '../contexts/ThemeContext';
6: import { useAuth } from '../contexts/AuthContext';
7: import { Icon } from '../components/Icon';
8: import { motion, AnimatePresence } from 'motion/react';
9:
10: const ITEMS_PER_PAGE = 9;
11:
12: export default function Home() {
13: const [notes, setNotes] = useState<any[]>([]);
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/Editor.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/Editor.tsx</path>
<type>file</type>
<content>
1: import { useEffect, useState, useRef } from 'react';
2: import { useParams, useNavigate } from 'react-router-dom';
3: import { doc, getDoc, setDoc, updateDoc, serverTimestamp, collection, deleteField } from 'firebase/firestore';
4: import { db, auth, handleFirestoreError, OperationType } from '../firebase';
5: import { useAuth } from '../contexts/AuthContext';
6: import { useTheme } from '../contexts/ThemeContext';
7: import { Icon } from '../components/Icon';
8: import ReactMarkdown from 'react-markdown';
9: import remarkGfm from 'remark-gfm';
10: import remarkMath from 'remark-math';
11: i
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/ProjectEditor.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/ProjectEditor.tsx</path>
<type>file</type>
<content>
1: import { useEffect, useState, useRef } from 'react';
2: import { useParams, useNavigate } from 'react-router-dom';
3: import { doc, getDoc, setDoc, updateDoc, serverTimestamp, collection } from 'firebase/firestore';
4: import { db, auth, handleFirestoreError, OperationType } from '../firebase';
5: import { useAuth } from '../contexts/AuthContext';
6: import { useTheme } from '../contexts/ThemeContext';
7: import { Icon } from '../components/Icon';
8: import { CodeBlock } from '../components/CodeBlock';
9: import ReactMarkdown from 'react-markdown';
10: import remarkGfm from 'remark-gf
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/NoteView.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/NoteView.tsx</path>
<type>file</type>
<content>
1: import { useEffect, useState, useRef } from 'react';
2: import { useParams, Link } from 'react-router-dom';
3: import { collection, query, where, getDocs, limit } from 'firebase/firestore';
4: import { db, handleFirestoreError, OperationType } from '../firebase';
5: import { useTheme } from '../contexts/ThemeContext';
6: import ReactMarkdown from 'react-markdown';
7: import remarkGfm from 'remark-gfm';
8: import remarkMath from 'remark-math';
9: import rehypeKatex from 'rehype-katex';
10: import rehypeRaw from 'rehype-raw';
11: import mermaid from 'mermaid';
12: import 'katex/dist/katex.mi
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/ProjectView.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/ProjectView.tsx</path>
<type>file</type>
<content>
1: import { useEffect, useState } from 'react';
2: import { useParams } from 'react-router-dom';
3: import { collection, query, where, getDocs, limit } from 'firebase/firestore';
4: import { db, handleFirestoreError, OperationType } from '../firebase';
5: import ReactMarkdown from 'react-markdown';
6: import remarkGfm from 'remark-gfm';
7: import remarkMath from 'remark-math';
8: import rehypeKatex from 'rehype-katex';
9: import rehypeRaw from 'rehype-raw';
10: import rehypeSlug from 'rehype-slug';
11: import { Icon } from '../components/Icon';
12: import { useAuth } from '../contexts/Auth
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/Admin.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/Admin.tsx</path>
<type>file</type>
<content>
1: import { useState, useEffect } from 'react';
2: import { useSearchParams, useNavigate } from 'react-router-dom';
3: import { useAuth } from '../contexts/AuthContext';
4: import { Icon } from '../components/Icon';
5: import AdminContent from './AdminContent';
6: import AdminUsers from './AdminUsers';
7: import AdminStats from './AdminStats';
8: import AdminBroadcast from './AdminBroadcast';
9:
10: export default function Admin() {
11: const { isAdmin } = useAuth();
12: const navigate = useNavigate();
13: const [searchParams, setSearchParams] = useSearchParams();
14: const tabParam = searchPar
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/AdminContent.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/AdminContent.tsx</path>
<type>file</type>
<content>
1: import { useEffect, useState } from 'react';
2: import { collection, query, onSnapshot, orderBy, deleteDoc, doc } from 'firebase/firestore';
3: import { db, handleFirestoreError, OperationType } from '../firebase';
4: import { Link } from 'react-router-dom';
5: import { Icon } from '../components/Icon';
6:
7: export default function AdminContent() {
8: const [notes, setNotes] = useState<any[]>([]);
9: const [projects, setProjects] = useState<any[]>([]);
10:
11: useEffect(() => {
12: const qNotes = query(collection(db, 'notes'), orderBy('createdAt', 'desc'));
13: const unsubscribeNote
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/Community.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/Community.tsx</path>
<type>file</type>
<content>
1: import { useState, useEffect, useRef } from 'react';
2: import { collection, query, orderBy, onSnapshot, addDoc, serverTimestamp, updateDoc, doc, limit, getDocs, deleteDoc, setDoc } from 'firebase/firestore';
3: import { db, handleFirestoreError, OperationType } from '../firebase';
4: import { useAuth } from '../contexts/AuthContext';
5: import { Icon } from '../components/Icon';
6: import { Link } from 'react-router-dom';
7: import { motion, AnimatePresence } from 'motion/react';
8:
9: const EMOJIS = ['👍', '❤️', '😂', '😮', '😢', '🔥'];
10:
11: export default function Community() {
12: con
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/components/Comments.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/components/Comments.tsx</path>
<type>file</type>
<content>
1: import { useState, useEffect } from 'react';
2: import { collection, query, where, orderBy, onSnapshot, addDoc, serverTimestamp, deleteDoc, doc } from 'firebase/firestore';
3: import { db, handleFirestoreError, OperationType } from '../firebase';
4: import { useAuth } from '../contexts/AuthContext';
5: import { Icon } from './Icon';
6:
7: interface Comment {
8: id: string;
9: targetId: string;
10: userId: string;
11: userName: string;
12: userPhoto: string;
13: content: string;
14: createdAt: any;
15: }
16:
17: export default function Comments({ targetId }: { targetId: string }) {
1
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/components/LikeButton.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/components/LikeButton.tsx</path>
<type>file</type>
<content>
1: import { useState, useEffect } from 'react';
2: import { collection, query, where, onSnapshot, addDoc, deleteDoc, doc, serverTimestamp, getDocs } from 'firebase/firestore';
3: import { db, handleFirestoreError, OperationType } from '../firebase';
4: import { useAuth } from '../contexts/AuthContext';
5: import { Icon } from './Icon';
6: import { motion } from 'motion/react';
7:
8: interface LikeButtonProps {
9: targetId: string;
10: }
11:
12: export function LikeButton({ targetId }: LikeButtonProps) {
13: const [likesCount, setLikesCount] = useState(0);
14: const [hasLiked, setHasL
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/components/SearchBar.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/components/SearchBar.tsx</path>
<type>file</type>
<content>
1: import { useState } from 'react';
2: import { useNavigate } from 'react-router-dom';
3: import { Icon } from './Icon';
4:
5: export function SearchBar() {
6: const [query, setQuery] = useState('');
7: const navigate = useNavigate();
8:
9: const handleSubmit = (e: React.FormEvent) => {
10: e.preventDefault();
11: if (query.trim()) {
12: navigate(`/search?q=${encodeURIComponent(query.trim())}`);
13: }
14: };
15:
16: return (
17: <form onSubmit={handleSubmit} className="relative w-full max-w-md">
18: <input
19: type="text"
20: value={query}
21: onChange={(e) => setQuery(e.target.valu
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/components/Layout.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/components/Layout.tsx</path>
<type>file</type>
<content>
1: import { Outlet, Link, NavLink } from 'react-router-dom';
2: import { useAuth } from '../contexts/AuthContext';
3: import { useTheme } from '../contexts/ThemeContext';
4: import { useNotification } from '../contexts/NotificationContext';
5: import { loginWithGoogle, logout } from '../firebase';
6: import { Icon } from './Icon';
7: import { SearchBar } from './SearchBar';
8: import { useState } from 'react';
9: import SocialAnimation from './SocialAnimation';
10: import { motion } from 'motion/react';
11:
12: export default function Layout() {
13: const { user, isAdmin } = useAuth();
14
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/components/StartupLoader.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/components/StartupLoader.tsx</path>
<type>file</type>
<content>
1: import React, { useEffect } from 'react';
2: import { motion, useAnimation, useMotionValue, useTransform, animate } from 'motion/react';
3:
4: const IMAGES = [
5: 'https://res.cloudinary.com/dkpqkwjgo/image/upload/v1773944038/Kali-dragon-icon_npq3fe.svg',
6: 'https://res.cloudinary.com/dkpqkwjgo/image/upload/v1773944095/Figma-logo_uynf3b.svg',
7: 'https://res.cloudinary.com/dkpqkwjgo/image/upload/v1773944095/Fedora_icon__2021_czzqpw.svg',
8: 'https://res.cloudinary.com/dkpqkwjgo/image/upload/v1773944090/DaVinci_Resolve_Studio_cnqivf.png'
9: ];
10:
11: export default function St
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/lib/utils.ts"}

<path>/home/sambasene/dev/idle-zelus local/src/lib/utils.ts</path>
<type>file</type>
<content>
1: import { clsx, type ClassValue } from "clsx";
2: import { twMerge } from "tailwind-merge";
3:
4: export function cn(...inputs: ClassValue[]) {
5: return twMerge(clsx(inputs));
6: }
(End of file - total 6 lines)
</content>

read — {"filePath": "/home/sambasene/dev/idle-zelus local/vite.config.ts"}

<path>/home/sambasene/dev/idle-zelus local/vite.config.ts</path>
<type>file</type>
<content>
1: import tailwindcss from '@tailwindcss/vite';
2: import react from '@vitejs/plugin-react';
3: import path from 'path';
4: import {defineConfig, loadEnv} from 'vite';
5: import { VitePWA } from 'vite-plugin-pwa';
6:
7: export default defineConfig(({mode}) => {
8: const env = loadEnv(mode, '.', '');
9: return {
10: plugins: [
11: react(),
12: tailwindcss(),
13: VitePWA({
14: registerType: 'autoUpdate',
15: includeAssets: ['favicon.ico', 'apple-touch-icon.png', 'masked-icon.svg'],
16: workbox: {
17: maximumFileSizeToCacheInBytes: 5000000, // 5MB limit
18: globPatterns: ['**/*.{js,css,html,ico,png,sv
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/tsconfig.json"}

<path>/home/sambasene/dev/idle-zelus local/tsconfig.json</path>
<type>file</type>
<content>
1: {
2: "compilerOptions": {
3: "target": "ES2022",
4: "experimentalDecorators": true,
5: "useDefineForClassFields": false,
6: "module": "ESNext",
7: "lib": [
8: "ES2022",
9: "DOM",
10: "DOM.Iterable"
11: ],
12: "skipLibCheck": true,
13: "moduleResolution": "bundler",
14: "isolatedModules": true,
15: "moduleDetection": "force",
16: "allowJs": true,
17: "jsx": "react-jsx",
18: "paths": {
19: "@/*": [
20: "./*"
21: ]
22: },
23: "allowImportingTsExtensions": true,
24: "noEmit": true
25: }
26: }
(End of file - total 26 lines)
</content>

read — {"filePath": "/home/sambasene/dev/idle-zelus local/TODO.md"}

<path>/home/sambasene/dev/idle-zelus local/TODO.md</path>
<type>file</type>
<content>
1: # Liste des Tâches (TODO) - Idle Zelus
2:
3: ## ✅ Tâches Terminées
4:
5: - [x] Configuration initiale du projet (React, Vite, Tailwind CSS).
6: - [x] Intégration de Firebase (Authentification, Firestore).
7: - [x] Système de gestion des thèmes (Bleu pour Samba Sene, Rouge pour Pseudo Man).
8: - [x] Création et édition de notes (Markdown, KaTeX, Mermaid).
9: - [x] Affichage des notes publiées sur la page d'accueil.
10: - [x] Tableau de bord administrateur pour gérer les notes.
11: - [x] Ajout de la section "Projets" avec création, édition et affichage.
12: - [x] Intégration de l'iframe pour prévisualise
…[truncated]

Now let me read the critical firebase.ts, App.tsx, main.tsx, ThemeContext, and remaining files:

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/firebase.ts"}

<path>/home/sambasene/dev/idle-zelus local/src/firebase.ts</path>
<type>file</type>
<content>
1: import { initializeApp } from 'firebase/app';
2: import { getAuth, GoogleAuthProvider, signInWithPopup, signOut } from 'firebase/auth';
3: import { getFirestore } from 'firebase/firestore';
4: import firebaseConfig from '../firebase-applet-config.json';
5:
6: const app = initializeApp(firebaseConfig);
7: export const db = getFirestore(app, firebaseConfig.firestoreDatabaseId);
8: export const auth = getAuth(app);
9: export const googleProvider = new GoogleAuthProvider();
10:
11: export const loginWithGoogle = () => signInWithPopup(auth, googleProvider);
12: export const logout = () => signOut(au
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/App.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/App.tsx</path>
<type>file</type>
<content>
1: import { BrowserRouter, Routes, Route, useLocation } from 'react-router-dom';
2: import { AuthProvider, useAuth } from './contexts/AuthContext';
3: import { ThemeProvider } from './contexts/ThemeContext';
4: import { NotificationProvider } from './contexts/NotificationContext';
5: import { AnimatePresence, motion } from 'motion/react';
6: import Layout from './components/Layout';
7: import Home from './pages/Home';
8: import Admin from './pages/Admin';
9: import Author from './pages/Author';
10: import Editor from './pages/Editor';
11: import ProjectEditor from './pages/ProjectEditor';
12: import Not
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/main.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/main.tsx</path>
<type>file</type>
<content>
1: /// <reference types="vite-plugin-pwa/client" />
2: import {StrictMode} from 'react';
3: import {createRoot} from 'react-dom/client';
4: import App from './App.tsx';
5: import './index.css';
6: import { registerSW } from 'virtual:pwa-register';
7:
8: const updateSW = registerSW({
9: onNeedRefresh() {
10: // Auto update for now since we can't use confirm() in iframe
11: updateSW(true);
12: },
13: onOfflineReady() {
14: console.log('Application prête pour une utilisation hors-ligne.');
15: },
16: });
17:
18: createRoot(document.getElementById('root')!).render(
19: <StrictMode>
20: <App />
21: </Stri
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/contexts/ThemeContext.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/contexts/ThemeContext.tsx</path>
<type>file</type>
<content>
1: import React, { createContext, useContext, useEffect, useState } from 'react';
2:
3: type Theme = 'dark' | 'light';
4: type AuthorTheme = 'blue' | 'red';
5:
6: interface ThemeProviderState {
7: theme: Theme;
8: setTheme: (theme: Theme) => void;
9: authorTheme: AuthorTheme;
10: setAuthorTheme: (theme: AuthorTheme) => void;
11: }
12:
13: const ThemeContext = createContext<ThemeProviderState | undefined>(undefined);
14:
15: export function ThemeProvider({
16: children,
17: defaultTheme = 'light',
18: defaultAuthorTheme = 'blue',
19: }: {
20: children: React.ReactNode;
21: defaultTh
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/SearchResults.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/SearchResults.tsx</path>
<type>file</type>
<content>
1: import { useState, useEffect } from 'react';
2: import { useSearchParams, Link } from 'react-router-dom';
3: import { collection, query, getDocs, where } from 'firebase/firestore';
4: import { db, handleFirestoreError, OperationType } from '../firebase';
5: import { useAuth } from '../contexts/AuthContext';
6: import { Icon } from '../components/Icon';
7:
8: export default function SearchResults() {
9: const [searchParams] = useSearchParams();
10: const q = searchParams.get('q') || '';
11: const [results, setResults] = useState<any[]>([]);
12: const [loading, setLoading] = useState(t
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/Notifications.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/Notifications.tsx</path>
<type>file</type>
<content>
1: import { useEffect, useState } from 'react';
2: import { collection, query, orderBy, onSnapshot, doc, updateDoc, deleteDoc, arrayUnion } from 'firebase/firestore';
3: import { db, handleFirestoreError, OperationType } from '../firebase';
4: import { useAuth } from '../contexts/AuthContext';
5: import { Icon } from '../components/Icon';
6: import { Link } from 'react-router-dom';
7: import ReactMarkdown from 'react-markdown';
8: import remarkGfm from 'remark-gfm';
9: import rehypeRaw from 'rehype-raw';
10:
11: export default function Notifications() {
12: const { user } = useAuth();
1
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/Profile.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/Profile.tsx</path>
<type>file</type>
<content>
1: import { useState, useEffect } from 'react';
2: import { useAuth } from '../contexts/AuthContext';
3: import { doc, getDoc, updateDoc } from 'firebase/firestore';
4: import { db, handleFirestoreError, OperationType } from '../firebase';
5: import { Icon } from '../components/Icon';
6: import { useTheme } from '../contexts/ThemeContext';
7: import { useNotification } from '../contexts/NotificationContext';
8: import Subscriptions from './Subscriptions';
9: import Notifications from './Notifications';
10: import { useSearchParams } from 'react-router-dom';
11:
12: export default function Pro
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/Subscriptions.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/Subscriptions.tsx</path>
<type>file</type>
<content>
1: import { useState, useEffect } from 'react';
2: import { collection, query, onSnapshot, addDoc, deleteDoc, serverTimestamp, getDocs, doc } from 'firebase/firestore';
3: import { db, handleFirestoreError, OperationType } from '../firebase';
4: import { useAuth } from '../contexts/AuthContext';
5: import { Icon } from '../components/Icon';
6:
7: export default function Subscriptions() {
8: const { user } = useAuth();
9: const [subscriptions, setSubscriptions] = useState<any[]>([]);
10: const [availableSubjects, setAvailableSubjects] = useState<string[]>([]);
11: const [loading, setLoad
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/AdminUsers.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/AdminUsers.tsx</path>
<type>file</type>
<content>
1: import { useEffect, useState } from 'react';
2: import { collection, query, onSnapshot, orderBy, updateDoc, doc } from 'firebase/firestore';
3: import { db, handleFirestoreError, OperationType } from '../firebase';
4: import { useAuth } from '../contexts/AuthContext';
5: import { Icon } from '../components/Icon';
6: import { useNavigate } from 'react-router-dom';
7:
8: export default function AdminUsers({ isEmbedded = false }: { isEmbedded?: boolean }) {
9: const [users, setUsers] = useState<any[]>([]);
10: const [loading, setLoading] = useState(true);
11: const { isAdmin } = useAuth();
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/AdminStats.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/AdminStats.tsx</path>
<type>file</type>
<content>
1: import { useState, useEffect } from 'react';
2: import { collection, getDocs } from 'firebase/firestore';
3: import { db, handleFirestoreError, OperationType } from '../firebase';
4: import { useAuth } from '../contexts/AuthContext';
5: import { Icon } from '../components/Icon';
6: import { Navigate } from 'react-router-dom';
7: import { BarChart, Bar, XAxis, YAxis, CartesianGrid, Tooltip, Legend, ResponsiveContainer, PieChart, Pie, Cell } from 'recharts';
8:
9: export default function AdminStats({ isEmbedded = false }: { isEmbedded?: boolean }) {
10: const { isAdmin, loading: authLoadi
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/AdminBroadcast.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/AdminBroadcast.tsx</path>
<type>file</type>
<content>
1: import { useState } from 'react';
2: import { collection, addDoc, serverTimestamp } from 'firebase/firestore';
3: import { db, handleFirestoreError, OperationType } from '../firebase';
4: import { useAuth } from '../contexts/AuthContext';
5: import { Icon } from '../components/Icon';
6: import { useNavigate } from 'react-router-dom';
7: import ReactMarkdown from 'react-markdown';
8: import remarkGfm from 'remark-gfm';
9: import rehypeRaw from 'rehype-raw';
10:
11: export default function AdminBroadcast({ isEmbedded = false }: { isEmbedded?: boolean }) {
12: const { isAdmin } = useAu
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/Author.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/Author.tsx</path>
<type>file</type>
<content>
1: import { useState, useEffect } from 'react';
2: import { useSearchParams, useNavigate } from 'react-router-dom';
3: import { useAuth } from '../contexts/AuthContext';
4: import { Icon } from '../components/Icon';
5: import Editor from './Editor';
6: import ProjectEditor from './ProjectEditor';
7:
8: export default function Author() {
9: const { isAdmin } = useAuth();
10: const navigate = useNavigate();
11: const [searchParams, setSearchParams] = useSearchParams();
12: const tabParam = searchParams.get('tab');
13:
14: const [activeTab, setActiveTab] = useState<'note' | 'project'>(
15: (tabP
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/pages/NotFound.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/pages/NotFound.tsx</path>
<type>file</type>
<content>
1: import { Link } from 'react-router-dom';
2: import { Icon } from '../components/Icon';
3:
4: export default function NotFound() {
5: return (
6: <div className="flex flex-col items-center justify-center min-h-[60vh] text-center px-4">
7: <div className="bg-muted/50 p-6 rounded-full mb-6">
8: <Icon name="error" size={64} className="text-muted-foreground" />
9: </div>
10: <h1 className="text-4xl md:text-6xl font-bold tracking-tight mb-4">404</h1>
11: <h2 className="text-2xl font-semibold mb-4">Page introuvable</h2>
12: <p className="text-muted-foreground max-w-md mb-8">
13: Désolé, la page
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/components/ShareButtons.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/components/ShareButtons.tsx</path>
<type>file</type>
<content>
1: import { useState } from 'react';
2: import { Icon } from './Icon';
3:
4: export function ShareButtons({ title, url }: { title: string, url: string }) {
5: const [copied, setCopied] = useState(false);
6: const encodedUrl = encodeURIComponent(url);
7: const encodedTitle = encodeURIComponent(title);
8:
9: const shareLinks = [
10: {
11: name: 'Twitter (X)',
12: svg: <path d="M18.244 2.25h3.308l-7.227 8.26 8.502 11.24H16.17l-5.214-6.817L4.99 21.75H1.68l7.73-8.835L1.254 2.25H8.08l4.713 6.231zm-1.161 17.52h1.833L7.084 4.126H5.117z" />,
13: url: `https://twitter.com/intent/tweet?url=${
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/components/ContextMenu.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/components/ContextMenu.tsx</path>
<type>file</type>
<content>
1: import { useEffect, useState } from 'react';
2: import { motion, AnimatePresence } from 'motion/react';
3: import { useNavigate } from 'react-router-dom';
4: import { useTheme } from '../contexts/ThemeContext';
5: import { Icon } from './Icon';
6:
7: export default function ContextMenu() {
8: const [position, setPosition] = useState({ x: 0, y: 0 });
9: const [show, setShow] = useState(false);
10: const navigate = useNavigate();
11: const { theme, toggleTheme, authorTheme, toggleAuthorTheme } = useTheme();
12:
13: useEffect(() => {
14: const handleContextMenu = (e: MouseEvent) =>
…[truncated]

Let me grab the last few components and the index.css:

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/components/CodeBlock.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/components/CodeBlock.tsx</path>
<type>file</type>
<content>
1: import { useState } from 'react';
2: import { Prism as SyntaxHighlighter } from 'react-syntax-highlighter';
3: import { vscDarkPlus, vs } from 'react-syntax-highlighter/dist/esm/styles/prism';
4: import { useTheme } from '../contexts/ThemeContext';
5: import { Icon } from './Icon';
6:
7: interface CodeBlockProps {
8: language: string;
9: value: string;
10: }
11:
12: export function CodeBlock({ language, value }: CodeBlockProps) {
13: const [copied, setCopied] = useState(false);
14: const { theme } = useTheme();
15:
16: const handleCopy = () => {
17: navigator.clipboard.writeText(v
…[truncated]

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/components/Icon.tsx"}

<path>/home/sambasene/dev/idle-zelus local/src/components/Icon.tsx</path>
<type>file</type>
<content>
1: import React from 'react';
2:
3: interface IconProps extends React.HTMLAttributes<HTMLSpanElement> {
4: name: string;
5: size?: number;
6: className?: string;
7: }
8:
9: export const Icon: React.FC<IconProps> = ({ name, size = 24, className = '', ...props }) => {
10: return (
11: <span
12: className={`material-symbols-outlined ${className}`}
13: style={{ fontSize: size, ...props.style }}
14: {...props}
15: >
16: {name}
17: </span>
18: );
19: };
(End of file - total 19 lines)
</content>

read — {"filePath": "/home/sambasene/dev/idle-zelus local/src/index.css"}

<path>/home/sambasene/dev/idle-zelus local/src/index.css</path>
<type>file</type>
<content>
1: @import "tailwindcss";
2: @plugin "@tailwindcss/typography";
3:
4: @custom-variant dark (.dark &);
5:
6: @theme {
7: --color-primary: var(--primary);
8: --color-primary-foreground: var(--primary-foreground);
9: --color-background: var(--background);
10: --color-foreground: var(--foreground);
11: --color-card: var(--card);
12: --color-card-foreground: var(--card-foreground);
13: --color-border: var(--border);
14: --color-muted: var(--muted);
15: --color-muted-foreground: var(--muted-foreground);
16: }
17:
18: @layer base {
19: :root {
20: /* Base Colors */
21: --background: #ffffff;
22: --foregro
…[truncated]

glob — {"path": "/home/sambasene/dev/idle-zelus local", "pattern": "package.json"}

/home/sambasene/dev/idle-zelus local/package.json

read — {"filePath": "/home/sambasene/dev/idle-zelus local/package.json"}

<path>/home/sambasene/dev/idle-zelus local/package.json</path>
<type>file</type>
<content>
1: {
2: "name": "react-example",
3: "private": true,
4: "version": "0.0.0",
5: "type": "module",
6: "scripts": {
7: "dev": "vite --port=3000 --host=0.0.0.0",
8: "build": "vite build",
9: "preview": "vite preview",
10: "clean": "rm -rf dist",
11: "lint": "tsc --noEmit"
12: },
13: "dependencies": {
14: "@google/genai": "^1.29.0",
15: "@tailwindcss/typography": "^0.5.19",
16: "@tailwindcss/vite": "^4.1.14",
17: "@types/react-syntax-highlighter": "^15.5.13",
18: "@vitejs/plugin-react": "^5.0.4",
19: "clsx": "^2.1.1",
20: "date-fns": "^4.1.0",
21: "dotenv": "^17.2.3",
22: "express": "^4.21.2",
23: "firebase
…[truncated]

Now I have the complete picture. Here is the exhaustive analysis of the entire application.


1. FIREBASE CORE (/home/sambasene/dev/idle-zelus local/src/firebase.ts)

Section titled “1. FIREBASE CORE (/home/sambasene/dev/idle-zelus local/src/firebase.ts)”

This is the single entry point for all Firebase services. Every other file imports from here.

What it exports:

  • db – Firestore instance, initialized with getFirestore(app, firebaseConfig.firestoreDatabaseId)
  • auth – Firebase Auth instance via getAuth(app)
  • googleProvider – GoogleAuthProvider instance
  • loginWithGoogle() – calls signInWithPopup(auth, googleProvider)
  • logout() – calls signOut(auth)
  • OperationType enum: CREATE, UPDATE, DELETE, LIST, GET, WRITE
  • FirestoreErrorInfo interface – typed error info structure
  • handleFirestoreError(error, operationType, path) – logs structured JSON error with auth context, then throws

Config source: Reads from ../firebase-applet-config.json (project root). Contains apiKey, authDomain, projectId, appId, firestoreDatabaseId.


File What it imports What it does with it
src/contexts/AuthContext.tsx auth, db, handleFirestoreError, OperationType Auth state, user doc read/write
src/contexts/NotificationContext.tsx db, auth, handleFirestoreError, OperationType Listens to notes/projects/notifications/subscriptions collections
src/components/Layout.tsx loginWithGoogle, logout Login/logout buttons
src/pages/Home.tsx db, handleFirestoreError, OperationType Queries notes & projects
src/pages/Editor.tsx db, auth, handleFirestoreError, OperationType CRUD on notes
src/pages/ProjectEditor.tsx db, auth, handleFirestoreError, OperationType CRUD on projects
src/pages/NoteView.tsx db, handleFirestoreError, OperationType Query note by slug
src/pages/ProjectView.tsx db, handleFirestoreError, OperationType Query project by slug
src/pages/AdminContent.tsx db, handleFirestoreError, OperationType List/delete notes and projects
src/pages/Community.tsx db, handleFirestoreError, OperationType Chat messages, typing, likes, users
src/components/Comments.tsx db, handleFirestoreError, OperationType CRUD on comments
src/components/LikeButton.tsx db, handleFirestoreError, OperationType CRUD on likes
src/pages/SearchResults.tsx db, handleFirestoreError, OperationType Full-text search (client-side)
src/pages/Notifications.tsx db, handleFirestoreError, OperationType Read/mark/delete notifications
src/pages/Profile.tsx db, handleFirestoreError, OperationType Read/update user profile
src/pages/Subscriptions.tsx db, handleFirestoreError, OperationType CRUD on user subscriptions
src/pages/AdminUsers.tsx db, handleFirestoreError, OperationType List/update users
src/pages/AdminStats.tsx db, handleFirestoreError, OperationType Count notes/projects/users
src/pages/AdminBroadcast.tsx db, handleFirestoreError, OperationType Create broadcast notifications

3. FIRESTORE DATA MODEL (All Collections & Shapes)

Section titled “3. FIRESTORE DATA MODEL (All Collections & Shapes)”

Each document has an auto-generated ID. Shape:

{
title: string,
slug: string, // URL-safe, unique-ish (not enforced)
content: string, // Markdown body
authorId: string, // Firebase UID
authorName: string, // "Samba Sene" or "Pseudo Man"
authorAvatar: string, // Cloudinary URL
theme: "blue" | "red", // Author theme
year: string, // e.g. "DUT 1"
semester: number | deleteField, // Optional integer 1-6
subject: string, // e.g. "Mathématiques"
metaTitle: string, // SEO
metaDescription: string, // SEO
metaKeywords: string, // SEO
previewImage: string, // URL
published: boolean,
createdAt: serverTimestamp(), // On create only
updatedAt: serverTimestamp(), // On every save
}

**Firestore indexes

…[truncated]

5 internal reasoning block(s) omitted — raw thinking is not exported (see archive index).