How kannan637/moodbaord works
Moodboard captures inspiration into user-owned boards: users authenticate, create/select a board, then import images from the Chrome extension or drop files onto the web canvas; images are processed and stored, while canvas elements and image placement remain editable. The backend separates API routing, domain services, MongoDB documents, and local image files. The README documents the Next.js app and extension flows, but no frontend source files appear in the supplied tree, so frontend internals and its API wiring are not verified.
Main entry points: main.py FastAPI application · images.py Image routes · image_service.py Image ingestion and editing · database.py MongoDB documents
Components 24
Capture clients
- Extension onboarding
extension/onboarding/onboarding.js - Page image capture
extension/content.js - Extension background
extension/background.js - Web canvas app
frontend
Backend API
- FastAPI application
backend/app/main.py - Auth routes
backend/app/api/auth.py - Board routes
backend/app/api/boards.py - Image routes
backend/app/api/images.py - Canvas element routes
backend/app/api/canvas_elements.py - User authentication dependency
backend/app/api/deps.py
Domain services
- Clerk token service
backend/app/services/auth_service.py - Board management
backend/app/services/board_service.py - Image ingestion and editing
backend/app/services/image_service.py - Canvas element management
backend/app/services/canvas_element_service.py - URL safety checks
backend/app/utils/url_safety.py
Persistence and files
- MongoDB documents
backend/app/database.py - User records
backend/app/models/user.py - Board records
backend/app/models/board.py - Image records
backend/app/models/image.py - Canvas element records
backend/app/models/canvas_element.py - Local image files
backend/app/config.py
Other components
- Designer
- Clerk identity
- Image source sites
Connections 37
- Designer → Extension onboarding: signs in
README.md - Designer → Page image capture: selects images
README.md - Image source sites → Page image capture: provides images
README.md - Page image capture → Extension background: sends capture
- Extension background → Image routes: imports images
README.md - Designer → Web canvas app: drops image
README.md - Web canvas app → Image routes: submits upload
- FastAPI application → Auth routes: registers router
backend/app/main.py - FastAPI application → Board routes: registers router
backend/app/main.py - FastAPI application → Image routes: registers router
backend/app/main.py - FastAPI application → Canvas element routes: registers router
backend/app/main.py - FastAPI application → MongoDB documents: initializes database
backend/app/main.py - Auth routes → User authentication dependency: uses dependency
backend/app/api/auth.py - Board routes → User authentication dependency: uses dependency
backend/app/api/boards.py - Image routes → User authentication dependency: uses dependency
backend/app/api/images.py - Canvas element routes → User authentication dependency: uses dependency
backend/app/api/canvas_elements.py - User authentication dependency → Clerk token service: validates token
backend/app/api/deps.py - Clerk token service → Clerk identity: fetches signing keys
backend/app/services/auth_service.py - Clerk token service → User records: looks up or creates
backend/app/services/auth_service.py - Board routes → Board management: delegates board work
backend/app/api/boards.py - Image routes → Image ingestion and editing: delegates image work
backend/app/api/images.py - Image routes → Board management: checks board access
backend/app/api/images.py - Canvas element routes → Canvas element management: delegates element work
backend/app/api/canvas_elements.py - Board management → Board records: reads and writes
backend/app/services/board_service.py - Board management → Image records: queries images
backend/app/services/board_service.py - Board management → Canvas element records: deletes elements
backend/app/services/board_service.py - Image ingestion and editing → Image records: stores image state
backend/app/services/image_service.py - Image ingestion and editing → Board records: checks ownership
backend/app/services/image_service.py - Image ingestion and editing → URL safety checks: validates source URL
backend/app/services/image_service.py - Image ingestion and editing → Local image files: writes processed files
backend/app/services/image_service.py - Canvas element management → Canvas element records: reads and writes
backend/app/services/canvas_element_service.py - Canvas element management → Board records: checks board ownership
backend/app/services/canvas_element_service.py - FastAPI application → Local image files: serves static images
backend/app/main.py - MongoDB documents → User records: registers model
backend/app/database.py - MongoDB documents → Board records: registers model
backend/app/database.py - MongoDB documents → Image records: registers model
backend/app/database.py - MongoDB documents → Canvas element records: registers model
backend/app/database.py