Reelmaker Studio
Welcome to your Lovable project Project info URL: https://lovable.dev/projects/a3fca632-da29-496e-82d2-4751b804ee02 How can I edit this code? There are several ways of editing your...
Technical Architecture & Engineering Overview
Detailed system design and core implementation
Core System Architecture
The application is split into three logical layers. The frontend runs in an Electron renderer process, leveraging react-query for data fetching, react-hook-form with Zod/Joi for validation, and Tiptap for rich‑text editing. State synchronization for drag‑and‑drop ordering is handled by dnd-kit, with immediate persistence to the backend via optimistic updates.
Data Ingestion & Persistence User‑generated content—projects, skills, testimonials, and messages—is sent to the Express API where Joi schemas enforce strict payload contracts before Mongoose models persist the data in MongoDB. Rich text fields are sanitized on receipt to prevent XSS, then stored as HTML strings. Backup utilities are included to export collections for disaster recovery.
Security Guardrails Authentication relies on JWT tokens signed with a secret and passwords hashed using bcrypt.js. All admin routes are protected by middleware that validates tokens, applies Helmet headers, and enforces rate limiting to mitigate brute‑force attacks. CORS is tightly scoped to the Electron origin.
Build & Deployment Topology
The development workflow uses Vite for fast HMR, while Electron Builder creates installers for Windows and Linux. Linting and formatting are enforced with ESLint and Prettier, and nodemon watches backend changes during development. The final product is a single executable delivering both UI and API without external server dependencies.
System Diagrams & Flow Visualizations
Interactive Mermaid architecture & execution flows
Core System Features
Key capabilities & architectural features
Dark‑mode‑only UI built with Tailwind CSS and Shadcn UI components.
Dark‑mode‑only UI built with Tailwind CSS and Shadcn UI components.
Rich‑text content creation via Tiptap with server‑side sanitization.
Rich‑text content creation via Tiptap with server‑side sanitization.
Drag‑and‑drop reordering of projects, skills, and testimonials using dnd‑kit.
Drag‑and‑drop reordering of projects, skills, and testimonials using dnd‑kit.
Secure JWT‑based authentication with bcrypt password hashing.
Secure JWT‑based authentication with bcrypt password hashing.
Rate limiting and Helmet security headers for all admin routes.
Rate limiting and Helmet security headers for all admin routes.
Real‑time form validation using React Hook Form and Zod.
Real‑time form validation using React Hook Form and Zod.
Cross‑platform desktop deployment via Electron and Electron Builder.
Cross‑platform desktop deployment via Electron and Electron Builder.
RESTful API built with Express, validated by Joi, and persisted with Mongoose.
RESTful API built with Express, validated by Joi, and persisted with Mongoose.
Message inbox for handling inquiries from the public portfolio contact form.
Message inbox for handling inquiries from the public portfolio contact form.
GitHub integration for caching repository statistics and contribution graphs.
GitHub integration for caching repository statistics and contribution graphs.
Pinterest board management module for curated design references.
Pinterest board management module for curated design references.
Automated MongoDB backup scripts accessible from the admin panel.
Automated MongoDB backup scripts accessible from the admin panel.
Engineering Challenges & Solutions
Problem statements & resolution strategies
Balancing immediate UI responsiveness with reliable database sequence updates during rapid drag‑and‑drop actions.
Balancing immediate UI responsiveness with reliable database sequence updates during rapid drag‑and‑drop actions.
Ensuring rich‑text HTML from Tiptap is sanitized without stripping legitimate formatting.
Ensuring rich‑text HTML from Tiptap is sanitized without stripping legitimate formatting.
Managing state synchronization between Electron's main and renderer processes while keeping the API stateless.
Managing state synchronization between Electron's main and renderer processes while keeping the API stateless.
Configuring CORS and security headers to work seamlessly inside the Electron environment.
Configuring CORS and security headers to work seamlessly inside the Electron environment.
Optimizing bundle size for the Electron app to keep install footprints low on Windows and Linux.
Optimizing bundle size for the Electron app to keep install footprints low on Windows and Linux.
Key Code Modules & Architecture
Core file entrypoints and service responsibilities
srcModule component managing src source logic
src/componentsModule component managing components source logic
src/components/uiModule component managing ui source logic
src/hooksModule component managing hooks source logic
src/libModule component managing lib source logic
src/pagesModule component managing pages source logic
User Journey Pipeline
- 1User Access & Preset Selection: User opens client interface and configures request parameters or task workflow presets.
- 2Client Payload Dispatch: Front-end components (React, TailwindCSS) serialize input objects and send HTTP/WebSocket requests to `/api/analyze`.
- 3Middleware & Validation Check: API Gateway evaluates CORS headers, authorization tokens, and input validation schemas.
- 4Service & Inference Execution: Service controllers dispatch request frames to model inference engine (Local Engine) or storage layer.
- 5Response Delivery & State Synchronization: Serialized output payload is returned to the client and rendered in the visual workspace.
Execution Code Flow
- 1Entrypoint Invocation: Request enters network interface layer via `POST /api/analyze`.
- 2Schema & Guardrail Verification: Middleware sanitizes payload parameters and checks rate-limiting limits.
- 3Controller Dispatch: Router delegates validated object to `Src` service controller.
- 4Engine Execution & Storage Operations: Controller executes business logic, queries database models (Persistence), and invokes ML workers.
- 5Response Serialization: Result model is formatted into standard JSON response frame and delivered with HTTP 200 OK.
System FAQ & Technical Specifications
Frequently asked questions and core architecture details
Q: What technologies are used in Reelmaker Studio?
Reelmaker Studio is engineered using modern full-stack frameworks.
Q: What core engineering problem does Reelmaker Studio solve?
Welcome to your Lovable project Project info URL: https://lovable.dev/projects/a3fca632-da29-496e-82d2-4751b804ee02 How can I edit this code? There are several ways of editing your...
Q: How is 'Balancing immediate UI responsiveness with reliable database sequence updates during rapid drag‑and‑drop actions.' resolved in Reelmaker Studio?
Resolved through specialized system architecture and resilient state handling.
Related Systems & Case Studies
Explore similar technical architectures and projects