YouTube Studio Flow — Documentation

Multi-tenant YouTube channel management tool. Teams connect channels, manage video metadata via a description block and template system, and push changes back to YouTube.

For Claude — Start Here

Read 00 - Claude Guide before starting any task. It contains a task routing table (which docs to read for which task type) and a list of common mistakes to avoid in this codebase.

Architecture

01 - System Overview — Tech stack, process architecture, key decisions
02 - Backend — NestJS modules, patterns, shared services
03 - Frontend — Next.js routing, state management, API layer
04 - Database Schema — Prisma models and relationships
05 - Queue System — BullMQ processors and queue constants
06 - Authentication — Google OAuth, JWT, role-based access
07 - Render Engine — Description rendering pipeline, token resolution

Features

01 - Video Management — Video list, editor, sync
02 - Description Engine — Blocks, templates, tokens, rendering
03 - Metadata Linting — Rules, execution, disabling rules
04 - Bulk Operations — Preview/confirm pattern, rollback
05 - Playlists — YouTube playlist sync
06 - Collaborators — Platform fields, token mapping
07 - Saved Views — Filter presets, pinned tabs
08 - Campaigns — Date-window promotional blocks
09 - Calendar — Scheduled video visualization
10 - Import Export — CSV and JSON workspace transfer
11 - Quota Management — YouTube API quota tracking
12 - Audit Log — Change history
13 - Team Settings — Render settings, lint rule disabling

API Reference

01 - Auth API
02 - Videos API
03 - Blocks API
04 - Templates API
05 - Collaborators API
06 - Linting API
07 - Playlists API
08 - Saved Views API
09 - Teams API
10 - Quota API
11 - Bulk Jobs API
12 - Calendar API
13 - Import Export API
14 - Team Variables API
15 - Campaigns API
16 - YouTube Sync API
17 - Video Configs API

Design Guidelines

01 - Visual Design — Colors, typography, spacing, shadows
02 - CSS Conventions — CSS Modules, variables, min-width rule
03 - Component Patterns — React patterns, TanStack Query, modals
04 - Backend Architecture Patterns — Module structure, scoping, audit
05 - Code Conventions — TypeScript, naming, comments

Development

01 - Local Setup — Prerequisites and step-by-step setup
02 - Environment Variables — All env vars with descriptions
03 - Recipes — How to add modules, rules, endpoints, nav items
04 - Gotchas — Non-obvious behaviors and known traps
05 - Deployment and Operations — Production stack, secrets, job failures, backups, key rotation
06 - Verifying Changes — Build, type-check, and lint commands

Backlog

01 - Technical Debt and Future Work — Dead code, missing features, deferred improvements

Daily Notes

Chronological log of shipped work. Filename format: YYYY-MM-DD NN Short title (NN counts major tasks that day, ascending).

3.2 KiB Raw Blame History