Postiz is a full-stack, open-source social media scheduling and publishing platform that supports 30+ platforms (Instagram, TikTok, LinkedIn, YouTube, X, Facebook, etc.). The system is built as a pnpm monorepo with four main applications: a Next.js frontend (App Router), a NestJS backend REST API, a Temporal-based workflow orchestrator for reliable post publishing and token refresh, and a Chrome extension for cookie-based authentication. It also includes a CLI app, a public SDK (@postiz/node), and a shared libraries layer for business logic, database access (Prisma + PostgreSQL), and integrations. Key architectural patterns include an abstract social provider base class (SocialAbstract) that all platform integrations extend, a Temporal v1.8+ workflow engine with versioned posting workflows (v1.0.1 through v1.0.8), an upload factory abstracting local and Cloudflare storage, an MCP server for AI agent tools (scheduling, content generation via LangGraph), a plug/auto-reply system, and a short-link abstraction with multiple providers. The frontend uses Zustand for state management, SWR for data fetching, CopilotKit for AI textarea integration, and Mantine/Tailwind for UI. The system handles OAuth flows, subscription billing via Stripe, team collaboration, webhooks, and admin monitoring. The codebase demonstrates strong engineering with reusable abstractions for social integrations, storage, email, and short-linking, though it carries some technical debt from organic growth (multiple workflow versions, hardcoded strings, and suppressed TypeScript strictness).
This repository is a full-stack video course management system (CVM) designed for creating, editing, and publishing technical video lessons. It consists of a web application (React Router v7 with SSR), a CLI tool (`cvm`), a remote RPC API (Hono, deployed on Vercel), and several internal packages including a core domain library with Drizzle ORM schema, a standalone Remotion overlay renderer, and a vendored Lucide icon set. The system orchestrates complex workflows such as video capture (OBS integration), timeline editing with clip trimming and overlay compositing, AI-assisted content generation (chapter autofill, SEO descriptions, newsletters using Anthropic Claude), and publishing to YouTube, Dropbox, and Buffer. A teleprompter popup syncs via BroadcastChannel, and a diagram editor built on tldraw supports snapshot-based revision history. The architecture is heavily driven by Effect-ts for backend services, with a clear separation between read-only CLI operations (via HTTP RPC) and write operations (via web app routes). The frontend uses optimistic updates for a fluid user experience, while the backend enforces draft-gate policies to prevent writes to published course versions. The codebase is thoroughly tested with Vitest and PGlite in-memory PostgreSQL, using fake service layers for external dependencies (Dropbox, AI generation, video processing). Despite its healthy test coverage and well-structured service pattern, the repository shows signs of organic growth: multiple modals with duplicated state logic, large reducer files, and some drift between duplicated prompt definitions. The dependency on the Effect-ts ecosystem and a large number of third-party APIs (Dropbox, YouTube, Buffer, OBS, Cloudinary) creates a maintenance surface that requires careful version alignment. The overlay renderer is isolated as a separate package with its own build process, reducing coupling but adding deployment complexity.
This repository implements a fully autonomous pipeline that generates, produces, and uploads educational YouTube videos daily. It uses the Gemini 2.5 Flash API to create lesson scripts and curricula, gTTS for narration, Pexels for background imagery, and MoviePy/Pillow for video rendering. The pipeline runs on a GitHub Actions cron schedule, requiring no manual intervention. It produces both a long-form lesson video and a YouTube Short, uploads them with custom thumbnails, and updates the content plan repository. The code is well-structured for its purpose, with proper error handling, retry logic for TTS rate limits, and credential management for YouTube OAuth. While not a reusable library, it demonstrates good software engineering practices for a CI/CD-based content generation system.
Yoast SEO is a comprehensive WordPress SEO plugin providing on-page content analysis, XML sitemaps, schema markup generation, social media previews, and AI-assisted content optimization. The codebase is a monorepo containing PHP backend logic under a domain-driven architecture (Application, Domain, Infrastructure, User_Interface layers) and a modern JavaScript frontend using React, Redux, and Tailwind CSS. It integrates deeply with the WordPress ecosystem through hooks, REST API endpoints, and a robust conditional-based feature toggling system. Core capabilities include real-time readability and SEO assessments via a web worker-based analysis engine (packages/yoastseo), bulk editing of SEO metadata, AI content generation (titles, descriptions, outlines), schema aggregation for structured data, a dashboard with Google Site Kit integration, and extensive support for third-party plugins (WooCommerce, Elementor, WPML). The plugin employs a well-defined integration pattern (Integration_Interface with get_conditionals) for modular feature management. The repository exhibits professional engineering practices including comprehensive automated testing (PHPUnit, Jest, Mockery, Brain Monkey), dependency injection, and continuous integration. However, it shows signs of architectural drift with deprecated classes and legacy WPSEO_* namespaces coexisting with newer code, and a high open issue count reflecting its large user base. The AI features (consent management, content planner) are relatively recent additions with evolving requirements.
This repository implements a full-stack content operations platform exclusively for Xiaohongshu (XHS), the Chinese social media platform. It provides a complete lifecycle for managing XHS notes: discovering content via search or URL crawling, saving to a local library, AI-assisted rewriting and title/tag generation, scheduling and publishing through XHS's Creator API, and monitoring engagement metrics. The system is built as a modern web application with a FastAPI backend (Python) and a React frontend (TypeScript, Ant Design), using SQLAlchemy for persistence and APScheduler for background job execution. The architecture is a monolith with clear separation of concerns: backend API routers for accounts, notes, drafts, AI, tasks, publishing, monitoring, and analytics; a service layer for business logic; and a set of adapters that encapsulate the reverse-engineered XHS API clients. The frontend provides a dashboard, discovery page, content library, draft editor, publish center, auto-ops scheduler, and analytics views. Authentication uses JWT tokens with refresh logic, and the system supports multiple XHS account types (PC web and Creator) via QR code or phone login. A notable aspect is the extensive reverse-engineering of XHS's anti-bot mechanisms. The codebase includes custom JavaScript modules for generating signatures (b1, MNS, X-S, X-T, websectiga, profileData) and browser fingerprint emulation, all executed locally via Node.js subprocesses. This allows the platform to interact with XHS APIs without a real browser, enabling automated content operations at scale. While the primary focus is on XHS, the platform abstraction layer (PlatformId enum, adapter interfaces) suggests an intention to support other social media platforms, though only XHS is currently implemented. The repository is a hybrid of application and data engineering: it is primarily a production-grade web application with scheduled tasks, user management, and a rich UI, but it also contains data pipeline elements such as crawling, normalization, and storage of XHS content for later analysis. The data models and analytics endpoints provide research-like capabilities (keyword tracking, engagement trends, benchmarks), but these are embedded within the application rather than forming a standalone data research project.