Backend API powering Cintegrate — an AI-assisted video creation platform that transforms ideas into structured video projects through stories, scenes, narration, media assets, and rendering workflows.
Cintegrate Backend provides the core infrastructure for the Cintegrate platform.
It manages authentication, projects, stories, scenes, narration, media assets, user accounts, credits, and video configuration while exposing a REST API consumed by the frontend application.
The backend is designed around a modular architecture so new AI providers, rendering pipelines, storage services, and media generation workflows can be integrated without major changes.
- Frontend: React application for creators
- Backend: REST API (this repository)
- Database: MongoDB
- Storage: AWS S3 compatible storage
- Media Processing: FFmpeg + Sharp
Frontend Repository
https://github.com/benazeem/Cintegrate-frontend
- Secure authentication
- JWT access & refresh tokens
- Cookie-based sessions
- Account verification
- Password reset
- Session management
- Create projects
- Update project metadata
- Organize creative workspaces
- Bookmark projects
Create structured video scripts.
Each project can contain:
- Stories
- Context Profiles
- Scenes
- Narrations
- Audio Assets
- Scene Assets
- Video Configuration
Manage video scenes independently.
Supports:
- Scene ordering
- Scene updates
- Ownership validation
- Asset linking
Manage narration data for generated videos.
Supports:
- Narration profiles
- Voice configuration
- Timing metadata
Supports media asset management including:
- Uploads
- Storage
- Image processing
- Audio assets
- Scene assets
Store rendering preferences such as:
- Resolution
- Aspect Ratio
- Output configuration
Infrastructure for:
- Credits
- Plans
- Capability overrides
- Pricing configuration
The backend includes multiple security layers.
- JWT Authentication
- HTTP-only Cookies
- CSRF Protection
- Helmet
- CORS Configuration
- Password Hashing (bcrypt)
- Input Validation (Zod)
- Ownership Validation Middleware
- Node.js
- Express
- MongoDB
- Mongoose
- Zod
- JWT
- bcrypt
- Cookie Parser
- FFmpeg
- Sharp
- AWS S3 SDK
- Pino
- Nodemailer
src/
├── config/
├── constants/
├── db/
├── middleware/
├── models/
├── modules/
├── routes/
├── shared/
├── types/
├── utils/
├── validation/
├── validators/
└── server.ts
The application follows a modular architecture where every feature owns its routes, controllers, services, validation, and business logic.
- Node.js
- MongoDB
- npm
- Docker (optional)
Install dependencies
npm installCopy environment variables
cp example.env .envRun development server
npm run devDevelopment
docker compose -f docker-compose.dev.yml upProduction
docker compose -f docker-compose.prod.yml up- Authentication
- User
- Projects
- Stories
- Context Profiles
- Scenes
- Narration
- Audio
- Scene Assets
- Video Configuration
- Credits
- Plans
- Sessions
- AI provider integrations
- Automated story generation
- Scene generation pipelines
- AI narration providers
- Image generation providers
- Video rendering pipeline
- Background job processing
- Webhooks
- Plugin architecture
- Public API
- SDK
🚧 Active Development
Cintegrate is currently under active development and the architecture continues to evolve as new AI workflows and media generation capabilities are added.
Contributions, discussions, bug reports, and feature requests are welcome.
If you'd like to contribute, please open an issue before submitting major changes.
MIT License