How ok2codei/jotdown works
JotDown is a full-stack notes application. Users authenticate, enter protected note and archive views, and create, search, edit, delete, archive, or restore notes; the frontend separates pages, hooks, and API services from the Express routes, middleware, controllers, and PostgreSQL access. Authentication, tags, folders, and theme support are also represented. The README documents product capabilities, while several frontend components and backend modules were not sampled; uncertain links are omitted rather than inferred.
Main entry points: app.js Express server · db.js PostgreSQL · router.tsx App router · authMiddleware.js Token verification
Components 27
Frontend
- App router
frontend/src/routes/router.tsx - Home page
frontend/src/pages/app/Home.tsx - Theme controls
frontend/src/hooks/useDarkMode.ts
Authentication
- Login and register
frontend/src/pages/auth - Auth hook
frontend/src/hooks/useAuth.ts - Auth context
frontend/src/context/AuthContext.tsx - Auth service
frontend/src/services/authService.ts - Route guard
frontend/src/routes/ProtectedRoute.tsx
Notes and organization
- Notes page
frontend/src/pages/app/Notes.tsx - Archive page
frontend/src/pages/app/Archive.tsx - Note state
frontend/src/hooks/useNote.ts - Note views
frontend/src/components/notes - Note service
frontend/src/services/noteService.ts - Tag endpoints
backend/src/routes/tags.routes.js - Tag operations
backend/src/controllers/tags.controllers.js - Folder endpoints
backend/src/routes/folders.routes.js - Folder operations
backend/src/controllers/folders.controllers.js
Backend API
- Note endpoints
backend/src/routes/notes.routes.js - Note operations
backend/src/controllers/notes.controllers.js - Auth endpoints
backend/src/routes/auth.routes.js - Auth controllers
backend/src/controllers - User endpoints
backend/src/routes/users.routes.js - User operations
backend/src/controllers/users.controllers.js - Express server
backend/src/app.js - Token verification
backend/src/middleware/authMiddleware.js
Persistence
- PostgreSQL
backend/src/config/db.js
Other components
- User
Connections 35
- User → App router: uses
- App router → Home page: routes to
frontend/src/routes/router.tsx - App router → Notes page: routes to
frontend/src/routes/router.tsx - App router → Archive page: routes to
frontend/src/routes/router.tsx - App router → Route guard: guards app
frontend/src/routes/router.tsx - Notes page → Note state: uses
frontend/src/pages/app/Notes.tsx - Notes page → Note views: renders
frontend/src/pages/app/Notes.tsx - Note state → Note service: calls
frontend/src/hooks/useNote.ts - Note service → Note endpoints: requests
- Express server → Auth endpoints: mounts
backend/src/app.js - Express server → User endpoints: mounts
backend/src/app.js - Express server → Note endpoints: mounts
backend/src/app.js - Express server → Folder endpoints: mounts
backend/src/app.js - Express server → Tag endpoints: mounts
backend/src/app.js - Note endpoints → Token verification: verifies
backend/src/routes/notes.routes.js - Note endpoints → Note operations: dispatches
backend/src/routes/notes.routes.js - Tag endpoints → Token verification: verifies
backend/src/routes/tags.routes.js - Tag endpoints → Tag operations: dispatches
backend/src/routes/tags.routes.js - Folder endpoints → Token verification: verifies
backend/src/routes/folders.routes.js - Folder endpoints → Folder operations: dispatches
backend/src/routes/folders.routes.js - Auth endpoints → Auth controllers: dispatches
backend/src/routes/auth.routes.js - User endpoints → User operations: dispatches
backend/src/routes/users.routes.js - User endpoints → Token verification: verifies
backend/src/routes/users.routes.js - Token verification → PostgreSQL: checks users
backend/src/middleware/authMiddleware.js - Note operations → PostgreSQL: reads and writes
backend/src/controllers/notes.controllers.js - Tag operations → PostgreSQL: reads and writes
backend/src/controllers/tags.controllers.js - Folder operations → PostgreSQL: accesses
backend/src/controllers/folders.controllers.js - Auth controllers → PostgreSQL: accesses
backend/src/controllers/auth.login.controllers.js - User operations → PostgreSQL: accesses
backend/src/controllers/users.controllers.js - User → Login and register: authenticates
- Login and register → Auth hook: uses
frontend/src/pages/auth/Login.tsx - Login and register → Auth service: calls
frontend/src/pages/auth/Login.tsx - Auth hook → Auth context: reads
frontend/src/hooks/useAuth.ts - Auth context → Auth service: uses
- Route guard → Auth hook: checks session
frontend/src/routes/ProtectedRoute.tsx